Agent skill · affaan-m
blueprint
Turn a one-line objective into a step-by-step construction plan for multi-session, multi-agent engineering projects: one-PR-sized steps with self-contained context briefs, dependency graph with parallel-step detection, adversarial review gate, and plan mutation protocol. Use when planning a large feature, refactor, or roadmap that spans multiple PRs or sessions; not for single-PR tasks or when the user says \"just do it\".
What it needs
About 3k tokens when loaded.
What this skill does
Blueprint — Construction Plan Generator Turn a one-line objective into a step-by-step construction plan that any coding agent can execute cold. When to Use Breaking a large feature into multiple PRs with clear dependency order Planning a refactor or migration that spans multiple sessions Coordinating parallel workstreams across sub-agents Any task where context loss between sessions would cause rework Do not use for tasks completable in a single PR, fewer than 3 tool calls, or when the user says "just do it." How It Works Blueprint runs a 5-phase pipeline: 1. Research — Pre-flight checks (git, gh auth, remote, default branch), then reads project structure, existing plans, and memory files to gather context. 2. Design — Breaks the objective into one-PR-sized steps (3–12 typical). Assigns dependency edges, parallel/serial ordering, model tier (strongest vs default), and rollback strategy per step. 3. Draft — Writes a self-contained Markdown plan file to plans/. Every step includes a context brief, task list, verification commands, and exit criteria — so a fresh agent can execute any step without reading prior steps. 4. Review — Delegates adversarial review to a strongest-model sub-agent (e.g., Opus) against a checklist and anti-pattern catalog. Fixes all critical findings before finalizing. 5. Register — Saves the plan, updates memory index, and presents the step count and parallelism summary to the user. Blueprint detects git/gh availability automatically. With git + GitHub CLI, it generates full branch/PR/CI workflow plans. Without them, it switches to direct mode (edit-in-place, no branches). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills affaan-m/blueprint--c37b27