Report Generator

Report Generator — 업무 보고서 풀 파이프라인

업무 보고서의 데이터수집→분석→시각화→집필→요약을 에이전트 팀이 협업하여 한 번에 생성한다.

실행 모드

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

에이전트 구성

워크플로우

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

1. 사용자 입력에서 추출한다:
   • 보고서 주제: 무엇에 대한 보고서인가
   • 보고 유형: 정기(월간/분기/연간) / 프로젝트 / 분석
   • 보고 대상: 경영진 / 팀장 / 실무자 / 외부
   • 기간: 보고 대상 기간
   • 기존 자료 (선택): 사용자가 제공한 데이터, 분석 결과, 이전 보고서
2. _workspace/ 디렉토리를 프로젝트 루트에 생성한다
3. 입력을 정리하여 _workspace/00_input.md에 저장한다
4. 기존 파일이 있으면 _workspace/에 복사하고 해당 Phase를 건너뛴다
5. 요청 범위에 따라 실행 모드를 결정한다 (아래 "작업 규모별 모드" 참조)

Phase 2: 팀 구성 및 실행

작업 3a(시각화)와 3b(집필)는 병렬 실행한다. 둘 다 작업 2(분석)에만 의존한다.

팀원 간 소통 흐름:

• collector 완료 → analyst에게 데이터셋+품질 메모 전달, visualizer에게 정량 데이터 하이라이트 전달
• analyst 완료 → visualizer에게 시각화 제안 전달, writer에게 인사이트+논리 전개 제안 전달
• visualizer 완료 → writer에게 시각화 명세+삽입 위치 전달
• writer 완료 → summarizer에게 보고서 전문 전달
• summarizer는 모든 산출물을 교차 검증. 🔴 필수 수정 발견 시 해당 에이전트에게 수정 요청 → 재작업 → 재검증 (최대 2회)

Phase 3: 통합 및 최종 산출물

1. _workspace/ 내 모든 파일을 확인한다
2. 검증 보고서의 🔴 필수 수정이 모두 반영되었는지 확인한다
3. 최종 요약을 사용자에게 보고한다:
   • 데이터 수집 — 01_data_collection.md
   • 분석 보고서 — 02_analysis_report.md
   • 시각화 명세 — 03_visualization_spec.md
   • 최종 보고서 — 04_full_report.md
   • 경영진 요약 — 05_executive_summary.md

작업 규모별 모드

기존 파일 활용: 사용자가 데이터, 분석 결과 등 기존 파일을 제공하면 해당 단계를 건너뛴다.

데이터 전달 프로토콜

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

에러 핸들링

테스트 시나리오

정상 흐름

프롬프트: "2024년 4분기 매출 실적 보고서를 만들어줘. 보고 대상은 경영진이야." 기대 결과:

• 데이터 수집: 매출 관련 공개 데이터, 산업 트렌드 수집
• 분석: 전년 동기 대비, 분기별 추이, 업계 평균 비교
• 시각화: 매출 추이 선형 차트, 제품별 비중 원형 차트, KPI 테이블
• 보고서: PREP 구조, 경영진 톤, 액션 아이템 3개 이상
• 요약: 1페이지 경영진 요약 + 정합성 매트릭스 전항목 확인

기존 데이터 활용 흐름

프롬프트: "이 CSV 데이터로 분석 보고서 만들어줘" + 데이터 파일 제공 기대 결과:

• 데이터 수집 단계 건너뜀
• 제공된 데이터를 _workspace/01_data_collection.md로 정리
• analyst + visualizer + writer + summarizer 투입

에러 흐름

프롬프트: "시장 동향 보고서 만들어줘, 자료는 없어" 기대 결과:

• 수집가가 웹 검색으로 공개 데이터 확보 시도
• 검색 실패 시 일반적 시장 지식 기반으로 작업
• 검증 보고서에 "데이터 제한 — 웹 검색 기반 추정치 활용" 명시

에이전트별 확장 스킬