Deliverable Builder

This skill is the conductor. It produces a finished, human-quality deliverable by running a fixed pipeline of stages — and it makes that process non-skippable, because a skipped or lazy stage shows up at Gate 2 as a requirement the artifact fails. Most stages reuse an existing skill or tool; this skill owns the sequence, the gates, and the quality bars.

Read each reference file when you reach its stage — don't load them all at once.

When to use

Any time the user asks you to produce something they'll send — a take-home, client report, one-pager, deck, proposal. Not for internal scratch notes, code (use code-voice), or content you're publishing as Genesis (use content-publish / genesis-voice).

The pipeline

Gate 2 FAIL loops back to the tagged stage (bounded: 2 cycles, then escalate). Only a PASS advances to Gate 3.

Hard rules

• No raw markdown as the final external artifact. Render to the format the audience expects (render-guide.md). Markdown is for authoring, not delivery.
• Voice and anti-slop are mandatory, not optional polish. Every external deliverable goes through voice-master and humanizer before Render.
• Lead with the strongest material. Decide what_leads at Intake; the verifier checks it.
• The spec is the state. Carry state in ~/.genesis/sessions/<session_id>/deliverable.json, not in your head — see intake.md for the schema and session-id resolution.
• Never claim done without a Gate-2 PASS. The Stop-hook enforces this; don't fight it — pass the gate or cancel the deliverable (approval-gates.md).

State machine

drafting → rendered_unverified → verified → shipped (or cancelled). The Stop-hook gate (scripts/hooks/deliverable_gate_guard.py) blocks session-end only in rendered_unverified. Set rendered_unverified right after Render, verified only after a Gate-2 PASS, shipped after Gate 3. If the user abandons it, set cancelled.

Modes

• Foreground (default): interactive Gates 1 & 3, the Gate-2 policeman, and the Stop-hook backstop. Triggered when the user asks you directly.
• Autonomous (v2): runs as a Genesis task-executor step (the decomposer assigns this skill when the task plan has a ## Deliverable Frame). Gate 1 is read from that frame — no interview; Gate 2 is still this skill's own check (run in-session — the Task tool isn't available to an executor step); Gate 3 is a Telegram approval handled by the executor (a VERIFYING-phase blocker); escalation is executor-native; the Stop-hook does NOT apply. See references/intake.md → "Autonomous mode" and references/approval-gates.md.

What this does NOT do (yet)

Real Telegram file attachment for autonomous Gate 3 (sends path + summary for now — fast-follow), and the enterprise-ai-skills / hallmark extras. One deliverable at a time. (Real .xlsx with formulas and polished .pptx decks now work when the optional OfficeCLI backend is present — see references/render-guide.md; without it the builder falls back to CSV / pandoc-basic.)

Example

User: "Turn my take-home analysis into the submission packet it should have been." You: Intake (audience = FDE hiring team; format = PDF; what_leads = the pipeline decision + benchmark results; freeze the brief's asks into AC1…ACn) → Gate 1 → Draft → Structure (answer first, methodology to appendix, action-title headings) → voice-master → humanizer → render PDF via pandoc/make-pdf → Gate 2 (fresh reviewer re-reads the original brief, byte-checks the PDF is real, per-criterion verdict) → Gate 3 sign-off → ship.