New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Blueprint Construction Planner

by affaan-m in affaan-m/ECC

Turns a one-line objective into a multi-step plan file with PR-sized steps, context briefs, a dependency graph, parallel-step detection and an adversarial review.

MITAuto-check passedAgent Workflows

Install Blueprint Construction Planner

skills CLI
$ npx skills add affaan-m/ECC --skill blueprint -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install affaan-m/ECC blueprint --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/affaan-m/ECC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/blueprint .claude/skills/blueprint && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
blueprint
GitHub stars
277k
Used in
5 other repos
Token cost
~1.3k tokens
SKILL.md length
588 words
Files
1
Skills in repo
683
Repo updated
First seen
Licence
MIT

At a glance

Turns a one-line objective into a multi-step plan file with PR-sized steps, context briefs, a dependency graph, parallel-step detection and an adversarial review.

  • Works in 5 steps: Research — Pre-flight checks (git, gh… → Design — Breaks the objective into… → Draft — Writes a self-contained Markdown… → …
  • Breaking a large feature into several PRs with a clear dependency order
  • SKILL.md covers When to Use, How It Works, Examples and Key Features, plus 3 more sections
  • Calls git

What it does

Blueprint produces a Markdown plan that any coding agent can pick up cold for large, multi-session work. It runs five phases: research (git and GitHub CLI pre-flight checks, then reading project structure, existing plans and memory files), design (one-PR-sized steps, typically between 3 and 12, each with dependency edges, parallel or serial ordering, a model tier and a rollback strategy), draft, review and register.

Each step in the plan file under `plans/` carries a context brief, task list, verification commands and exit criteria, so a fresh agent can run it without reading earlier steps. A strongest-model sub-agent does an adversarial review against a checklist and anti-pattern catalog, and critical findings are fixed before the plan is finalized. With git and the GitHub CLI it plans a branch, PR and CI workflow, and without them it switches to a direct mode that edits in place. It is not meant for single-PR tasks or for when you say to just do it.

When your agent uses it

  • Breaking a large feature into several PRs with a clear dependency order
  • Planning a refactor or migration that spans multiple sessions
  • Splitting work across sub-agents that can run in parallel
  • Keeping context from being lost between sessions on a long project

Example prompts

  • “Plan the migration of our database to PostgreSQL as a set of PR-sized steps.”
  • “Use blueprint to break the move to a plugin system for LLM providers into parallel workstreams.”
  • “Write a construction plan for splitting the billing module out of the monolith.”

Requirements

  • Git and the GitHub CLI (optional; without them it plans in direct mode)

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Research — Pre-flight checks (git, gh auth, remote, default branch), then reads project structure, existing plans, and memory files to…
  2. Design — Breaks the objective into one-PR-sized steps (3–12 typical). Assigns dependency edges, parallel/serial ordering, model tier…
  3. Draft — Writes a self-contained Markdown plan file to plans/. Every step includes a context brief, task list, verification commands, and…
  4. Review — Delegates adversarial review to a strongest-model sub-agent (e.g., Opus) against a checklist and anti-pattern catalog. Fixes all…
  5. Register — Saves the plan, updates memory index, and presents the step count and parallelism summary to the user.

What it can do on your machine

Read from SKILL.md and the folder at commit 2d515e4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Blueprint Construction Planner loads about 1.3k tokens when it runs. Until then it costs about 109 tokens; SKILL.md has 588 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~109
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from affaan-m/ECC at commit 2d515e4, republished under its MIT licence (© affaan-m). 588 words, ~1,280 tokens.

Download SKILL.mdSave it as .claude/skills/blueprint/SKILL.md (or your agent's skills folder).
name
blueprint
description
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".
metadata.origin
community

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).

Examples

Basic usage
/blueprint myapp "migrate database to PostgreSQL"

Produces plans/myapp-migrate-database-to-postgresql.md with steps like:

  • Step 1: Add PostgreSQL driver and connection config
  • Step 2: Create migration scripts for each table
  • Step 3: Update repository layer to use new driver
  • Step 4: Add integration tests against PostgreSQL
  • Step 5: Remove old database code and config
Multi-agent project
/blueprint chatbot "extract LLM providers into a plugin system"

Produces a plan with parallel steps where possible (e.g., "implement Anthropic plugin" and "implement OpenAI plugin" run in parallel after the plugin interface step is done), model tier assignments (strongest for the interface design step, default for implementation), and invariants verified after every step (e.g., "all existing tests pass", "no provider imports in core").

Show full SKILL.md (246 more words)Show less

Key Features

  • Cold-start execution — Every step includes a self-contained context brief. No prior context needed.
  • Adversarial review gate — Every plan is reviewed by a strongest-model sub-agent against a checklist covering completeness, dependency correctness, and anti-pattern detection.
  • Branch/PR/CI workflow — Built into every step. Degrades gracefully to direct mode when git/gh is absent.
  • Parallel step detection — Dependency graph identifies steps with no shared files or output dependencies.
  • Plan mutation protocol — Steps can be split, inserted, skipped, reordered, or abandoned with formal protocols and audit trail.
  • Zero runtime risk — Pure Markdown skill. The entire repository contains only .md files — no hooks, no shell scripts, no executable code, no package.json, no build step. Nothing runs on install or invocation beyond Claude Code's native Markdown skill loader.

Installation

This skill ships with ECC. No separate installation is needed when ECC is installed.

Full ECC install

If you are working from the ECC repository checkout, verify the skill is present with:

bash
test -f skills/blueprint/SKILL.md

To update later, review the ECC diff before updating:

bash
cd /path/to/ECC
git fetch origin main
git log --oneline HEAD..origin/main       # review new commits before updating
git checkout <reviewed-full-sha>          # pin to a specific reviewed commit
Vendored standalone install

If you are vendoring only this skill outside the full ECC install, copy the reviewed file from the ECC repository into ~/.claude/skills/blueprint/SKILL.md. Vendored copies do not have a git remote, so update them by re-copying the file from a reviewed ECC commit rather than running git pull.

Requirements

  • Claude Code (for /blueprint slash command)
  • Git + GitHub CLI (optional — enables full branch/PR/CI workflow; Blueprint detects absence and auto-switches to direct mode)

Source

Inspired by antbotlab/blueprint — upstream project and reference design.

© affaan-m, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/blueprint of affaan-m/ECC.

Open the folder on GitHubat commit 2d515e4

Used in 5 other repositories

We found 11 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in affaan-m/ECC, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Blueprint Construction Planner next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Blueprint Construction Planner compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Blueprint Construction Planner this skillaffaan-m/ECC277k5 repos~1.3kAutomated safety check: PassMIT
Ask NavigatorYeachan-Heo/oh-my-claudecode40k—~4.1kAutomated safety check: PassMIT
Agtx Task Sweepfynnfluegge/agtx1.7k—~1.7kAutomated safety check: PassApache-2.0
PRP Workstream OrchestratorWirasm/prp2.3k—~3.5kAutomated safety check: PassMIT
GSD Quick Batchopen-gsd/gsd-core10k—~1.4kAutomated safety check: NotesMIT
Test-First Implementation Plangittower/git-flow-next458—~1.3kAutomated safety check: NotesCustom licence

Similar skills

  • Ask Navigator

    Yeachan-Heo/oh-my-claudecode

    Charts a foggy effort into a map of decision tickets on the repo's issue tracker and works through them one per session, producing decisions rather than deliverables.

    40k GitHub stars~4.1k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed

  • Agtx Task Sweep

    fynnfluegge/agtx

    Breaks a conversation's results into feature-level tasks and pushes them to the agtx kanban board, where each task gets its own worktree and agent session.

    1.7k GitHub stars~1.7k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed

  • PRP Workstream Orchestrator

    Wirasm/prp

    Coordinates several PRP workstreams in isolated Git worktrees from one session, verifying proof, holding merge gates and sequencing the merges.

    2.3k GitHub stars~3.5k tokensUpdated 9 days ago
    Agent WorkflowsAuto-check passed

  • GSD Quick Batch

    open-gsd/gsd-core

    Runs several small /gsd-quick tasks as one batch, with a single coordinator that plans them, dispatches workers per item and owns all shared writes and worktree merges.

    10k GitHub stars~1.4k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes

  • Test-First Implementation Plan

    gittower/git-flow-next

    Builds a two-phase implementation plan from a spec issue, analysis or concept, writing a detailed test plan first and the implementation outline second.

    458 GitHub stars~1.3k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check: notes

  • Launch Delivery Pipeline

    Yeachan-Heo/oh-my-claudecode

    Delivery pipeline from mission brief to verified change: writes a spec, splits it into tickets, runs them in parallel, verifies and reports a decision log after a repo audit gate.

    40k GitHub stars~7.3k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed

More from affaan-m/ECC

All 682 skills in this repo

  • Skill Stocktake

    affaan-m/ECC

    Audits your installed Claude skills and commands for quality, with a quick mode for recently changed skills and a full mode that evaluates all of them through subagents.

    277k GitHub starsUsed in 5 repos~3.1k tokens
    Auto-check passed

  • VideoDB Video Search and Editing

    affaan-m/ECC

    Ingests, indexes, searches, edits and monitors video, audio and live streams through the VideoDB Python SDK, returning stream links, clips and timestamps.

    277k GitHub starsUsed in 3 repos~3.5k tokens
    Auto-check: notes

  • Docs Governance

    affaan-m/ECC

    Route broad documentation-governance requests to existing ECC skills and run an opt-in, read-only audit of mapped documentation roles, links, ADR indexes, and evidence references.

    277k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Rules Distillation

    affaan-m/ECC

    Scans installed skills for principles that recur across them and proposes rule-file changes: append, revise, add a section, create a file or leave as covered.

    277k GitHub starsUsed in 2 repos~2.3k tokens
    Auto-check passed

  • Master Agreement Generator

    affaan-m/ECC

    Builds DRAFT counterparty agreements from one markdown template and a small JSON spec per party, with clauses picked by the party's role.

    277k GitHub stars~2.9k tokensUpdated today
    Auto-check passed

  • Frontend Design Direction

    affaan-m/ECC

    Set an ECC-specific frontend design direction for production UI work.

    277k GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

Works with

Categories

Questions about Blueprint Construction Planner

What does Blueprint Construction Planner do?

Turns a one-line objective into a multi-step plan file with PR-sized steps, context briefs, a dependency graph, parallel-step detection and an adversarial review. Blueprint produces a Markdown plan that any coding agent can pick up cold for large, multi-session work. It runs five phases: research (git and GitHub CLI pre-flight checks, then reading project structure, existing plans and memory files), design (one-PR-sized steps, typically between 3 and 12, each with dependency edges, parallel or serial ordering, a model tier and a rollback strategy), draft, review and register.

When should I use Blueprint Construction Planner?

Blueprint Construction Planner fits situations like: breaking a large feature into several PRs with a clear dependency order; planning a refactor or migration that spans multiple sessions; splitting work across sub-agents that can run in parallel; keeping context from being lost between sessions on a long project.

How do I install Blueprint Construction Planner in Claude Code?

Run `npx skills add affaan-m/ECC --skill blueprint -a claude-code`. Or copy the skill folder (skills/blueprint in affaan-m/ECC) into .claude/skills/blueprint in your project. Claude Code loads it when a task matches its description.

How do I install Blueprint Construction Planner in Codex?

Run `npx skills add affaan-m/ECC --skill blueprint -a codex`. Or copy the skill folder (skills/blueprint in affaan-m/ECC) into .agents/skills/blueprint in your project. Codex loads it when a task matches its description.

Can I use Blueprint Construction Planner in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add affaan-m/ECC --skill blueprint -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/blueprint, .gemini/skills/blueprint, .github/skills/blueprint and .opencode/skills/blueprint in your project.

What does Blueprint Construction Planner need to run?

Going by SKILL.md and its folder, Blueprint Construction Planner needs the command-line tools its instructions call (git). Our summary lists: Git and the GitHub CLI (optional; without them it plans in direct mode).

Does Blueprint Construction Planner access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Blueprint Construction Planner safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Blueprint Construction Planner use?

Blueprint Construction Planner is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Blueprint Construction Planner use?

About 1.3k tokens (SKILL.md is roughly 5.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Blueprint Construction Planner?

Skills that share tags, products or a category with Blueprint Construction Planner: Ask Navigator (Yeachan-Heo/oh-my-claudecode, 40k stars), Agtx Task Sweep (fynnfluegge/agtx, 1.7k stars), PRP Workstream Orchestrator (Wirasm/prp, 2.3k stars) and GSD Quick Batch (open-gsd/gsd-core, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Blueprint Construction Planner?

affaan-m (a GitHub user) maintains it in affaan-m/ECC, which has 276,673 GitHub stars. The repository holds 683 skills in this directory. The repository was last updated on October 11, 2026.

Source: affaan-m/ECC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.