3-3. 안전장치 — 생성 전 검증, 테스트 실행, 결과 리포트
지난 클립에서 workflow-builder 모듈에 6단계 프로세스와 노드 배치 규칙을 넣었습니다. 이제 Claude Code가 워크플로우를 만들 수는 있지만, 노드가 6개나 되면 에러 가능성도 큽니다. 이번 클립에서는 안전장치 를 추가합니다.
1. 왜 안전장치가 필요한가
워크플로우 생성은 n8n 서버에 실제로 데이터를 쓰는 작업입니다. 아침 브리핑처럼 매일 자동으로 실행되는 워크플로우가 잘못 만들어지면, 매일 아침 깨진 메시지가 슬랙 채널에 올라갑니다.
바로 생성
- 자연어 → JSON 구성 → 바로 생성
- 에러는 실행 시점에 드러남
- 잘못된 워크플로우가 매일 실행
검증 후 생성
- 자연어 → JSON → 검증 → 생성 → 테스트
- 에러는 생성 전에 잡음
- 사람이 일일이 체크할 필요 없음
2. 3단계 안전장치
안전장치는 3단계 로 구성됩니다.
1단계: 생성 전 검증 — validate_workflow 를 사용합니다. 워크플로우 JSON을 n8n 서버에 보내기 전에 구조가 올바른지 점검합니다. 아침 브리핑은 노드 6개·연결 5개 구조입니다. 연결 중 하나라도 빠지면 여기서 잡아냅니다.
2단계: 테스트 실행 — n8n_test_workflow 를 사용합니다. 단, 이 도구로 테스트 가능한 트리거 유형은 webhook, form, chat 트리거 뿐입니다. 아침 브리핑의 Schedule Trigger처럼 시간 기반 트리거는 n8n UI에서 직접 "Test workflow" 버튼을 눌러야 합니다.
3단계: 결과 리포트 — 테스트 결과를 정리해 사용자에게 보고합니다. 성공 시 워크플로우 이름·URL·노드 구성·실행 결과를, 실패 시 에러 노드·원인·수정 방법을 알립니다.
3. 아침 브리핑에서 발생할 수 있는 에러 시나리오
아침 브리핑 워크플로우는 외부 API 3개를 호출하므로 다양한 에러가 발생할 수 있습니다. 모듈에 미리 대응 방법을 적어두면, Claude Code가 워크플로우 생성 시 fallback 로직까지 포함시킵니다.
날씨 API 응답 실패
서버 다운 또는 요청 한도 초과 → fallback 메시지("날씨 정보를 가져오지 못했습니다") 전달
뉴스 RSS 파싱 에러
피드 형식 변경 또는 접속 불안정 → 건너뛰기(skip and continue) 후 나머지 데이터로 진행
AI 요약 실패
AI 노드 무응답 또는 토큰 제한 초과 → 원본 수치·뉴스 제목 그대로 슬랙 발송
노드 연결 누락
validate_workflow가 사전 검증 단계에서 에러 리포트. 특히 HTTP Request 3개가 AI 노드로 합쳐지는 지점에서 자주 발생
4. 자동 수정 — n8n_autofix_workflow
검증에서 에러가 나면 직접 JSON을 고칠 필요가 없습니다. n8n_autofix_workflow 가 자동 수정을 시도합니다.
이 도구는 validate_workflow의 에러 메시지를 분석해 자동으로 수정합니다. 예를 들어 HTTP Request와 AI 노드 사이의 연결이 빠져 있으면 연결을 추가하고, 필수 설정값이 누락되면 기본값을 채웁니다.
모든 에러를 자동 수정할 수 있는 것은 아닙니다. 불가능한 경우에는 "이 부분은 수동 확인이 필요합니다"라고 알려줍니다.
모듈에는 다음과 같은 규칙을 적어두면 됩니다.
검증 실패 시 n8n_autofix_workflow로 1회 자동 수정을 시도하고, 수정 후 다시 검증한다. 2회 연속 실패하면 사용자에게 수동 확인을 요청한다.
5. 안전 원칙 — 삭제와 수정은 반드시 사용자 확인
안전장치에서 또 하나 중요한 것은 파괴적 작업에 대한 사용자 확인 규칙입니다.
새 워크플로우를 만드는 것은 비교적 안전합니다. 잘못 만들어도 삭제하면 됩니다. 하지만 기존 워크플로우를 수정하거나 삭제하는 것은 다릅니다. 운영 중인 아침 브리핑 워크플로우를 실수로 덮어쓰면 다음 날 아침 브리핑이 오지 않습니다.
★ 원칙. 워크플로우 삭제(n8n_delete_workflow)와 전체 수정(n8n_update_full_workflow)은 실행 전에 반드시 사용자 확인을 받습니다.
Claude Code는 이 규칙을 읽고 해당 작업을 수행하기 전에 "이 워크플로우를 삭제해도 됩니까?"라고 먼저 묻습니다.
6. 실습 — workflow-builder.md에 안전장치 섹션 추가
지난 클립에서 만든 workflow-builder.md에 안전장치 섹션을 추가합니다. Claude Code에게 다음과 같이 지시합니다.
"workflow-builder.md 파일에 안전장치 섹션을 추가해줘. 다음을 포함해야 한다.<br />1. 생성 전 validate_workflow로 JSON 구조 검증<br />2. 검증 실패 시 n8n_autofix_workflow로 자동 수정 1회 시도<br />3. 생성 후 n8n_test_workflow로 테스트 실행<br />4. 에러 대응: 날씨 API 실패 → fallback, RSS 에러 → skip, AI 실패 → raw data 전송<br />5. 결과 리포트: 성공 시 URL·노드 구성, 실패 시 원인·해결 방법<br />6. 안전 원칙: 삭제와 전체 수정은 사용자 확인 필수"
파일이 수정되면 에디터에서 확인합니다. 기존 6단계 프로세스 아래에 안전장치 섹션이 추가되어 있으면 성공입니다.
7. 전체 흐름 복습
사용자가 "매일 아침 AI 브리핑 워크플로우 만들어줘"라고 말했을 때 Claude Code의 동작 흐름입니다.
모든 과정이 모듈 파일에 적혀 있어, Claude Code는 매번 동일한 절차를 따릅니다. 사람이 빠뜨리기 쉬운 검증과 테스트를 시스템이 대신 챙깁니다.
8. 마무리
이번 클립에서 워크플로우 생성 모듈에 3단계 안전장치 를 추가했습니다.
생성 전 검증
validate_workflow로 JSON 구조 점검
테스트 실행
n8n_test_workflow로 실제 실행
결과 리포트
성공·실패 모두 정리해 보고
여기에 자동 수정(n8n_autofix_workflow), 에러 시나리오별 대응(fallback / skip / raw data), 파괴적 작업 사용자 확인 원칙까지 더했습니다.
이제 도구도 알고, 절차도 있고, 안전장치도 갖췄습니다. 다음 클립에서는 실전입니다. 자연어 한 줄로 매일 아침 AI 브리핑 워크플로우를 직접 만들어 봅니다.