The last authoring step before a pixel ever gets baked. Given ONE upstream-approved panel_spec and its\nstatus: locked blueprint, this skill COMPILES — it does not brainstorm — the exact message\ncomic-director (Phase 2/3) will hand to the agent mcp__codex__codex sidecar\nbake (Codex's native image tool), plus the locked identity-ref list. It is the comic twin of the framework's\nshot-prompt-builder: a pure Layer-3 transform\nwith no Codex call in the happy path — it only emits a prompt_bundle; the spiral engine submits it.\nEverything the generation backend ever sees passes through here, so this is where the 搬运工原則 is\nenforced at emit time: the bake backend (Codex's native image-generation tool; the underlying image model is\nnot pinned or attested by this repo) owns optics; ART_BIBLE.md owns style; no camera /\nlens / lighting / \"8K hyperrealistic cinematic\" padding leaks into the bake, and no bubble text gets\nbaked unless the panel is explicitly text_mode: \"baked\". The author (storyboard/blueprint layers) decides\nwhat; this skill decides nothing — it transcribes a locked spec into a backend-legal string and FAILS\n(it never papers over) when the spec is malformed.
panel_spec (status:locked) ─▶ ① RESOLVE — load panel_spec + its blueprint + ART_BIBLE style_prefix\n + blueprint (status:locked) enforce 4 prerequisites (node_type, blueprint status:locked, REAL refs, style_prefix resolves)\n ▼\n ② COMPOSE — fixed-section condition_string (order is load-bearing, do NOT refactor)\n ▼ style_prefix + [BAKED DIALOGUE only if text_mode==baked] + SCENE + FIXED ELEMENTS\n ▼ + ALLOWED CHANGE vs prior panel + FORBIDDEN + SCREEN-TEXT WHITELIST(expected_literals)\n ▼\n ②·5 INJECT (retry only) — active failure_mode positive-invariants to the FRONT\n ▼\n ③ VALIDATE — banned-vocab + length + no-baked-bubbles + real-refs on the COMPOSED string\n ▼ (the hard gate — ANY hit = fail-closed, push the fix UPSTREAM)\n ▼\n ④ EMIT — write the prompt_bundle node; route html_bubbles[] to the JSON viewer ONLY\n ▼\n pass? ─ no ─▶ exit 4 (banned/length) | exit 7 (failure_mode trigger still fires) | exit 3 (prereq)\n │ yes\n ▼\n ⑤ stdout one-line JSON {prompt_bundle_id, panel_id, source_blueprint_id}\nYou are a fail-closed transcriber, not an author. You take a panel_spec that an upstream layer already\ngate-approved and its blueprint that the cross-layer gate already flipped to status: locked, and you\nproduce the single exact composed_prompt (style_prefix + a fixed-section condition string) + the locked\nidentity-ref paths that the spiral engine will bake — together with the deterministic proof (a clean\nbanned_vocab_scan) that the message is backend-legal. You never invent a scene element, a number, a cast\nmember, or a style adjective; you never silently fix a malformed spec (you FAIL and point upstream); and\nyou never call Codex on the happy path (a Codex call only ever appears as a reported upstream bug). The\ncross-model judgement of the baked pixels is not yours — that lives downstream in comic-director's\npanel_gate; keeping you deterministic is what stops the executor from self-acquitting.
schemas/node_schema.json)panel_spec (node prefix panel:) — payload fields used: source_storyboard_id, page_id,\npanel_id, sequence_index, page_type, world, asset_ids[], text_mode, expected_literals[],\ncontent_blueprint, bubbles[], side_narration, motifs. The panel_spec must be its layer's\ngate-approved output (status: locked), not a draft.blueprint (node prefix blueprint:, found via the panel's content_blueprint) —\npayload fields used (the schema's 9 blueprint required fields, verbatim from validate_wiki.py\nPAYLOAD_REQUIRED): source_panel_id, content_svg, expected_literals[], safe_zones[],\nhtml_bubbles[], crop, negative_space_policy, generator_script, file_sha256. Refuse unless\nthe blueprint is status: locked — that is the schema signal that the cross-layer gate signed off (the\ngate's ⑥ FLIP writes status → locked on advance; comic-blueprint-author emits blueprints at\nstatus: locked). The blueprint node has NO review_status field (only the asset node does, and\n\"approved\" is not even a legal status enum value) — never gate on review_status here. html_bubbles[]\nis the JSON viewer-overlay payload — it is routed to the viewer, NEVER concatenated into the bake string.prompt_bundle (node prefix prompt:, node_id a lowercase [a-z0-9_-]+ slug of the\npanel_id) — payload required by the schema (the 6 prompt_bundle PAYLOAD_REQUIRED fields, verbatim):\nsource_panel_id, source_blueprint_id, style_prefix, composed_prompt, banned_vocab_scan,\nidentity_ref_paths. Status canon: author draft/pending → under_review → locked on a clean\nvalidate (or rejected). Write LEGAL edges (every type ∈ validate_wiki.py EDGE_TYPES):\nderived_from (prompt_bundle → panel_spec) and uses_blueprint (prompt_bundle → blueprint). On retry, the\nfailure_mode trace uses a legal derived_from edge (prompt_bundle → failure_mode, with\nevidence.consulted_failure_mode + the --reason text — no match score; scoring is planned, not shipped);\nif a trigger still fires after repair, a legal failure_of\nedge (failure_mode → prompt_bundle — failure_of points failure_mode → target, matching the gate + the script,\ntrigger in evidence). There is NO generated_from /\nconsulted_failure_mode / violates_failure_mode edge type in EDGE_TYPES — those would fail the release\ngate. Emit node IDs only to stdout — the orchestrator re-reads the node file from disk (no filename guessing).These are the same two contracts comic-author authors to — this skill is where they are enforced at emit\ntime, on the resolved spec, before any credit is spent:
blueprint.payload.content_svg (top-level\non the blueprint payload — NOT nested under any condition. key; the condition.content_svg prefix exists\nONLY in the runtime comic.json the engine reads). The blueprint's content_svg is the content authority +\nthe bake's layout reference. If it is null / missing / not on disk (or its file_sha256 mismatches) →\nrefuse (exit 3). A scene-only panel still has a layout blueprint SVG; there is no such thing as a\npanel with no content_svg.baked figure-panel must declare non-empty, ascii-tokenizable expected_literals. If\ntext_mode == \"baked\" and the blueprint carries a figure but expected_literals is empty → refuse\n(exit 3). Those literals become the SCREEN-TEXT WHITELIST block (below) and are exactly what\npanel_gate's blind token-diff later verifies. A scene panel with no audited numbers must be\ntext_mode: \"html\" (dialogue is an HTML overlay, no baked-literal contract).The shipped entrypoint (do NOT hand-roll the validator):
\npython3 skills/comic-panel-prompt-builder/scripts/build_prompt.py <project_dir> <panel_id|panel:slug> \\\n [--retry --reason \"<text>\"]\nscripts/build_prompt.py IS this procedure made executable — it reads the panel_spec + blueprint nodes\nfrom <project_dir>/wiki/nodes/, resolves the identity lock + refs, composes the fixed-section message, and\ncalls the single canonical scripts/_validate.py (which owns MAX_MESSAGE_CHARS = 4000, the ~80-pattern\nBANNED_VOCAB, no_baked_bubbles, real_refs — imported, never duplicated). It writes the trace files\nwiki/prompt_build/<panel_slug>/{_resolved.json,_meta.json,_validation.json} and, on a clean validate, the\nprompt_bundle node + its legal edges. --retry REQUIRES --reason (exit 2 otherwise) — a retry must\nname the active failure it is repairing. Run python3 scripts/_validate.py --composed <f> --text-mode <m> --bubbles ... --refs ... standalone for a quick re-check of an already-composed message.
$2 (the panel_id or panel:slug node_id); make\nwiki/prompt_build/<panel_slug>/. --retry without --reason → exit 2. The emitted node_id is\nprompt:<lowercase-slug-of-panel_id> (the schema node_id pattern is [a-z0-9_-]+; the display\npanel_id may carry case). Never guess output filenames._resolved.json: the panel_spec node; its blueprint node (via panel_spec.payload.content_blueprint);\nand the style_prefix from ART_BIBLE.md (the world-keyed STYLE_PREFIX[<world>]: line — §0 register +\n§0.5 two-world palette). Enforce:\nnode_type == \"panel_spec\" and status == \"locked\" — else exit 2 (input missing/malformed).blueprint.status == \"locked\" — the schema signal that the cross-layer gate signed\noff (the gate's ⑥ FLIP writes status → locked). The blueprint node has no review_status field;\ngating on review_status == \"approved\" is unreachable (not even a legal status value) → never do it.\nOptionally also assert the legal decision node / decides edge for this blueprint exists as gate proof.\nElse exit 3.blueprint.payload.content_svg exists on\ndisk (and file_sha256 matches), and each identity ref — resolved by following\npanel_spec.payload.asset_ids[] to its identity-sheet asset node (the asset must be status: locked,\nand publishes a real .png via its ref_requirements) — is a real .png (NOT pending:*, NOT null\nwhere one is required). A null ref is allowed ONLY as the documented \"use project canonical\" fallback;\nan unresolved pending:* → exit 3.style_prefix resolves and is sane: ≤ 200 chars (hard), ≤ 32 words (warn). Else exit 3.\nAlso resolve asset names (scene/prop/identity asset_ids[] → display names) for the whitelist/reviewer\ncontext only — names go in the whitelist, raw IDs never go in the prompt.ART_BIBLE.md: tone + two-world palette + texture, world-keyed by\npanel_spec.world (e.g. warm / seam / dark-cyber / starfield). NO camera/lens/lighting/quality\nvocab.text_mode == \"baked\" lift the panel's bubbles[] text into the\nprompt (so the image model draws legible balloons). If text_mode == \"html\" (or code): SKIP this\nblock entirely — the bubbles are the viewer's job (see Phase 4). This is the single switch that decides\nbaked-vs-overlay text.blueprint.payload.content_svg\nlayout (the content blueprint already lays out the scene) summarized with the panel's\npanel_spec.payload.side_narration. There is NO condition.scene / condition.characters /\nchibi_action on the panel_spec node — those keys live ONLY in the runtime comic.json (do not read\nthem off the node). The world's warm/cold contrast is by design, not drift.panel_spec.payload.asset_ids[] to each identity-sheet asset node and reading its\nasset.payload.identity_lock (the canonical-cast hex/beard/silhouette lock — there is NO\nidentity_desc field on the panel_spec node; the node-model identity authority is the asset's\nidentity_lock) + the locked props the motif ledger pins for this panel.motifs delta (the comic reinterpretation\nof \"ALLOWED MOTION\": what may legitimately differ from the previous panel).[\"no new character entering frame\", \"no off-model drift\", \"no scene/world recolor\"] + any panel-specific must_not_add.expected_literals[] from the\nblueprint (e.g. [\"REJECT\",\"37\",\"T-16:05\"]) + any baked-in signage/label names. Even when HTML owns the\nbubbles, baked-in figure text (chips, stamps, code) still needs char-exact preservation — this whitelist\nis the upstream of panel_gate's literal diff.\nWrite _meta.json (character/element counts) for the trace.build_prompt.py does — mirror it exactly, do not hand-roll a richer version. On\n--retry, collect ALL ACTIVE failure_mode nodes (payload.active == true) project-wide — there\nis NO layer or panel scoping in the shipped code. Sort them by payload.severity DESC (default 3 —\nseverity ONLY, no recency term), take the top 10, and for each mode whose\nencoding_style == \"positive_invariant\" inject its repair_pattern UNCONDITIONALLY (no semantic\nmatching against the composed string) — non-positive_invariant modes are skipped here (negatives like \"no\nmissing ears\" make diffusion fixate on the negated concept). The injected patterns form one\n\"POSITIVE INVARIANTS (must be present in every panel, highest priority):\" block at the FRONT of the\nmessage. Record the consult as a legal derived_from edge (prompt_bundle → the consulted failure_mode)\nwith evidence.consulted_failure_mode: true + the --reason text (there is no consulted_failure_mode\nedge type). This is exactly the --reason a retry must name.\n(ASPIRATIONAL — planned, NOT yet implemented; do not describe as current behavior: scoping by the schema's\nlayer field (∈ {prompt_pattern, visual_transition, global} — the field is layer, there is no\ntarget_layer in the schema), recency*severity ranking (recency = 1.0/age_days), a\nsemantic_signature weighted-Jaccard match (0.35*assets + 0.25*cterms + 0.20*kw + 0.20*frags, threshold\n0.55), and a match score on the edge. The shipped injector is the severity-top-10 unconditional inject\nabove.)trigger_patterns of EVERY active failure_mode (not just injected ones). In the shipped script, trigger\nmatching gates ONLY the exit-7 path: if a trigger of a non-positive_invariant mode still matches,\nit persists the bundle as status: \"rejected\" FIRST (so the edge endpoint resolves), writes a legal\nfailure_of edge (failure_mode → prompt_bundle — failure_of points failure_mode → target, the trigger\nin evidence; there is no violates_failure_mode edge type) and exits 7 (a regenerate signal to the\norchestrator). A matched positive_invariant mode never exit-7s and there is NO append-in-place repair\nbranch — its repair_pattern was already injected in Phase 1·5 iff it made the severity top-10.scripts/_validate.py (the single source): passes_all = length_ok AND no_banned_vocab AND no_baked_bubbles AND real_refs_ok. ANY failure → preserve _validation.json, set the panel's\nreview_gates.storyboard_json_gate = \"fail\", and exit 4 — see the EXACT gate below. Do NOT silently\nadd quotes / fix the spec — a malformed spec FAILS validation so the fix is pushed back to the authoring\nlayer.prompt_bundle node (payload = the schema's 6 required fields exactly:\n{source_panel_id, source_blueprint_id, style_prefix, composed_prompt, banned_vocab_scan, identity_ref_paths}); set its status locked. Write the LEGAL edges (every type ∈ EDGE_TYPES):\nderived_from (prompt_bundle → panel_spec) and uses_blueprint (prompt_bundle → blueprint) — NOT\ngenerated_from (illegal, fails the release gate). Route html_bubbles[] to the JSON viewer overlay\nonly — they are NOT in composed_prompt. Append a timeline entry to wiki/log.md.{\"prompt_bundle_id\":\"prompt:...\",\"panel_id\":\"...\", \"source_blueprint_id\":\"blueprint:...\"} — the canonical orchestrator input. Set\npanel_spec.review_gates.storyboard_json_gate = \"pass\".This is a transform, so there is NO cross-model / scored gate here (that lives downstream in\ncomic-director's panel_gate). The gate is a deterministic contract/banned-vocab validator on the\nCOMPOSED message — ported verbatim from shot-prompt-builder / segment-intent-builder. Each dimension\nis binary; ANY hit is a hard fail (no single-vote averaging — this is detect-only).
length_ok — len(composed_prompt) ≤ MAX_MESSAGE_CHARS = 4000 (~600 words, the empirical backend\ntolerance). Over cap → fail.no_banned_vocab — the 搬运工 v2 validator: ~80 case-insensitive, word-boundary patterns the backend's\nown agents own. Veto = any single hit fails the whole message. The list below is the human-readable map;\nthe single source of truth is scripts/_validate.py's BANNED_VOCAB (imported by build_prompt.py, so\nthe list never forks). Categories:\n\\b8K\\b, \\b4K\\b, hyperrealistic, photorealistic, ultra-realistic, cinematic,\nprofessional, award-winning, masterpiece, high/best quality, highly detailed, intricate details,\ntrending on artstation.the camera, camera moves/pans/tilts/zooms/tracks/pushes/pulls/cranes,\nwide/close-up/medium/long/establishing/POV shot, over-the-shoulder, dolly, tilt, pan, crane,\ndrone, aerial, orbital, whip-pan, tracking shot, push-in, pull out, zoom, rack focus,\nfocus pull, jib, steadicam, handheld.\\d{2,3}mm, f/\\d, bokeh, depth of field, shallow DOF, DOF, lens, wide-angle,\ntelephoto, anamorphic, lens flare.lighting, rim/key/fill light, three-point lighting, golden hour, blue hour,\nstudio lighting, soft/hard light, low-key, volumetric, god rays, chiaroscuro.Unreal Engine, Octane, V-Ray, Blender, Midjourney, Stable Diffusion, Sora,\nRunway, Pika.epic, breathtaking, stunning, gorgeous, mesmerizing, otherworldly,\nsurreal masterpiece.no_baked_bubbles (comic-specific veto) — if text_mode != \"baked\" and any of the panel's\nhtml_bubbles[] / bubbles[] quoted dialogue text appears in composed_prompt → fail. HTML owns the\nbubbles; baking them is the exact drift this gate exists to catch. (When text_mode == \"baked\" the dialogue\nis allowed in the BAKED DIALOGUE block by design — this veto fires only for html/code panels.)real_refs_ok (single-source ref veto) — identity_ref_paths[] must be REAL locked .png paths, and\nthe ref set is exact: no silent concatenation of extra identity IDs, no pending:*, no raw asset_id\nstrings smuggled into the prose. (Single-source discipline — the ref-count linchpin; concatenating refs\nsilently is forbidden.)Exit-code contract (= the verdict surface; scripts/build_prompt.py returns these EXACT numeric codes):\n0 validated + emitted + gate pass · 2 input missing / malformed CLI (--retry w/o --reason; panel_spec\nnot node_type panel_spec or not status: locked) · 3 upstream prereq unmet (blueprint not\nstatus: locked / ref not real / content_svg missing / expected_literals missing on a baked\nfigure-panel / style_prefix bad / failure_mode query failed) · 4 banned-vocab | length | baked-bubble | ref\nfail (gate → fail, _validation.json preserved) · 7 Phase 1·6 regenerate (a non-positive_invariant\nmode's trigger_pattern still matches after repair; the bundle is persisted status: \"rejected\" and a legal\nfailure_of edge written).
The reference movie's per-panel condition blocks —\n../../examples/comic_m3_audit/comic.json — are the\ncompiled-artifact (comic.json runtime) OUTPUT shape this skill produces (the spiral engine inlines exactly\nthese condition.* keys). They are NOT the node fields this skill reads — those are the flat panel_spec /\nblueprint / asset node payloads (the condition. prefix exists only in comic.json). Copy these output\npatterns, but source each from its node field as noted:
S11 (the REJECT verdict). Compiled output (comic.json):\ncondition.content_svg: \"assets/reject_verdict_round1_v1.svg\", text_mode: \"baked\",\ncondition.expected_literals: [\"REJECT\",\"37\",\"T-16:05\"], world: \"dark-cyber\". Node sources:\ncontent_svg ← blueprint.payload.content_svg; expected_literals ← blueprint.payload.expected_literals;\nthe identity lock ← the identity-sheet asset.payload.identity_lock reached via panel_spec.payload. asset_ids[]. The compiler emits: STYLE PREFIX (dark-cyber palette, no camera vocab) → BAKED DIALOGUE\n(because text_mode==baked: from panel_spec.payload.bubbles[], reviewer \"Rejected. Fix it, then come\nback.\" / executor \"...Copy that.\") → SCENE COMPOSITION NARRATIVE (from the blueprint.content_svg layout +\npanel_spec.side_narration: the verdict chamber + the REVIEW·ROUND 1 card) → FIXED ELEMENTS (from\nasset.identity_lock: \"blue executor brown hair NO beard / green reviewer dark hair beard\") → FORBIDDEN (no\nnew character, no off-model drift) → SCREEN-TEXT WHITELIST REJECT · 37 · T-16:05. Those three\nliterals are exactly what panel_gate blind-diffs — they MUST be present and char-exact, and this is why a\nbaked figure-panel that omits expected_literals is refused at Phase 1.condition.scene/characters\nstring (and from the node fields they were compiled from): no \"the camera pushes in\", no \"85mm\", no\n\"cinematic lighting\", no \"8K\". The author already speaks backend-legal; the validator is the second line of\ndefense that keeps it that way when a style adjective sneaks in.S22 (the constellation endcard). text_mode: \"html\", bubbles: [],\nexpected_literals: [], plus safe_zones for the HTML tagline. Here the compiler SKIPS the BAKED\nDIALOGUE block and routes nothing-text into the prompt; the scene string even hard-asserts \"NO text, NO\nglyphs anywhere in the image\". For a panel like S02 whose bubbles ARE drawn (text_mode: \"baked\",\nbubbles researcher/executor/reviewer), those same bubbles would instead go in the BAKED DIALOGUE block — the\nidentical bubbles[] field is routed to the prompt or to the viewer solely by text_mode. That switch,\napplied per panel, is the whole \"no baked bubbles unless baked\" guard made concrete.S01 / S20 / S21. Each pins exactly its locked identity sheet\n(trio_identity_sheet_v001.png or researcher_chibi_canonical_ref_v001.png) as identity_ref — one exact\nref set per panel, never a silent concatenation. identity_ref_paths[] in the emitted prompt_bundle\nmirrors precisely that set.(The provenance of these panels — the debate→synthesize outline, the MOTIF STATE TABLE that pins each\nliteral, the user-approval gate — lives upstream in comic-outline-creator / comic-storyboard-creator;\nby the time a panel_spec reaches this skill it is locked, and this skill only transcribes it.)
style_prefix + condition_string deterministically — and on\nretry inject the active failure_mode repair_pattern (positive_invariant ONLY) at the FRONT.ART_BIBLE/style contamination, not just per-field text) — and FAIL closed, never paper over.html_bubbles[] to the JSON viewer overlay; the bake string carries dialogue only when\ntext_mode == \"baked\".pending:*, exit non-zero pointing upstream (creator bug vs blueprint-not-locked\nvs ART_BIBLE contamination), do NOT patch locally.ART_BIBLE owns style, and the ref set is exact.status: locked or a panel_spec that is not status: locked —\nrefuse (exit 3 / exit 2). And DON'T write an edge type outside validate_wiki.py EDGE_TYPES (no\ngenerated_from / consulted_failure_mode / violates_failure_mode — they fail the release gate).artifact-integrity — this compiler does NOT judge the panel it\nbuilds; it transcribes a locked spec and emits a deterministic banned-vocab proof. Numbers\n(expected_literals) are carried through verbatim, never originated; the pixels are judged downstream.reviewer-independence — there is no reviewer in this step (it's\na transform). The downstream judge (comic-director's panel_gate) gets the baked image + the blueprint's\nexpected_literals, never this compiler's interpretation.acceptance-gate — a clean validate here is a transform pass, not an\nacquittal: a deterministic same-model check is allowed to confirm \"the message is backend-legal\", but the\nquality/correctness verdict on the result is the cross-model panel_gate, never this skill.reviewer-routing — N/A on the happy path (no model call); if a\nblocked retry ever escalates to an external consult, Codex at xhigh (no model pin — the CLI follows the\nlocal codex config) / Gemini auto-gemini-3, never downgraded.review-tracing — every emit logs to wiki/log.md; every retry writes\na legal derived_from edge to the consulted failure_mode (consult flag + retry reason in evidence;\nno match score — Jaccard scoring is planned, not shipped), and a legal\nfailure_of edge if a trigger still fires, so the spiral memory is auditable (both edge types are in\nvalidate_wiki.py EDGE_TYPES).output-versioning — the prompt_bundle records file_sha256 of\nthe blueprint it compiled, so a re-bake traces to the exact content_svg version.