# Skill: prompt-forge — Pre-flight team for H/BLOCKER tasks

# Skill: prompt-forge — Pre-flight team for H/BLOCKER tasks

**Skill path:** `~/.claude/skills/prompt-forge/`

## Description

Pre-flight team meta-design for H/BLOCKER MC tasks. Spawns 5 specialist agents (petter-graff + devils-advocate + anthropic-chief-architect + openai-chief-architect + chip-huyen) in parallel. Synthesizer (petter-graff in 2nd role) combines into unified prompt with preserved `<disagreements>` XML field.

**Output:** `~/system/prompts/forged/<mc_id>.md`

**Trigger:** `/prompt-forge <mc_id>`

## When to Use

Run prompt-forge when **ALL** of the following apply:

- Priority = **H**
- AND: **BLOCKER** label OR effort estimate ≥ M OR 3+ acceptance criteria OR multi-component

**Skip prompt-forge** (go directly to /mehanik) when **ANY** of:

- Priority = M or L
- BLOCKER but trivial scope (single-file edit, single-line config, runbook execution)
- Recurring template task (deploy step, cert renewal, credential rotation)
- Effort estimate = S

## Workflow

1. **Preconditions:** Verify MC task exists, status is open/in\_progress, scope gate passes
2. **Parallel dispatch:** Spawn all 5 panelists simultaneously (Sonnet × 4, Opus × 1)
3. **Synthesis:** Petter Graff in synthesis role combines outputs into unified prompt
4. **Output format:** 8 sections including mandatory `<disagreements>` block
5. **Next step:** Feed forged prompt into `/mehanik`

## Cost and Scope Gates

- **Hard cap:** $1.00 per invocation
- **Daily budget:** $5.00 (≈ 5 BLOCKER tasks/day maximum)
- **Typical cost:** $0.34 warm cache / $0.95 cold
- **Model tiering:** Sonnet × 4 panelists + Opus × 2 (Anthropic CA panelist + synthesis)

## Output Format (8 sections)

The forged prompt at `~/system/prompts/forged/<mc_id>.md` contains:

1. OBJECTIVE — Single paragraph: what and why
2. CONTEXT FILES — Explicit list with absolute paths
3. DELIVERABLES — Numbered artifacts with acceptance signals
4. CONSTRAINTS — Hard limits (what NOT to do)
5. SUCCESS CRITERIA — Machine-verifiable checklist
6. AGENT ROUTING — Which specialist handles this
7. **&lt;disagreements&gt;** — Raw panelist conflicts, unsmoothed
8. FOOTER — Synthesis flag, cost estimate, next step

## v0.1 Deferred (post-Akershus 2026-05-04)

- Eval harness: 20-task golden dataset replay
- Complexity classifier: automated scope gate
- cost-tracker.js integration
- Observability: per-panelist latency, token counts
- BFPR ship gate: ≥70% Builder First-Pass Rate over first 20 uses

## References

- **Local SKILL.md:** `~/.claude/skills/prompt-forge/SKILL.md`
- **Agent briefs:** `~/.claude/skills/prompt-forge/references/agent-briefs.md`
- **Full spec:** `/tmp/std1-synthesis.md`
- **Related:** ZAKON #25 (john-operating-system.md line 77)

---

*Author: ALAI, 2026*

*Last updated: 2026-04-28*