Claude Code용 6단계 에이전트 파이프라인: 품질 게이트 적용하기

파이프라인 아키텍처

파이프라인은 엄격한 인계 프로토콜을 가진 두 단계로 구성된 6개의 전문 에이전트를 사용합니다.

1단계 (병렬 실행):

연구 에이전트: 웹 검색, 주제 분석, 경쟁사 콘텐츠 검토 처리
분석 에이전트: GSC, GA4, DataForSEO에서 데이터 추출

2단계 (순차적 실행):

작성 에이전트: 연구 브리프에서 초안 작성
편집 에이전트: 품질, 정확성, 브랜드 톤, 인간화 검사
SEO/GEO 에이전트: 키워드 최적화, 스키마 마크업, 지역 준비 처리
마스터 에이전트: 모든 출력 검토, 품질 점수 및 플래그 생성, 최종 초안 제시

품질 게이트 시스템

파이프라인에는 에이전트 인계 사이에 명시적 품질 검사가 포함됩니다:

게이트 1: 작성자가 시작하기 전 연구 및 분석 파일이 COMPLETE 상태로 존재하는지 확인
게이트 2: 편집 시작 전 단어 수가 목표의 50% 이내이고 메타 섹션이 있는지 확인
유사한 게이트가 모든 단계를 통해 계속됨

이러한 게이트 없이는 초기 단계의 실패가 파이프라인을 통해 조용히 전파되어, 최종 검토에서야 발견되거나 아예 발견되지 않을 수 있습니다. 게이트는 실패를 "시끄럽고 빠르게" 만듭니다.

주요 구현 세부사항

시스템은 에이전트 통신을 위한 구조화된 파일 시스템을 사용합니다:

에이전트는 예측 가능한 위치(예: .claude/pipeline/research.md, draft.md)의 공유 파일에 기록
다운스트림 에이전트는 이전 단계 출력을 찾을 정확한 위치를 알고 있음
이는 "Claude가 이전 단계에서 생성된 것을 알아낼 것"이라는 암시적 인계의 취약성을 방지

개별 에이전트는 다음과 같은 명령으로 전체 파이프라인을 재시작하지 않고 재실행할 수 있습니다:

/run-agent writer "더 기술적인 톤으로 재작성"

/run-agent seo "키워드 재최적화: [새 키워드]"

이를 통해 좋은 연구 작업을 무효화하지 않고 나쁜 초안을 수정할 수 있습니다.

게시 제어

파이프라인에는 게시 전 강제 중지가 포함됩니다. 마스터 에이전트가 품질 점수와 플래그가 포함된 요약을 생성한 후, 시스템은 완전히 중단됩니다. 사용자가 수동으로 "승인됨"을 입력할 때까지 아무것도 게시되지 않습니다. 이는 적절한 검토 없이 실수로 게시되는 것을 방지합니다.

📖 Read the full source: r/ClaudeAI