Дом
blueprint
affaan-m/ECC
Создание пошагового плана разработки на основе однострочной постановки задачи с использованием графов зависимостей, обнаружения параллельных этапов и экспертной оценки для многосессионных инженерных проектов.
...Расширить всеBlueprint — Генератор планов разработки
Превратите однострочную задачу в пошаговый план реализации, который любой программист сможет выполнить без предварительной подготовки.
Когда использовать
- Разделение крупной функции на несколько PR с четким порядком зависимостей
- Планирование рефакторинга или миграции, охватывающих несколько сессий
- Координация параллельных рабочих потоков между подчиненными агентами
- Любая задача, при которой потеря контекста между сессиями может привести к переделке
Не следует использовать для задач, которые можно выполнить в рамках одного PR, требующих менее 3 вызовов инструментов, или когда пользователь говорит: «Просто сделайте это».
Как это работает
Blueprint запускается 5-этапный конвейер:
- Исследование — предварительные проверки (git, авторизация в GitHub, удалённый репозиторий, ветка по умолчанию), затем считывает структуру проекта, существующие планы и файлы памяти для сбора контекста.
- Проектирование — разбивает задачу на этапы, подходящие для одного PR (обычно 3–12). Назначает связи зависимости, последовательность выполнения (параллельная/последовательная), уровень модели (сильный против по умолчанию) и стратегию отката для каждого этапа.
- Черновик — Создаёт автономный файл плана в формате Markdown в
plans/. Каждый этап включает краткое описание контекста, список задач, команды проверки и критерии завершения — благодаря чему новый агент может выполнить любой этап, не зная предыдущих. - Проверка — Делегирует критическую проверку субагенту с самой сильной моделью (например, Opus) на основе контрольного списка и каталога антипаттернов. Устраняет все критические проблемы перед финализацией.
- Регистрация — Сохраняет план, обновляет индекс памяти и предоставляет пользователю сводку по количеству шагов и параллелизму.
Blueprint Автоматически определяет наличие git/gh. При наличии git и GitHub CLI генерирует полные планы рабочих процессов с ветвями, PR и CI. В их отсутствие переключается в прямой режим (редактирование на месте, без ветвей).
Примеры
Базовое использование
/blueprint myapp "migrate database to PostgreSQL"
Генерирует plans/myapp-migrate-database-to-postgresql.md со следующими шагами:
- Шаг 1: Добавление драйвера PostgreSQL и конфигурации подключения
- Шаг 2: Создание скриптов миграции для каждой таблицы
- Шаг 3: Обновите уровень репозитория для использования нового драйвера
- Шаг 4: Добавьте интеграционные тесты для PostgreSQL
- Шаг 5: Удаление старого кода и конфигурации базы данных
Проект с несколькими агентами
/blueprint chatbot "extract LLM providers into a plugin system"
Создаёт план с параллельными шагами там, где это возможно (например, «реализовать плагин Anthropic» и «реализовать плагин OpenAI» выполняются параллельно после завершения этапа разработки интерфейса плагинов), назначениями на уровне модели (наиболее эффективны на этапе проектирования интерфейса, по умолчанию — на этапе реализации) и инвариантами, проверяемыми после каждого шага (например, «все существующие тесты проходят», «в ядре нет импортов провайдеров»).
Ключевые особенности
- Выполнение с «холодного старта» — каждый этап включает в себя самостоятельную краткую справку по контексту. Предварительный контекст не требуется.
- Контрольный этап с противостоящим обзором — каждый план проверяется субагентом, использующим самую мощную модель, по чек-листу, охватывающему полноту, корректность зависимостей и обнаружение антипаттернов.
- Рабочий процесс с ветвями/PR/CI — встроен в каждый этап. При отсутствии git/gh плавно переходит в прямой режим.
- Обнаружение параллельных шагов — граф зависимостей выявляет шаги, не имеющие общих файлов или зависимостей от вывода.
- Протокол изменения плана — Шаги можно разделять, вставлять, пропускать, переупорядочивать или отбрасывать с помощью формальных протоколов и журнала аудита.
- Нулевой риск во время выполнения — исключительно на основе Markdown. Весь репозиторий содержит только
.mdфайлы — никаких хуков, никаких скриптов оболочки, никакого исполняемого кода, никакихpackage.json, никаких этапов сборки. При установке или запуске ничего не запускается, кроме собственного загрузчика навыка Markdown от Claude Code.
Установка
Этот с킬 поставляется в составе Everything Claude Code. При установке ECC отдельная установка не требуется.
Полная установка ECC
Если вы работаете с чек-аутом репозитория ECC, убедитесь в наличии навыка с помощью команды:
test -f skills/blueprint/SKILL.md
Чтобы обновить позже, ознакомьтесь с diff-файлом ECC перед обновлением:
cd /path/to/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main # review new commits before updating
git checkout # pin to a specific reviewed commit
Автономная установка из вендора
Если вы используете только этот навык вне полной установки ECC, скопируйте проверенный файл из репозитория ECC в ~/.claude/skills/blueprint/SKILL.md. Копии, установленные как «vendored», не имеют удаленного репозитория git, поэтому обновляйте их, повторно скопировав файл из проверенного коммита ECC, а не запуская команду git pull.
Требования
- Claude Code (для
/blueprintкоманду со слэшем) - Git + GitHub CLI (необязательно — обеспечивает полноценный рабочий процесс с ветками/PR/CI; Blueprint определяет отсутствие и автоматически переключается в прямой режим)
Источник
Вдохновлено antbotlab/blueprint — исходным проектом и эталонной реализацией.
---
name: blueprint
description: Generate a step-by-step construction plan from a one-line objective, with dependency graphs, parallel step detection, and adversarial review for multi-session engineering projects.
---
# 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").
## 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 Everything Claude Code. 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/everything-claude-code
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.
Все файлы
1 файловУстановить blueprint
Скачайте файлы навыков и распакуйте их в каталог .claude/skills/.
Скачать ZIPКлонируйте репозиторий и скопируйте файлы навыка в свой проект.
git clone https://github.com/affaan-m/ECC/tree/main/skills/blueprint # Copy SKILL.md to your .claude/skills/ directory
Копировать
