comic-director

comic-director — the Audited Spiral + Release (Phase 2/3)

The middle + right of Figure 1: take an authored comic.json (produced by the comic-author skill, Phase 1) and turn it into baked frames + a clickable viewer, through the audited spiral. Per frame: render a deterministic content-SVG blueprint → bake a pixel-art frame (agent mcp__codex__codex sidecar) → a 3-reviewer cross-model panel_gate → keep / retry → page assembly → projection. The movie twin of method-figure's render half. (Image-based today; video-based is next.)

Input contract — comic.json (authored upstream)

The contract boundary is comic.json + the assets it references (content-SVG blueprints, identity refs, ART_BIBLE.md) — authored by comic-author. This skill is render + verify:

• It never invents a number or a cast — faithfulness is a deterministic token-diff over reviewers who never see the expected values; identity is judged against the ref the author supplied (cast-aware).
• It writes back only image_path / active_attempt_id / wiki_node_id (+ the wiki trace) on KEEP.
• The generator family (Codex image_gen) can NOT self-acquit. A KEEP needs the token-diff clean and the cross-model visual panel (Gemini + Codex) to pass. The calling agent (Claude) gives the final structural sign-off.

Full IR spec: ../../docs/comic-json.md / ../../schemas/comic.schema.json.

Run it (scripts/run_comic.py — agent-driven bake, CLI gates)

A pure-stdlib faithful port of packages/core/spiral_engine.js's movie branch. The cross-model gates (Gemini + Codex vision) still shell the gemini / codex CLIs directly. The BAKE is performed by the skill agent via the mcp__codex__codex MCP tool through --bake-mode=agent (the default): the core emits a deterministic bake-request sidecar (prompt + absolute ref paths + exact out_path), the agent calls mcp__codex__codex (sandbox: workspace-write, model: gpt-5.5, config: {model_reasoning_effort: xhigh, include_image_gen_tool: true}, cwd: <project>), and the core verifies the explicit out_path. (codex exec is RETIRED for real bakes — it forced a hand-drawn SVG/struct+zlib fallback; --bake-mode=exec RAISES if it ever reaches a real bake. See docs/spiral-runtime.md.)

python3 skills/comic-director/scripts/run_comic.py \
    --project examples/comic_m3_audit --page P02_b08 --panels S12,S13,S14,S15 \
    [--bake-lang zh] [--finalize] [--dry-run] [--skip-assembly] \
    [--gemini-cmd "python3 cli/gemini_agy_shim.py"] [--gemini-family google]

• --dry-run validates + prints each frame's concrete bake prompt (no image_gen) — run this first; it's also how comic-author confirms Phase 1 is correct.
• --finalize rebuilds the single-file viewer (packages/viewer/build_comic.py) only if the run is shippable (nothing escalated/throttled/flagged-for-human; assembly accepted).
• --gemini-cmd (default: the legacy gemini CLI) — the argv prefix shelled for the google-family reviewer slot (the --model auto-gemini-3 -p <prompt> tail is appended). With the legacy CLI deprecated upstream (IneligibleTierError, 2026-07), pass --gemini-cmd "python3 cli/gemini_agy_shim.py" — the shipped shim translates the old interface to Antigravity's agy and pins a Gemini model (Antigravity also serves Claude/GPT-OSS; the slot must stay google-family for cross-model quorum honesty).
• --gemini-family (default google) — the provenance family recorded in the wiki for whatever --gemini-cmd actually routes to. It must stay non-openai (the visual quorum needs a second family); record honestly, never re-label.
• Needs the codex CLI + a google-family reviewer (legacy gemini CLI, or Antigravity via --gemini-cmd + the shim) on PATH + headless Chrome (to rasterize the content-SVG blueprint). Reuses skills/method-figure/scripts/pickup_image.py.