capsule-authoring

name	capsule-authoring
description	Author Hi Tuto HTML lesson capsules. Use when emitting final lesson HTML, choosing scroll vs Canvas Studio vs slide shell, wiring tutor hooks, or applying postprocess/CSP constraints.

capsule-authoring

Emit one complete, self-contained HTML capsule that passes capsule/postprocess.py.

Choose a shell (from knobs.presentation / plan.presentation)

Presentation	Shell	Skill
studio	Validated stage-first lab (specimen / simulation / process cutaway)	ui-studio-style
page	Scroll mini-app	lesson_system.md paper theme
slide	Stepped deck	ui-slide-deck
auto	Resolved by coursegen/presentation.py (spatial/3D → studio, else page)	—

When presentation is auto, needs_3d: true or a Hunyuan mesh selects studio. An explicit page or slide presentation remains authoritative.

Hard constraints (every capsule)

• Tailwind CDN + only pinned Chart.js / Three.js / GLTFLoader URLs from postprocess
• Images: go-data-src="/gen?..." or go-data-src="/image?query=..." only
• Tutor hooks: data-lesson-section, data-lesson-title, data-lesson-control on controls
• At least one working canvas, one lazy image, one control that changes the view
• End with </body></html>; keep under ~45 KB

Studio mode extras

• Initial Studio lessons are rendered from StudioManifest; do not invent another shell.
• Use the selected mode reference plus the shared studio-tokens.css / studio-runtime.js.
• Short copy only; no Chapter Map, quiz, self-assessment, game, score, or tutor panel inside the capsule
• When data-mesh-src present: do not start a second Three.js loop
• Hunyuan mesh generation is specimen Studio only; simulation and cutaway use suitable adapters.

Page / slide mode

Follow coursegen/prompts/lesson_system.md paper theme (Bricolage / Jakarta / cobalt / grass).

Archetype skills (game / simulation)

When the lesson archetype is game or simulation, also follow the injected skill:

Archetype	Skill	Intent
game	skills/game	Default: dominant Three.js explore gallery (goal → explore stations → progress → reset)
simulation	skills/simulation	Parameterize → play/step → readout (no required win)

Game lessons are stage-first (Recursion Galleries–style), not scroll textbooks. Classic pinned Three.js only — never Phaser, ES modules, or third-party jam art packs.