Script Writer

slides.md가 없으면 에러를 출력하고 중단한다. guide/가 없으면 에러를 출력하고 중단한다.

대본 작성 규칙

대본의 형식, 7가지 원칙, 유형별 가이드, 구어체 규칙은 모두 **references/writing-rules.md**에 정의되어 있다. 작업 시작 전에 반드시 이 파일을 읽고, 모든 규칙을 준수한다.

병렬 실행 시 각 워커 태스크 파일에 writing-rules.md 전문을 포함해야 한다. 요약하거나 축약하면 품질이 저하된다.

작업 순서

Phase 1: 분석

1. 가이드 전체 읽기 → 개념 구조, Q&A, 비유, 오해 목록을 정리
2. 슬라이드 분석 → 세션/섹션별 분할, 각 슬라이드의 레이아웃·코드·v-click 단계·시각 요소 파악
3. 수강생 프로필 파악 → 가이드의 수강 대상(audience) 정보 확인
4. 세션 분할 → 슬라이드를 세션 또는 논리적 단위로 나눈다 (section 슬라이드 기준)

Phase 2: 아웃라인 생성 (2단계 생성의 1단계)

세션별 대본 아웃라인을 먼저 생성한다. 아웃라인에는 각 슬라이드의 핵심 메시지, 예상 시간, [click] 포인트를 포함한다.

아웃라인 형식:

## Session {n}: {title} ({예상 시간}분)

### 슬라이드 {번호}: {제목}
- 핵심 메시지: {1문장}
- 시각 요소: {코드 블록, 다이어그램, 테이블 등}
- v-click 단계: {N}개
- 헷갈림 포인트: {있으면 기술}
- 예상 시간: {N}분

아웃라인을 사용자에게 보여주고, 방향이 맞는지 확인받은 후 Phase 3으로 진행한다. 사용자가 --no-review 또는 Full-Auto 모드이면 확인 없이 바로 Phase 3으로 넘어간다.

Phase 3: 대본 작성 (실행)

슬라이드 수에 따라 실행 전략을 선택한다.

전략 A: Agent 병렬 실행 (기본, 2개 세션 이상)

Claude Agent 도구로 세션별 subagent를 동시에 생성한다. 각 subagent에게 전달하는 프롬프트에는:

• references/writing-rules.md의 전문
• 해당 세션의 가이드 원문
• 해당 세션의 슬라이드 원문 (Markdown 그대로)
• 이전 세션 마지막 슬라이드 요약 (도입부 연결용)
• 다음 세션 첫 슬라이드 요약 (전환 멘트용)
• 출력: .omc/script-writer/{topic}/session-{n}-output.md

Agent(
  description="script session {n}",
  prompt="아래 규칙에 따라 발표자 대본을 작성하라. ... (writing-rules 전문 + 슬라이드 + 가이드)",
  run_in_background=true
)

모든 Agent를 한 번의 메시지에서 동시 생성하여 최대 병렬성을 확보한다.

전략 B: Codex 병렬 실행 (tmux + codex CLI 사용 가능 시)

tmux에서 세션별 codex 워커를 병렬 실행한다. 태스크 파일 형식은 references/task-template.md를 참조한다.

TOPIC="{topic}"
PROJDIR="$(pwd)"
WORKDIR="${PROJDIR}/.omc/script-writer/${TOPIC}"

for n in $(seq 1 $SESSION_COUNT); do
  tmux new-window -n "script-s${n}" \
    "codex exec --full-auto -C ${PROJDIR} \
      'Read the file .omc/script-writer/${TOPIC}/session-${n}-task.md. \
      Follow every instruction in that file. \
      Write your complete output to .omc/script-writer/${TOPIC}/session-${n}-output.md. \
      Do NOT modify any other files.' \
    ; echo 'DONE' > ${WORKDIR}/.session-${n}-done"
done

전략 C: 순차 실행 (1개 세션 또는 짧은 슬라이드)

오케스트레이터가 직접 writing-rules.md를 참조하며 순차 작성한다.

전략 선택 기준

Phase 4: 병합 및 검증

1. 각 session-{n}-output.md를 읽는다
2. slides.md의 해당 세션 부분을 output으로 교체한다
3. 세션 간 연결 보정: 도입부와 전환 멘트가 자연스럽게 이어지는지 확인하고, 필요시 수정
4. 시간 합계 검증: 세션별 시간 합계가 할당 시간의 ±10% 이내인지 확인
5. [click] 싱크 검증: [click] 수 = v-click 단계 수
6. 자가 검증 체크리스트 실행 (아래 참조)
7. 검증 실패 시 해당 세션만 재작성

Phase 5: 정리

• .omc/script-writer/{topic}/ 임시 디렉토리 삭제
• slides.md에 최종 결과가 반영되었는지 확인

자가 검증

작성 완료 후 모든 슬라이드의 대본을 순회하며 확인한다:

1. 완전성: 모든 슬라이드에 [스크립트] 대본이 있는가? (cover, section 포함)
2. [click] 싱크: [click] 수 = 해당 슬라이드의 v-click 단계 수인가?
3. 시각 요소 커버: 슬라이드의 코드, 이미지, 테이블, 강조 박스가 대본에서 전부 설명되는가?
4. 시간 합계: 세션별 시간 합계가 세션 할당 시간의 ±10% 이내인가?
5. Q&A 최소 수량: 개념/코드 설명 슬라이드마다 Q&A 최소 2개인가?
6. 도입-전환 연결: 모든 슬라이드가 이전/다음 슬라이드와 자연스럽게 연결되는가?
7. 헷갈림 포인트: 가이드의 주요 오해/주의사항이 대본에 반영되었는가?
8. 구어체: 문어체 표현("~이다", "~한다")이 남아있지 않은가?
9. 코드 줄 해설: 코드 블록이 있는 슬라이드에서 줄 단위 해설이 포함되었는가?

완료 보고

발표자 대본 작성 완료: lectures/{topic}/slides/slides.md
- 총 슬라이드 수: N장 (대본 작성: N장)
- 총 예상 발표 시간: N분 (세션별: S1 N분, S2 N분, ...)
- Q&A 대비: 총 N개
- 헷갈림 포인트: 총 N개
- 시간 검증: ✅ 세션별 ±10% 이내 / ⚠️ 세션 X 초과 (N분 → 할당 N분)