메뉴
Use when triaging user feedback on a rendered lesson MP4 — symptom→wave mapping, minimal re-run flags, and the structural-change approval protocol. Not for use during waves 1–5 video production.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
| name | lesson-debugger |
| description | Use when triaging user feedback on a rendered lesson MP4 — symptom→wave mapping, minimal re-run flags, and the structural-change approval protocol. Not for use during waves 1–5 video production. |
Invoked only after the user reviews the rendered MP4 and reports an issue.
| Symptom | Owner |
|---|---|
| Concept / learning goal wrong | W1 storyboard |
| Confusing visuals / object choice | W2 visual-design (Visual Contract) |
| Script content or narration pacing | W2 audio/captions (script content) OR voice config |
| Caption timing off | W3 voice/ASR — re-check transcript before adjusting |
| Label overlaps art / element inside wrong region | W2 visual-design — zones not declared (kids-eye §1.5) |
| Comparison sides don't match (different vocab) | W2 visual-design — identity-preserved-transformation broken (kids-eye §4) |
| Teaching object doesn't read at glance | W3 primitive-gap-scan — finger-cover test was skipped |
| Teacher marks / pointer misaligned | W4 sketch-layer (cue-relative offsets) OR composer (frame literal bug) |
| Sketch marks render past video end / wrong cue | W4 composer — frame literals used instead of cue-relative |
| Two marks overlap, or a mark covers the glyph it annotates | W4 composer/sketch — anchor geometry wrong (park the mark in the clear gap; not a frame-literal issue) |
| Duplicate / "twin" components stacked (e.g. a migrated glyph and its destination both rendered) | W4 composer — handoff visibility window + landing position (source must fade before/as destination lands) |
| Primitives crammed / overlapping with no gap inside one zone | W2 visual-design (multiplicity doesn't fit the canvas) + W4 composer (compute pitch ≥ size + gap) |
| Number / label overflows its card / wrapper (no padding) | W3 primitive — glyph inset on the wrapper (e.g. NumberCard) |
| Audio jumps straight to the next sentence / no breath at a cue boundary | W3 voice generation — enforce a min inter-cue silence in voice.json / generate-voice |
| Voice spoke wrong / truncated narration | W3 voice — re-prompt with audio-captions ASR-flag fix |
| Voice rushes / pacing mismatched to motion | Wave-order failure — composer ran before voice + ASR existed; check Wave 3 happened |
| Voice ends mid-video / picture static after audio ends / captions linger past audio | Padded-hold regression — <X>LessonTimeline.ts re-introduced PADDED_CUE_DURATIONS_FRAMES or similar. Per docs/pipeline-architecture.md, the timeline must be the Wave 3.5 reconciled cues only. Fix: re-run Wave 3.5, ensure timeline file exports the reconciled cues directly. |
| Audio cue N plays while visual still shows cue N-1 | Same root cause as above — visual+caption on a padded timeline, audio on raw. Fix at Wave 3.5; no recomposition needed. |
| Broken shape, layout, scene mount | W4 composer or W3 primitive build |
| Voice tone / language | pipeline.json voice config |
| Render artifact | render step — inspect ffprobe, re-run |
--skip-voice.--skip-voice on the existing scene (or re-spawn composer if cue lengths shifted significantly).--skip-voice.After ANY voice re-run, the orchestrator personally reads:
lesson-data/<id>/gemini-voice.json → transcriptText and script (compare line by line)src/lessons/generated/<camelId>Timing.ts → matchScore, asrText per cueFor each cue, confirm:
If any cue fails, fix the upstream input (often a rewording per audio-captions §ASR concerns) and re-run voice. Do NOT proceed to composer with bad audio.
Show the proposal in plain text and wait for approval before:
Spec edits inside existing skills do not need approval.
Verify the fix against the user's original report before declaring done. If a recurring pattern emerges across feedback, propose a CLAUDE.md update.
docs/pipeline-architecture.md v1.npm run lesson:check reported collisionCount 0 even with visible overlaps because it only checked zone-pair allow rules and treated same-zone (a===b) overlaps as always-allowed — letting overlapping marks, crammed column diagrams, twin/duplicate cards, and a mark-over-glyph all pass. Fix: the gate is now element-pair aware — at every keyFrame it compares each pair of distinct mounted elements and flags intersectArea / min(bboxArea) > 0.15 unless the zone pair is in ALLOWED_OVERLAPS; the blanket same-zone exemption was removed (only decoration:decoration and any caption pair stay exempt). scripts/lesson-manifest.mjs + src/lessons/manifestTypes.ts.Viewer-first discipline for early-childhood Remotion lesson scenes. Before any choreography or JSX, the subagent must inhabit the kid's eye — measure how the smallest teaching mark and the smallest label actually render at the composition size, declare disjoint visual zones, refuse decoration. Pairs with visual-discipline (contract mechanics) and early-childhood-visual-taste (color/tone).
Use when writing per-cue teacher narration and captions for a Remotion lesson. The narration is COMMENTARY ON THE VISUAL — Wave 2a's per-cue motion budget is the input, and you write narration to fit each cue's budget. No invented hold timings.
Concrete visual discipline for Remotion lesson scenes — Visual Contract before choreography, one-metaphor rule, container earns existence, occupancy budget, semantic groups dominate visual groups, render-and-self-critique loop, iteration economy. Pairs with kids-eye (viewer-first) and early-childhood-visual-taste (color/tone).
Compose the Remotion lesson scene from approved upstream artifacts (Visual Contract, audio-captions intent, ASR-aligned cue boundaries, sketch-overlay schedule). Wave 4 of the lesson pipeline. NEVER hardcodes frame numbers; every timing derives from cue boundaries.
Visual taste — palette, tone, motion vocabulary — for early-childhood Remotion math lessons. Companion to kids-eye (viewer-first) and visual-discipline (Contract mechanics). Use during Wave 2 visual-design to set the lesson's visual language AFTER the kids-eye measurement block and BEFORE the Visual Contract.
Specify teacher-mark overlays (Excalidraw-style hand-drawn ink) for a Remotion lesson scene. Wave 4 (parallel with composer). Marks are specified in CUE-RELATIVE frames, never master-timeline absolutes. Restraint is the rule.