course-builder: Skill for Claude Code

Asset Build — Deployable Bundle

coherence-reviewer가 overall: "pass" 판정한 뒤 수행. Idempotent — 여러 번 돌려도 결과 동일.

실행 조건

• _workspace/99_coherence_report.json의 overall == "pass"
• 아니면 거부: BUILD_REFUSED: coherence not passed

빌드 순서

1. 환경 검증

• marp CLI 설치 확인
• xmllint 또는 fallback 경로 확인
• zip 설치 확인

2. Marp 전체 재렌더

모든 slide.source.md를 재렌더하여 slide.html을 갱신. 이유: 중간에 슬라이드만 수정되었을 수 있으므로 항상 최신 상태 보장 (idempotency).

find course/sections -name slide.source.md -print0 | while IFS= read -r -d '' f; do
  dir=$(dirname "$f")
  marp --html --allow-local-files "$f" -o "$dir/slide.html"
done

3. SSML 검증

존재하는 transcript.ssml 각각에 대해 validate-ssml.sh 실행. 실패는 WARNING으로 격하 (txt는 항상 유효).

4. Quiz schema 검증

각 quiz.json 비즈니스 룰 검증:

• items 길이 5~9
• mcq_single의 correct 길이 == 1
• mcq_multi의 correct 길이 2~3
• 모든 item.explanation 비어있지 않음
• bloom_distribution 키 집합 유효

5. Manifest 합성

course/manifest.json:

{
  "course": {
    "topic": "...", "audience": "...",
    "depth": "...", "language": "ko", "tone": "...",
    "total_duration_min": 120,
    "build_ts": "2026-04-22T14:30:00Z",
    "harness_version": "1.1.0"
  },
  "learning_objectives": [ /* from _workspace/01_architect_learning_objectives.json */ ],
  "sections": [
    {
      "id": "S1", "slug": "01-intro", "title": "...",
      "lo_ids": ["LO-1.1","LO-1.2"],
      "quiz_path": "sections/01-intro/quiz.json",
      "classes": [
        {
          "id": "S1.C1", "slug": "01-what-is-rsc", "title": "...",
          "lo_ids": ["LO-1.1"],
          "assets": {
            "slide_source": "sections/01-intro/classes/01-what-is-rsc/slide.source.md",
            "slide_html":   "sections/01-intro/classes/01-what-is-rsc/slide.html",
            "note_md":      "sections/01-intro/classes/01-what-is-rsc/note.md",
            "transcript_txt": "sections/01-intro/classes/01-what-is-rsc/transcript.txt",
            "transcript_ssml": "sections/01-intro/classes/01-what-is-rsc/transcript.ssml"
          }
        }
      ]
    }
  ],
  "stats": {
    "sections": 4, "classes": 10, "total_slides": 45,
    "lo_count": 14,
    "bloom_distribution": {"Remember":2,"Understand":4,"Apply":5,"Analyze":3},
    "estimated_audio_duration_sec": 7200
  },
  "asset_errors": []
}