Adaptive presentation

Adaptive Presentation

사용자가 바로 발표하고 편집할 수 있는 PowerPoint를 만든다. 가장 중요한 기준은 첫 장면부터 결론·의미·다음 행동이 보이는 것이다.

산출물

• 기본 산출물: 요청한 장수의 편집 가능한 16:9 .pptx 1개
• 사용자가 요청한 경우에만 PDF 또는 생성 스크립트를 추가한다.
• 최종 출력 위치에는 요청한 파일만 남긴다. 조사 메모·생성 스크립트·PDF·QA 이미지는 저장소와 최종 출력 폴더 밖의 세션 작업 디렉터리에 두고 완료 시 정리한다.

입력

입력	처리
TOPIC	반드시 확인하거나 문맥에서 명확히 추론
AUDIENCE	직급·직무·사전지식에 맞춰 내용과 표현 조정
PURPOSE	설명·의사결정·설득·교육·영업·보고 중 결정
SLIDE_COUNT	지정하면 정확히 준수, 없으면 목적에 맞게 결정
LANG	사용자 언어 사용
TEMPLATE/BRAND	제공되면 master·grid·font·color를 우선 적용
OUTPUT	사용자 지정 파일명·경로·형식 준수

결과를 크게 바꾸는 정보만 한 번에 하나씩 질문한다. 충분한 정보가 있으면 질문하지 않는다.

필수 워크플로

1. 조사와 Fact Ledger

• 외부 사실·최신 정보·가격·규제·제품 상태·고객 성과를 사용하는 경우 web-search 스킬을 호출한다. 검색 backend와 원문 검증 방법은 web-search가 결정하며 이 스킬에서 별도 정책을 정의하지 않는다.
• 사용자 제공 자료만 재구성하거나 외부 사실이 없는 창작형 덱은 불필요한 웹 조사를 강제하지 않는다.
• 복합 조사 결과는 web-search의 공통 Fact Ledger 계약을 그대로 사용해 메인 에이전트가 하나의 fact-ledger.md로 병합한다. 슬라이드 매핑이 필요하면 Slide candidate만 확장 필드로 추가한다.
• 상충, Preview, 가정, 추정, 시연 데이터는 명시적으로 표시한다.

2. 스토리라인

코드를 작성하기 전에 storyline.md에 요청 장수를 배분하고 슬라이드별로 다음을 확정한다.

• 청중이 받아들일 결론형 제목
• 기억해야 할 한 문장과 다음 판단·행동
• 사용할 Fact Ledger 근거와 출처
• 정보 관계에 맞는 시각 형태
• 이전·다음 슬라이드와의 논리적 연결

제목만 연속해서 읽어도 논리가 완성되어야 한다. 결론이나 판단을 바꾸지 않는 장은 제거·통합하고, 고정 장수를 채워야 하면 반복 문구 대신 근거·사례·비교·실행 기준을 추가한다. 목적별 서사 패턴은 reference/narrative-patterns.md를 참고한다.

3. 제작

• reference/pptx-production.md를 따라 python-pptx로 직접 만든다.
• 사용자가 준 템플릿이 없으면 고정 템플릿·고정 레이아웃을 강제하지 않고 정보 관계에 맞게 구성한다.
• 한 슬라이드는 질문 하나, 결론 하나, 핵심 근거 2~4개를 기본으로 한다.
• 첫 본문 슬라이드에서 핵심 결론·가치·다음 행동을 보여준다.
• 제목+불릿만 반복하지 않고 숫자·표·차트·흐름·비교·계층·타임라인 중 적합한 native visual을 사용한다.
• 핵심 도형·차트·텍스트는 편집 가능한 PowerPoint 객체로 만든다.
• 같은 역할의 본문 제목 크기와 색상 의미를 덱 전체에서 일관되게 유지한다.
• 작은 글씨로 과밀 문제를 숨기지 않는다. 주요 본문은 원칙적으로 15pt 이상을 유지한다.
• 차트는 실제 데이터와 축·단위·기준일을 사용한다. 외부 사실이 있는 슬라이드에는 footer 출처를 표시한다.
• 권한이 불분명한 로고·인물·브랜드 자산을 임의 생성하지 않는다.

관계형 레이아웃 아이디어는 reference/slide-blueprints.md를 선택적으로 참고하고, 임원 편집 스타일은 reference/editorial-business-style.md를 따른다.

4. 렌더 검증과 수정

scripts/verify_deck.py와 reference/verification.md를 사용한다.

1. 동일한 최초 PPTX에 대해 구조 감사와 전체 렌더를 실행한다.
2. compact contact sheet를 확인하고 위험 슬라이드만 상세 확인한다.
3. 겹침·잘림·경계 이탈·낮은 대비·제목 크기 편차·출처 누락을 한 번에 기록한다.
4. 결함을 일괄 수정하고 새 PPTX를 생성한다.
5. 소수 슬라이드의 비구조 수정은 변경 슬라이드만 다시 확인하고, 구조나 다수 슬라이드가 바뀌면 전체 렌더를 다시 확인한다.

시각 검증 없이 완료했다고 주장하지 않는다. 실행 최적화와 캐시는 reference/full-optimized.md를 따르되 품질 단계를 생략하지 않는다.

완료 조건

• 요청한 형식·장수·언어·템플릿 조건을 지켰다.
• 첫 장면에서 결론·가치·다음 행동이 보이고 제목만 읽어도 서사가 이어진다.
• 내용 전달이 목적인 본문 슬라이드에는 관계를 설명하는 시각 구조가 있다. 표지·section divider·단순 마무리 장은 장식적 visual을 억지로 추가하지 않는다.
• 의도하지 않은 geometry overlap과 rendered text overlap이 0이다.
• 텍스트가 경계와 컨테이너 안에 있고 발표 거리에서 읽힌다.
• 외부 사실을 사용하는 슬라이드에 출처가 있고 Preview·가정·시연 데이터가 표시된다.
• PPTX가 정상적으로 열리고 압축 구조 오류가 없다.
• 저장소와 최종 출력 폴더에 임시 .py, .pyc, __pycache__, PDF, QA 이미지가 남지 않는다.

참고

• 제작: reference/pptx-production.md
• 서사: reference/narrative-patterns.md
• 시각 패턴: reference/slide-blueprints.md
• 검증: reference/verification.md
• 최적화: reference/full-optimized.md
• 도구 확인: scripts/toolcheck.py
• 통합 검증: scripts/verify_deck.py