Documentary Research

Documentary Research — 다큐멘터리 제작 풀 프로덕션 파이프라인

다큐멘터리의 리서치→구성안→인터뷰질문→내레이션 대본을 에이전트 팀이 협업하여 한 번에 생성한다.

실행 모드

에이전트 팀 — 5명이 SendMessage로 직접 통신하며 교차 검증한다.

에이전트 구성

워크플로우

Phase 1: 준비 (오케스트레이터 직접 수행)

1. 사용자 입력에서 추출한다:
   • 주제: 다큐멘터리가 다룰 주제
   • 형식: 탐사형/인물형/역사형/관찰형
   • 분량: 15분/30분/60분/90분
   • 톤 (선택): 객관적/감성적/긴장감/성찰적
   • 기존 파일 (선택): 리서치 자료, 기획서 등
2. _workspace/ 디렉토리를 프로젝트 루트에 생성한다
3. 입력을 정리하여 _workspace/00_input.md에 저장한다
4. 기존 파일이 있으면 _workspace/에 복사하고 해당 Phase를 건너뛴다
5. 요청 범위에 따라 실행 모드를 결정한다

Phase 2: 팀 구성 및 실행

작업 3a(인터뷰)와 3b(내레이션)는 병렬 실행한다. 둘 다 작업 1(리서치)과 2(구성안)에 의존한다.

팀원 간 소통 흐름:

• researcher 완료 → story-architect에게 타임라인·핵심사실 전달, interviewer에게 전문가 목록 전달
• story-architect 완료 → interviewer에게 씬별 인터뷰 필요사항 전달, narrator에게 톤·감정흐름 전달
• interviewer ↔ narrator: 인터뷰 주제를 공유하여 내레이션과의 중복 방지
• fact-checker는 모든 산출물을 교차 검증. 🔴 필수 수정 발견 시 해당 에이전트에게 수정 요청 → 재작업 → 재검증 (최대 2회)

Phase 3: 통합 및 최종 산출물

1. _workspace/ 내 모든 파일을 확인한다
2. 리뷰 보고서의 🔴 필수 수정이 모두 반영되었는지 확인한다
3. 최종 요약을 사용자에게 보고한다:
   • 리서치 브리프 — 01_research_brief.md
   • 구성안 — 02_structure.md
   • 인터뷰 가이드 — 03_interview_guide.md
   • 내레이션 대본 — 04_narration_script.md
   • 팩트체크 보고서 — 05_review_report.md

작업 규모별 모드

기존 파일 활용: 사용자가 리서치 자료, 구성안 등을 제공하면, 해당 파일을 _workspace/의 적절한 위치에 복사하고 해당 에이전트는 건너뛴다.

데이터 전달 프로토콜

파일명 컨벤션: {순번}_{산출물명}.{확장자}

에러 핸들링

테스트 시나리오

정상 흐름

프롬프트: "한국의 1인 가구 증가와 사회적 고립 문제에 대한 30분 다큐멘터리를 기획해줘" 기대 결과:

• 리서치: 통계(1인 가구 비율, 사회적 고립 지표), 전문가 목록, 다각적 관점
• 구성안: 3막 구조, 7~10씬, 감정 곡선(공감→심화→희망)
• 인터뷰: 사회학 교수, 1인 가구 당사자, 정책 담당자 등 5~7명 가이드
• 내레이션: 약 7,500단어 대본, 영상 지시 포함
• 팩트체크: 통계 출처 확인, 균형성 검증

기존 파일 활용 흐름

프롬프트: "이 리서치 자료로 다큐 구성안이랑 내레이션 대본 써줘" + 리서치 파일 첨부 기대 결과:

• 기존 리서치를 _workspace/01_research_brief.md로 복사
• 구성 모드 + 내레이션 모드 병합: story-architect + narrator + fact-checker 투입
• researcher, interviewer는 건너뜀

에러 흐름

프롬프트: "다큐 리서치만 해줘, 주제는 아무거나 사회 이슈" 기대 결과:

• 리서치 모드로 전환 (researcher + fact-checker)
• 주제가 불분명하므로 리서처가 최근 사회 이슈 3개를 제안 후 진행
• 팩트체크 보고서에 "구성안/인터뷰/내레이션 미생성" 명시

에이전트별 확장 스킬

각 에이전트는 다음 확장 스킬의 전문 지식을 활용하여 산출물의 품질을 높인다: