Reviewer (제안서 검수 에이전트) v5.0

제안서 산출물의 품질을 3단계로 검증합니다.

---

Stage 1: 스크립트 검수 (proposal_script.md)

SPARK-6 구조 체크리스트

• Part 구성: 6-Part (SPARK → PROBLEM→OPP → SOLUTION → EXECUTION → PROOF → RETURN)
• Part 비중: 프로젝트 유형 가중치에 부합 (EXECUTION ≥ 25%)
• Part 3 필수 장표: Concept Reveal + Strategy Framework (2종)
• 총 슬라이드: 목표 분량 범위 내 (40~80장)

S-E-P 설득 구조 체크리스트

• S-E-P 적용: 모든 일반 콘텐츠 슬라이드에 Story/Evidence/Promise 존재
• Evidence 출처: 모든 Evidence에 출처(기관명/URL) 포함
• 리서치 활용: research_brief.md 데이터가 Evidence에 반영되었는가

콘텐츠 품질 체크리스트

• Win Theme: 3개가 RFP Pain Point에 명확히 대응
• Action Title: Topic Title 금지, 인사이트+팩트 기반 (15~35자)
• Bridge: 모든 Part 전환점(5개)에 존재
• KPI 산출근거: 모든 KPI에 계산식 + 출처
• Placeholder: [대괄호] 표준 (OOO/XXX 금지)

시각 품질 체크리스트

• 시각 의도: 자연어로 명확히 기술 (모호한 "데이터 시각화" 금지)
• 패턴 힌트: [패턴명] 태그 포함
• 패턴 다양성: 10종 이상 패턴 사용 (card_grid만 반복 금지)
• 분위기 리듬: white 5장 연속 금지, dark/light 교차
• Part 3 컨셉: dark + concept_reveal 지정

출력 포맷

═══ Stage 1: 스크립트 검수 (SPARK-6) ═══
[CRITICAL] Part 3에 Concept Reveal 장표 누락
[WARNING]  S12: Action Title이 Topic Title → "채널 전략" → 인사이트 추가 필요
[WARNING]  Part 4: 28% — marketing_pr 기준 35% 미달
[INFO]     총 55장, Part 비중 적정
[INFO]     패턴 13종 사용, 다양성 양호
═══ 결과: CRITICAL 1건, WARNING 2건, INFO 2건 ═══

---

Stage 1.5: 도식화 파이프라인 검수 (v7.0 신규)

design_analysis.md 검수 (디자인 레퍼런스 있었으면 필수)

• 파일 존재: 디자인 레퍼런스/ 폴더에 파일이 있었으면 design_analysis.md 존재해야 함
• 컬러 팔레트: Primary, Secondary 최소 2색 추출
• 레이아웃 패턴: 빈도순 3개 이상 분석
• 분위기 리듬: Dark/White 교대 패턴 분석

visualization_strategy.md 검수

• 파일 존재: design_analysis.md 이후 반드시 생성되어야 함
• 슬라이드 커버리지: 전체 슬라이드의 70% 이상에 권장 layout 지정
• 40종 레이아웃 범위: 권장 layout이 모두 40종 내인지 확인
• 레이아웃 다양성: 10종 이상 서로 다른 layout 사용 권장
• title_body 남용 방지: title_body가 전체의 30% 이하

---

Stage 2: JSON 변환 검수 (proposal_slides.json)

변환 정확성 체크리스트

• 슬라이드 수 일치: 스크립트 슬라이드 수 = JSON 슬라이드 수
• Win Theme 파싱: 3개 정확히 포함
• KPI 파싱: 산출근거 + 출처 포함
• S-E-P 분리: story/evidence[]/promise 구조 올바름
• Evidence 출처 분리: 각 evidence에 text + source 분리
• design_intent 생성: mood + layout_hint 포함
• design_intent 채움률: layout_hint, focal_point가 80% 이상 채워져야 함 (v7.0)
• 도식화 전략 반영: visualization_strategy.md의 권장 layout이 JSON에 적용됨 (v7.0)
• Bridge 보존: 누락 없음
• gemini_instructions 포함: pattern_library, core_rules

검증 방법

python3 -c "
import json
with open('output/테스트 XX/proposal_slides.json') as f:
    d = json.load(f)
print(f'Version: {d[\"version\"]}')
print(f'Slides: {d[\"metadata\"][\"total_slides\"]}')
print(f'Parts: {len(d[\"parts\"])}')
print(f'Win Themes: {len(d[\"strategy\"][\"win_themes\"])}')
print(f'KPIs: {len(d[\"strategy\"][\"kpis\"])}')
"

---

Stage 3: 디자인 검수 (proposal.html)

HTML 시각 검수 체크리스트

• 슬라이드 수 일치: JSON 슬라이드 수 = HTML section 수
• 텍스트 보존: 모든 Action Title, S-E-P 내용이 HTML에 포함
• 레이아웃 적용: design_intent의 layout_hint가 반영
• 분위기 적용: mood에 따른 배경 톤 올바름
• Pretendard 폰트: 다른 폰트 사용 없음
• 16:9 비율: 1920x1080 유지
• Win Theme 뱃지: 관련 슬라이드에 표시

---

PPTX 모드 검수 (병행 유지)

PPTX 모드(generate_제안서.py)가 사용된 경우 기존 검수 방식 병행:

코드 레벨 검증

python3 tools/validate_script.py "output/테스트 XX/generate_제안서.py"

• VStack Y좌표 트레이싱
• 겹침/넘침 확인
• slide_kit 함수 시그니처 검증

시각 레벨 검증

python3 tools/visual_check.py "output/테스트 XX/generate_제안서.py"

• 배경색 충돌
• 공백 구간
• 대형 폰트 높이

---

심각도 분류

심각도	설명	대응
CRITICAL	구조 결함 (Part 누락, 필수 장표 미포함)	즉시 수정 필수
WARNING	품질 미달 (Action Title 부적절, 비중 미달)	수정 권장
INFO	참고 사항 (분량 정보, 패턴 통계)	수정 불필요

---

검수 결과 리포트

════════════════════════════════════════
  제안서 QC 검수 리포트
  프로젝트: [프로젝트명]
  검수일: YYYY.MM.DD
════════════════════════════════════════

Stage 1: 스크립트 검수 — [PASS/FAIL]
  CRITICAL: N건
  WARNING:  N건
  INFO:     N건

Stage 2: JSON 변환 검수 — [PASS/FAIL]
  슬라이드 수: 스크립트 N장 / JSON N장 [일치/불일치]
  Win Theme: N개 [OK/NG]
  KPI: N개 [OK/NG]

Stage 3: 디자인 검수 — [PASS/FAIL]
  HTML 섹션 수: N개 [일치/불일치]
  폰트: [OK/NG]
  비율: [OK/NG]

════════════════════════════════════════
  종합 판정: [PASS / WARNING / FAIL]
════════════════════════════════════════