4-1. 컨벤션 네이밍 — 워크플로우 이름 규칙 정하고 일괄 변경

파트 2에 오신 것을 환영합니다. 이제부터는 이미 만들어진 워크플로우들을 대규모로 관리하는 방법을 다룹니다. 첫 주제는 네이밍 컨벤션입니다.

1. 이름이 뒤죽박죽인 워크플로우의 현실

n8n을 한동안 사용하다 보면 워크플로우 목록은 이런 모습이 됩니다. "New Workflow", "테스트", "Untitled", "슬랙 알림 최종 최종2".

처음 만들 때는 대충 이름을 붙이고 나중에 정리하려 했지만, 그 '나중'은 오지 않습니다.

워크플로우가 10개일 때는 머릿속에 다 들어옵니다. 하지만 30개, 50개, 100개로 늘어나면 이름만 보고는 무엇을 하는 워크플로우인지 파악할 수 없습니다.

팀으로 운영하면 더 심각해집니다. 동료가 만든 test_v3_final이 실제 운영 중인 워크플로우인지, 진짜 테스트인지 알 방법이 없습니다.

2. 네이밍 컨벤션 설계하기

네이밍 컨벤션은 이름을 붙이는 규칙입니다. 프로그래밍에서 변수 이름을 규칙대로 짓듯이, 워크플로우 이름도 일관된 규칙으로 정해야 합니다.

추천하는 형식은 다음과 같습니다.

[팀명] 기능설명 (트리거타입)

이름만 보고도 누가 쓰는지(팀명), 무엇을 하는지(기능설명), 어떻게 실행되는지(트리거타입)를 즉시 파악할 수 있습니다.

팀 상황에 따라 규칙은 다르게 정해도 됩니다. 중요한 것은 모든 워크플로우에 동일한 규칙이 적용되는 것입니다.

3. ops-manager 모듈에 네이밍 규칙 추가하기

이 규칙을 매번 Claude에게 설명하는 것은 비효율적입니다. 클로드 스킬의 ops-manager 모듈에 네이밍 규칙 섹션을 추가해, Claude가 항상 이 규칙을 참조하도록 만듭니다.

스킬 파일에 다음과 같이 추가합니다.

## 네이밍 컨벤션

워크플로우 이름은 다음 형식을 따른다:
- 형식: `[팀명] 기능설명 (트리거타입)`
- 팀명: 마케팅, 개발, 인사, 영업, CS, 공통
- 트리거타입: Webhook, Schedule, Manual, Error
- 예시: `[마케팅] 리드 수집 알림 (Webhook)`

한 번 적어두면 이후로는 "이름 정리해줘" 한 마디로 Claude가 이 규칙을 자동으로 적용합니다.

4. 실습 — "내 워크플로우 이름을 전부 컨벤션에 맞게 바꿔줘"

터미널에서 Claude Code를 띄우고 다음 프롬프트를 입력합니다.

내 워크플로우 이름을 전부 컨벤션에 맞게 바꿔줘.

Claude는 다음 순서로 작업을 수행합니다.

터미널에 다음과 같은 제안 목록이 표시됩니다.

변경 대상: 8개 워크플로우

1. "New Workflow"        -> "[공통] 구글시트 데이터 동기화 (Schedule)"
2. "테스트"              -> "[개발] GitHub PR 알림 (Webhook)"
3. "슬랙 알림 최종2"     -> "[마케팅] 리드 유입 슬랙 알림 (Webhook)"
4. "Untitled"            -> "[인사] 출근 체크 자동화 (Schedule)"
...

이대로 변경할까요?

5. 안전장치 — 변경 전 확인받기

★ 핵심. Claude는 바로 변경하지 않고 먼저 목록을 보여준 뒤 확인을 요청합니다. ops-manager 스킬에 안전장치 규칙을 적어두었기 때문입니다.

사용자가 "진행해"라고 답하면, Claude가 n8n_update_partial_workflow 도구로 각 워크플로우의 이름을 하나씩 변경합니다.

이 도구의 핵심은 부분 업데이트(Partial Update) 입니다. 워크플로우 전체를 덮어쓰지 않고 이름 필드만 정확하게 바꿉니다. 노드 구성이나 연결선 같은 나머지 설정은 그대로 유지됩니다.

[1/8] "New Workflow" -> "[공통] 구글시트 데이터 동기화 (Schedule)" 변경 완료
[2/8] "테스트" -> "[개발] GitHub PR 알림 (Webhook)" 변경 완료
...
[8/8] 변경 완료. 총 8개 워크플로우의 이름이 컨벤션에 맞게 정리되었습니다.

6. 마무리

n8n 웹 UI에서 워크플로우 목록을 새로고침하면, 뒤죽박죽이던 이름들이 깔끔하게 정리된 것을 확인할 수 있습니다.

사용자가 직접 한 것은 프롬프트 한 줄과 "진행해"라는 확인뿐입니다. 나머지는 Claude가 MCP 도구로 n8n 서버와 통신하며 처리했습니다.

다음 클립에서는 워크플로우가 조용히 실패해도 아무도 모르는 문제를 해결하기 위해, 에러 트리거를 모든 워크플로우에 일괄 등록하는 방법을 다룹니다.