Blueprint — Construction Plan Generator

Turn a one-line objective into a step-by-step plan any coding agent can execute cold.

Overview

Blueprint is for multi-session, multi-agent engineering projects where each step must be independently executable by a fresh agent that has never seen the conversation history. Install it once, invoke it with /blueprint <project> <objective>.

When to Use This Skill

Use when the task requires multiple PRs or sessions
Use when multiple agents or team members need to share execution
Use when you want adversarial review of the plan before execution
Use when parallel step detection and dependency graphs matter

How It Works

Research — Scans the codebase, reads project memory, runs pre-flight checks
Design — Breaks the objective into one-PR-sized steps, identifies parallelism, assigns model tiers
Draft — Generates the plan from a structured template with branch workflow rules, CI policy, and rollback strategies inline
Review — Delegates adversarial review to a strongest-model sub-agent (falls back to default model if unavailable)
Register — Saves the plan and updates project memory

Examples

Example 1: Database migration

/blueprint myapp "migrate database to PostgreSQL"

Example 2: Plugin extraction

/blueprint antbot "extract providers into plugins"

Best Practices

✅ Use for tasks requiring 3+ PRs or multiple sessions
✅ Let Blueprint auto-detect git/gh availability — it degrades gracefully
❌ Don't invoke for tasks completable in a single PR
❌ Don't invoke when the user says "just do it"

Key Differentiators

Cold-start execution: Every step has a self-contained context brief
Adversarial review gate: Strongest-model review before execution
Zero runtime risk: Pure markdown — no hooks, no scripts, no executable code
Plan mutation protocol: Steps can be split, inserted, skipped with audit trail

Installation

mkdir -p ~/.claude/skills
git clone https://github.com/antbotlab/blueprint.git ~/.claude/skills/blueprint

blueprint