3-2. 워크플로우 생성 모듈 작성 — workflow-builder.md
스킬에 첫 번째 모듈을 추가합니다. 지금까지 스킬은 뼈대만 있고 references 폴더는 비어 있었습니다. 이번 클립에서는 workflow-builder.md 모듈 파일을 만들어, Claude Code가 자연어 명령 하나로 n8n 워크플로우를 생성하도록 합니다.
1. workflow-builder 모듈이 하는 일
사용자가 "이런 워크플로우 만들어줘"라고 말하면, Claude Code가 이 모듈을 읽고 정해진 절차대로 워크플로우를 만듭니다.
핵심은 6단계 프로세스입니다.
요청 분석 — 사용자가 무엇을 원하는지 파악
노드 검색 — 필요한 노드를 search_nodes로 찾기
JSON 구성 — 워크플로우 JSON을 조립
검증 — validate_workflow로 오류 확인
생성과 테스트 — n8n_create_workflow로 생성, n8n_test_workflow로 실행
결과 보고 — 성공 여부를 사용자에게 알림
이 6단계를 모듈 파일에 적어두면, Claude Code는 매번 동일한 순서를 따릅니다.
2. 6단계 프로세스와 MCP 도구 매핑
아침 브리핑 워크플로우를 예시로 각 단계의 동작을 정리합니다.
| 단계 | 동작 | 사용 도구 |
|---|---|---|
| 1. 요청 분석 | "오전 9시·날씨·뉴스·환율·AI 요약·슬랙"으로 작업 분해 | Claude 판단 |
| 2. 노드 검색 | Schedule Trigger / HTTP Request / AI / Slack 검색 및 스펙 확인 | search_nodes, get_node |
| 3. JSON 구성 | 6개 노드 배치, 연결, 설정값 작성 | Claude 판단 |
| 4. 검증 | 노드 연결과 필수 설정 사전 점검 | validate_workflow |
| 5. 생성과 테스트 | 워크플로우 생성 후 실행 테스트 | n8n_create_workflow, n8n_test_workflow |
| 6. 결과 보고 | 성공: 이름·URL·노드 구성 / 실패: 원인·해결 방법 | Claude 판단 |
3. 노드 배치 규칙 — 좌에서 우로 300px 간격
모듈에 반드시 포함해야 할 규칙이 하나 더 있습니다. 노드 배치 규칙 입니다.
n8n에서 워크플로우를 JSON으로 만들 때 각 노드의 위치(position)를 지정해야 합니다. 지정하지 않으면 노드들이 한 곳에 겹쳐 캔버스가 엉망이 됩니다.
규칙은 왼쪽에서 오른쪽으로 300px 간격 배치입니다. 아침 브리핑 워크플로우라면 다음과 같이 됩니다.
Schedule Trigger
[250, 300] (가장 왼쪽, 트리거)
HTTP Request: 날씨
[550, 200] (중앙 상단)
HTTP Request: 뉴스
[550, 400] (중앙 하단)
HTTP Request: 환율
[550, 600] (중앙 아래)
AI 노드
[850, 400] (중앙 우측)
Slack
[1150, 400] (가장 오른쪽)
이 규칙을 모듈 파일에 적어두면, Claude Code가 워크플로우를 만들 때마다 자동으로 적용합니다.
4. 실습 — workflow-builder.md 파일 생성
Claude Code에게 다음과 같이 지시합니다.
".claude/skills/n8n/references 폴더에 workflow-builder.md 파일을 만들어줘. 내용은 다음을 포함해야 한다. 첫째, 워크플로우 생성 6단계 프로세스. 둘째, 각 단계에서 사용할 MCP 도구 이름. 셋째, 노드 배치 규칙으로 왼쪽에서 오른쪽으로 300px 간격. 넷째, 안전 원칙으로 파괴적 작업은 사용자 확인 필수."
파일이 생성되면 에디터에서 확인합니다. 6단계 프로세스가 순서대로 적혀 있고, 각 단계에 어떤 도구를 쓰는지 매핑되어 있으면 성공입니다.
5. SKILL.md 라우팅 테이블 업데이트
모듈 파일을 만든 다음에는 SKILL.md의 라우팅 테이블도 업데이트 해야 합니다.
섹션 2에서 만든 SKILL.md에는 "워크플로우 생성/수정" 요청을 workflow-builder.md로 보내라는 행이 있습니다. 그 행의 모듈 경로가 references/workflow-builder.md 로 정확히 연결되어 있는지 확인합니다.
라우팅이 끊어져 있으면 Claude Code가 모듈을 찾지 못합니다. 다음과 같이 지시하면 됩니다.
"SKILL.md의 라우팅 테이블에서 워크플로우 생성/수정 행의 모듈 경로를 references/workflow-builder.md로 업데이트해줘."
6. 마무리
이번 클립에서 두 가지를 완료했습니다.
- references/workflow-builder.md 파일 생성 — 6단계 프로세스, MCP 도구 매핑, 노드 배치 규칙, 안전 원칙 포함
- SKILL.md 라우팅 테이블 업데이트 — "워크플로우 만들어줘" 요청이 이 모듈로 연결됨
이제 Claude Code에게 "매일 아침 AI 브리핑 워크플로우 만들어줘"라고 말하면 스킬이 활성화되고 workflow-builder 모듈이 로드되어 6단계 프로세스를 따릅니다.
다만 아직 한 가지가 빠져 있습니다. 날씨 API가 응답하지 않거나 AI 요약이 실패하면 어떻게 할 것인가입니다. 다음 클립에서는 안전장치 를 설계합니다.