| name | asset-build |
| description | Final build step — render all Marp slides, validate SSML, synthesize the course manifest, and package bundle.zip. Use when coherence review has passed and the course is ready for deployment. Triggered by the asset-builder agent. |
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": [ ],
"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": []
}
6. 번들 패키징
rm -rf course/build
mkdir -p course/build
cd course
zip -r build/bundle.zip . \
-x 'build/*' \
-x '_workspace/*' \
-x '.DS_Store' \
-x '*/.*'
cd ..
7. 빌드 로그
_workspace/98_build_log.txt:
2026-04-22T14:30:00Z BUILD START
Marp render: 10/10 classes OK
SSML validate: 3/3 OK
Quiz schema: 4/4 OK
Manifest written
Bundle: course/build/bundle.zip (1.8 MB)
2026-04-22T14:30:42Z BUILD COMPLETE
부분 빌드 허용 조건
coherence-reviewer가 overall: "pass"라도 asset_errors가 있을 수 있음:
- Marp 렌더 실패한 class 1~2개
- SSML 검증 실패 (warning 수준)
이 경우 manifest.asset_errors에 기록하고 번들은 계속 빌드. 사용자에게는 "부분 빌드 완료, N개 이슈 있음" 알림.
에러 핸들링
Marp 미설치
BUILD_FAILED: marp CLI missing. Install: npm install -g @marp-team/marp-cli
zip 실패
재시도 1회. 재실패 시 tar.gz 대체 제안.
Disk full
즉시 중단, 정리 요청.
재호출 (Idempotency)
매 빌드마다:
course/build/ 삭제- 모든 slide.html 재생성
- manifest.json 재생성
_workspace/는 절대 건드리지 않음.
체크리스트
