blueprint

Generates step-by-step construction plans for multi-session engineering projects.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/Femad-6/my-skills --skill blueprint-femad-6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blueprint
Source: https://github.com/Femad-6/my-skills/tree/main/.github/skills/blueprint
Command: npx skills add https://github.com/Femad-6/my-skills --skill blueprint-femad-6

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large engineering tasks like migrations and refactors lose context between sessions and agents, causing rework and broken dependencies. Blueprint turns a one-line objective into a structured, multi-step plan where every step carries a self-contained context brief that a fresh agent can execute cold. ## Core Features & Use Cases - Five-phase pipeline: Research, Design, Draft, Review, and Register phases produce a Markdown plan in plans/ with dependency edges, parallel step detection, model tier assignments, and rollback strategies per step. - Adversarial review gate: A strongest-model sub-agent reviews every plan against a checklist and anti-pattern catalog before finalization. - Plan mutation protocol: Steps can be split, inserted, skipped, reordered, or abandoned with a formal audit trail. - Use Case: Run /blueprint myapp "migrate database to PostgreSQL" to produce a plan with ordered steps covering driver setup, migration scripts, repository layer updates, integration tests, and cleanup, each with verification commands and exit criteria. ## Quick Start Ask the agent to create a blueprint plan for migrating your project database to PostgreSQL across multiple PRs.

Frequently Asked Questions about blueprint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break a large feature into multiple PRs?

Run the blueprint command with a project name and one-line objective, such as migrating a database or extracting a plugin system. It produces a Markdown plan with 3-12 one-PR-sized steps, dependency ordering, and verification commands per step.

How to plan a refactor across multiple coding sessions?

Blueprint writes each step with a self-contained context brief, task list, and exit criteria so a fresh agent can execute any step without prior context. Plans are saved to the plans directory and registered in a memory index for later sessions.

Does blueprint work without git or GitHub CLI?

Yes, blueprint detects git and gh availability automatically. Without them it switches to direct mode with edit-in-place steps and no branch or PR workflow, while keeping the same plan structure.

When should I not use a multi-step construction plan?

Skip blueprint for tasks completable in a single PR, fewer than three tool calls, or when you want immediate execution. The planning pipeline adds research and adversarial review overhead that only pays off for multi-session work.

Can blueprint coordinate parallel work across agents?

Yes, the design phase builds a dependency graph and flags steps with no shared files or output dependencies as parallel. It also assigns model tiers, using the strongest model for design-critical steps and default models for implementation.