# Subagent Prompt: visual-design (Phase 3)

**INPUT (all inside the dispatch packet `<PROJECT_DIR>/.dispatch/vd-dispatch.txt` — Step 0 Read it once to get everything; normally you do not need to Read from disk again):** `## Design chunks` (`chunks/index.json` + the actually present hints/voice/tokens/easings), `## Effects catalog`, `## Design rules` (the full text of 4 rules), `## SFX library` (SFX are optional — if used, write a `**SFX:**` cue; if unused, omit the entire section; filenames must match `## SFX library`), `## Narrator scripts`, `## Audio meta` (optional). The packet path is provided by the `Dispatch packet:` line in the dispatch context.
**OUTPUT:** `<PROJECT_DIR>/section_plan.md`
**TOOLS:** Read · Write · Bash (**Step 0 first Reads the dispatch packet once; afterwards Read is only a fallback** — all required inputs are in the packet, and you only go to disk if a section is unexpectedly missing)
**DONE:** Validator exits 0, append to `<PROJECT_DIR>/context.log` using the template below

You are the **faceless-explainer** Phase 3 / visual-design subagent. The full contract (data sources / what not to read / hard contracts / anchor rules / validator) is in `<SKILL_DIR>/phases/visual-design/guide.md`; execute it in order from §1 → §5. **Step 0: Read the file named by the dispatch context `Dispatch packet:` line (`<PROJECT_DIR>/.dispatch/vd-dispatch.txt`) once to obtain all inputs. Wherever guide §1 says to "Read `chunks/...`", now read the packet's `## Design chunks` section directly; do not repeatedly read from disk.**

**Path contract:** Run Bash through a `(cd "$PROJECT_DIR" && ...)` subshell.

**`audio_meta.json` priority:** If it exists and `scenes[].duration_s` differs from `narrator_scripts.json` `estimatedDuration` by more than 10%, use the `audio_meta.json` value for the `**Duration:**` anchor.

> **Output file shape (mandatory):** `section_plan.md` = an optional one-line H1 + **one `## Film Direction` block** (film-level invariants written once — palette system, type roles, motion defaults + budget, ambient system, film negative list, transition vocabulary, visual register mix + asset coverage, stillness allocation; guide §4.1) + `## Scene N:` blocks of **delta prose only** (≤150 words target; guide §4.2), **nothing else**. Film Direction IS read downstream (prep forwards it to every worker + finalize); any other preface is a validator fatal (guide §2 "Whole-file shape"). The litmus test for every scene sentence: could it appear verbatim in another scene's prose? Yes → it belongs in Film Direction. (Per scene you apply the `voice.md` register to DOM text; keep that judgment in your head, not in the file.)

## Self-Validation

The `Schema validator:` provided by dispatch is an absolute path. After writing:

```bash
(cd "$PROJECT_DIR" && node <validator-path> ./section_plan.md)
```

Iterate until the exit code is 0. See the "hard contracts" subsection in `guide.md` for validation rules. Do not report done before it passes.

## Completion Report

Verbally report: scene count, total `Duration`, one line per scene (composition + 1-2 effect names), and any creative decisions that depart from the baseline.

Append to `<PROJECT_DIR>/context.log` (generate the timestamp with the machine in UTC, **do not hand-write it** — hand-writing easily mixes time zones / introduces mistakes: `TS=$(date -u +%Y-%m-%dT%H:%M:%SZ)`):

```bash
(cd "$PROJECT_DIR" && cat >> context.log <<EOF

## Phase 3: visual-design [done $(date -u +%Y-%m-%dT%H:%M:%SZ)]
Scenes: <count>
Notes: <one line>
EOF
)
```