다큐멘터리 제작을 위한 리서치, 구성안, 인터뷰 질문, 내레이션 대본을 에이전트 팀이 협업하여 한 번에 생성하는 풀 프로덕션 파이프라인. '다큐멘터리 기획해줘', '다큐 구성안 짜줘', '다큐멘터리 리서치', '인터뷰 질문 만들어줘', '내레이션 대본 써줘', '탐사 보도 기획', '다큐 시나리오' 등 다큐멘터리 제작 전반에 이 스킬을 사용한다. 기존 리서치 자료가 있는 경우에도 구성안 작성이나 내레이션 대본 작성을 지원한다. 단, 실제 영상 촬영·편집(Premiere, DaVinci), 인터뷰 섭외·진행, 방송 송출은 이 스킬의 범위가 아니다.
다큐멘터리의 리서치→구성안→인터뷰질문→내레이션 대본을 에이전트 팀이 협업하여 한 번에 생성한다.
에이전트 팀 — 5명이 SendMessage로 직접 통신하며 교차 검증한다.
| 에이전트 | 파일 | 역할 | 타입 |
|---|---|---|---|
| researcher | .claude/agents/researcher.md | 자료조사, 통계수집, 출처정리 | general-purpose |
| story-architect | .claude/agents/story-architect.md | 3막 구성안, 씬 분할, 서사 아크 | general-purpose |
| interviewer | .claude/agents/interviewer.md | 인터뷰 대상 선정, 질문 설계 | general-purpose |
| narrator | .claude/agents/narrator.md | 내레이션 대본, 톤, 리듬 | general-purpose |
| fact-checker |
.claude/agents/fact-checker.md |
| 팩트 검증, 출처 확인, 편향성 점검 |
| general-purpose |
_workspace/ 디렉토리를 프로젝트 루트에 생성한다_workspace/00_input.md에 저장한다_workspace/에 복사하고 해당 Phase를 건너뛴다| 순서 | 작업 | 담당 | 의존 | 산출물 |
|---|---|---|---|---|
| 1 | 리서치 | researcher | 없음 | _workspace/01_research_brief.md |
| 2 | 구성안 작성 | story-architect | 작업 1 | _workspace/02_structure.md |
| 3a | 인터뷰 가이드 | interviewer | 작업 1, 2 | _workspace/03_interview_guide.md |
| 3b | 내레이션 대본 | narrator | 작업 1, 2 | _workspace/04_narration_script.md |
| 4 | 팩트체크/리뷰 | fact-checker | 작업 1, 3a, 3b | _workspace/05_review_report.md |
작업 3a(인터뷰)와 3b(내레이션)는 병렬 실행한다. 둘 다 작업 1(리서치)과 2(구성안)에 의존한다.
팀원 간 소통 흐름:
_workspace/ 내 모든 파일을 확인한다01_research_brief.md02_structure.md03_interview_guide.md04_narration_script.md05_review_report.md| 사용자 요청 패턴 | 실행 모드 | 투입 에이전트 |
|---|---|---|
| "다큐멘터리 기획해줘", "풀 프로덕션" | 풀 파이프라인 | 5명 전원 |
| "리서치만 해줘" | 리서치 모드 | researcher + fact-checker |
| "이 자료로 구성안 짜줘" (기존 파일) | 구성 모드 | story-architect + fact-checker |
| "인터뷰 질문만 만들어줘" | 인터뷰 모드 | researcher + interviewer + fact-checker |
| "내레이션 대본만 써줘" (기존 구성안) | 내레이션 모드 | narrator + fact-checker |
기존 파일 활용: 사용자가 리서치 자료, 구성안 등을 제공하면, 해당 파일을 _workspace/의 적절한 위치에 복사하고 해당 에이전트는 건너뛴다.
| 전략 | 방식 | 용도 |
|---|---|---|
| 파일 기반 | _workspace/ 디렉토리 | 주요 산출물 저장 및 공유 |
| 메시지 기반 | SendMessage | 실시간 핵심 정보 전달, 수정 요청 |
| 태스크 기반 | TaskCreate/TaskUpdate | 진행 상황 추적, 의존 관계 관리 |
파일명 컨벤션: {순번}_{산출물명}.{확장자}
| 에러 유형 | 전략 |
|---|---|
| 웹 검색 실패 | 일반 지식 기반으로 작업, 보고서에 "데이터 제한" 명시 |
| 한쪽 관점만 발견 | 의도적으로 반대 관점 검색, 실패 시 보고서에 명시 |
| 에이전트 실패 | 1회 재시도 → 실패 시 해당 산출물 없이 진행, 리뷰 보고서에 누락 명시 |
| 리뷰에서 🔴 발견 | 해당 에이전트에 수정 요청 → 재작업 → 재검증 (최대 2회) |
| 민감한 주제 | 법적·윤리적 리스크를 보고서에 명시, 전문 법률 자문 권고 |
프롬프트: "한국의 1인 가구 증가와 사회적 고립 문제에 대한 30분 다큐멘터리를 기획해줘" 기대 결과:
프롬프트: "이 리서치 자료로 다큐 구성안이랑 내레이션 대본 써줘" + 리서치 파일 첨부 기대 결과:
_workspace/01_research_brief.md로 복사프롬프트: "다큐 리서치만 해줘, 주제는 아무거나 사회 이슈" 기대 결과:
각 에이전트는 다음 확장 스킬의 전문 지식을 활용하여 산출물의 품질을 높인다:
| 에이전트 | 확장 스킬 | 제공 지식 |
|---|---|---|
| researcher, fact-checker | /investigative-research | PRIMA 자료 계층, CRAAP 신뢰도 평가, 삼각검증, 편향성 분석 |
| story-architect, narrator | /narrative-structure | 5가지 서사 유형, 3막 구조, 감정 곡선, 씬 배열 전략 |
| interviewer | /interview-design | VOICE 대상 선정, 깔때기 질문 모델, 유형별 전략, 윤리 원칙 |