4-4. [실습] "워크플로우 전부 우리 컨벤션에 맞게 정리해줘"
이번 섹션에서 배운 세 가지(네이밍 컨벤션, 에러 트리거 등록, 비활성 워크플로우 감지)를 한 번에 실행해 봅니다. 실무에서는 이 셋을 묶어 한 번에 처리하는 것이 훨씬 효율적입니다.
1. 종합 정리 프롬프트
Claude Code를 띄우고, 이번에는 좀 더 구체적인 종합 프롬프트를 입력합니다.
워크플로우 전부 우리 컨벤션에 맞게 정리해줘.
1. 이름 규칙 적용: 컨벤션에 안 맞는 이름이 있으면 변경 목록 만들어줘
2. 에러 트리거 없는 워크플로우는 마스터 에러 워크플로우(ID: abc123)에 등록해줘
3. 비활성 워크플로우는 따로 리포트해줘
먼저 전체 현황 리포트를 보여주고, 내가 확인하면 실행해.★ 핵심. 마지막 줄 "먼저 리포트를 보여주고, 확인하면 실행해"가 안전장치 역할을 합니다.
2. Claude가 수행하는 작업 관찰하기
Claude는 프롬프트를 받으면 먼저 전체 현황을 파악하기 위해 데이터를 수집합니다.
1단계 — 전체 조회
n8n_list_workflows 를 호출해 모든 워크플로우의 기본 정보(이름, ID, active 상태)를 가져옵니다.
2단계 — 상세 정보 수집
각 워크플로우에 대해 n8n_get_workflow 를 호출해 settings를 확인합니다. 이 과정에서 다음 세 가지를 동시에 체크합니다.
- 이름이 컨벤션 형식(
[팀명] 기능설명 (트리거타입))에 맞는지 settings.errorWorkflow가 설정되어 있는지- active 상태가 true인지 false인지
3. 종합 리포트 확인
데이터 수집이 끝나면 Claude가 종합 리포트를 출력합니다.
============================================
워크플로우 종합 정리 리포트
============================================
전체 워크플로우: 15개
--- 1. 이름 컨벤션 점검 ---
컨벤션에 맞는 이름: 7개
변경 필요: 8개
| # | 현재 이름 | 제안 이름 |
|---|----------------------|----------------------------------------------|
| 1 | New Workflow | [공통] 구글시트 데이터 동기화 (Schedule) |
| 2 | 테스트 | [개발] GitHub PR 알림 (Webhook) |
| 3 | 슬랙 알림 최종2 | [마케팅] 리드 유입 슬랙 알림 (Webhook) |
| 4 | Untitled | [인사] 출근 체크 자동화 (Schedule) |
| 5 | test_api | [개발] API 연동 테스트 (Manual) |
| 6 | 매출리포트 | [영업] 일일 매출 리포트 (Schedule) |
| 7 | webhook_receiver | [공통] 외부 데이터 수신 (Webhook) |
| 8 | backup | [공통] 일일 백업 (Schedule) |
--- 2. 에러 트리거 점검 ---
에러 워크플로우 등록 완료: 4개
미등록 (등록 대상): 11개
미등록 목록:
- [마케팅] 리드 수집 알림 (Webhook)
- [개발] GitHub PR 알림 (Webhook)
- New Workflow
- 테스트
... (외 7개)
--- 3. 비활성 워크플로우 점검 ---
활성: 9개 (60%)
비활성: 6개 (40%)
비활성 목록:
| # | 이름 | 마지막 수정일 |
|---|-------------------------------------------|---------------|
| 1 | [개발] Slack 테스트 (Manual) | 2025-11-03 |
| 2 | [공통] 데이터 마이그레이션 임시 (Manual) | 2025-09-15 |
| 3 | New Workflow 2 | 2025-08-22 |
| 4 | [마케팅] 이벤트 알림 (Webhook) | 2026-01-10 |
| 5 | test_api_connection | 2025-07-01 |
| 6 | [영업] 분기 리포트 (Schedule) | 2026-02-28 |
============================================
요약: 이름 변경 8건, 에러 트리거 등록 11건, 비활성 6건 감지
이름 변경과 에러 트리거 등록을 진행할까요?
(비활성 워크플로우는 별도 판단이 필요합니다)
============================================4. 확인 후 일괄 실행
리포트를 확인하고 "진행해"라고 답하면, Claude가 두 작업을 순차 실행합니다.
이름 변경 실행
n8n_update_partial_workflow 로 8개 워크플로우의 이름을 변경합니다.
[이름 변경 진행 중]
[1/8] "New Workflow" -> "[공통] 구글시트 데이터 동기화 (Schedule)" 완료
[2/8] "테스트" -> "[개발] GitHub PR 알림 (Webhook)" 완료
...
[8/8] 이름 변경 완료. 8개 모두 성공.에러 트리거 등록 실행
이어서 같은 도구로 11개 워크플로우의 settings.errorWorkflow를 등록합니다.
[에러 트리거 등록 진행 중]
[1/11] [마케팅] 리드 수집 알림 - errorWorkflow 등록 완료
[2/11] [개발] GitHub PR 알림 - errorWorkflow 등록 완료
...
[11/11] 에러 트리거 등록 완료. 11개 모두 성공.5. 정리 전 vs 정리 후 비교
n8n 웹 UI에서 워크플로우 목록을 새로고침하면 변화를 확인할 수 있습니다.
표준 없음
- 이름이 "New Workflow", "테스트", "Untitled"로 제각각
- 에러 트리거가 대부분 미등록
- 운영/테스트 구분 불가
컨벤션 적용
- 모든 이름이 `[팀명] 기능설명 (트리거타입)` 형식
- 전체 워크플로우에 에러 안전망 등록 완료
- 비활성 목록 별도 리포트로 후속 조치 가능
프롬프트 한 줄과 "진행해" 확인만으로, 워크플로우 전체가 컨벤션에 맞게 표준화되었습니다.
6. 섹션 4 마무리
이번 섹션에서 배운 것을 정리합니다.
네이밍 컨벤션
이름 규칙을 스킬에 정의하고, n8n_list_workflows와 n8n_update_partial_workflow로 일괄 변경
에러 트리거 등록
마스터 에러 워크플로우를 만들고, n8n_get_workflow로 미등록 항목을 찾아 n8n_update_partial_workflow로 일괄 등록
분류와 정리
n8n_list_workflows로 비활성 워크플로우를 감지하고 정리 리포트 생성
이 세 가지가 ops-manager 모듈에 규칙으로 들어가 있기 때문에, 앞으로는 "정리해줘" 한 마디면 Claude가 동일한 기준으로 반복 수행합니다.
★ 핵심. 표준화란 한 번 규칙을 정하면 사람이 바뀌어도, 시간이 지나도 같은 기준이 적용되는 것입니다.
다음 섹션 5에서는 운영 모니터링과 사용자 관리를 다룹니다. 신규 워크플로우 알림, AI 에러 분석, 퇴사자 워크플로우 인계 같은 실전 운영 과제를 진행합니다.