품질 게이트가 적용된 Claude 코드용 다중 에이전트 콘텐츠 파이프라인

파이프라인 아키텍처

파이프라인은 엄격한 인계 프로토콜을 가진 두 단계로 구성된 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 "키워드 재최적화: [새 키워드]"

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

게시 제어

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