Blueprint
antbotlab/blueprintBlueprint генерирует пошаговые Markdown-планы из одной строки задачи. Каждый шаг самодостаточен: агент выполняет его без контекста предыдущих сессий. Подходит для рефакторинга, миграций и многоэтапных задач.
Установка
git clone https://github.com/antbotlab/blueprint.gitREADME
[!TIP] Любой агент может следовать плану. Сложность — писать шаги, которые не предполагают, что агент читал предыдущие. Blueprint генерирует планы из одной строки цели — каждый шаг несёт достаточно контекста для холодного старта в отдельной сессии другим агентом.
Создан для разработчиков, работающих над проектами, которые слишком велики для одной агентской сессии: многоэтапный рефакторинг, извлечение плагинов, миграция архитектуры, поэтапный выкат фич. Сгенерированные планы — обычные Markdown-файлы, которые любой агент может прочитать и выполнить.
Что вы получаете
Markdown-файл плана, спроектированный так, чтобы свежий агент в новой сессии мог взять любой шаг и выполнить его, не читая остальной план:
- Шаги — каждый размером в один PR, со списком задач, стратегией отката, командами верификации и критериями завершения
- Граф зависимостей — какие шаги можно выполнять параллельно, какие — строго последовательно
- Проектные решения — обоснование ключевых выборов, зафиксированное от повторного обсуждения
- Инварианты — свойства, проверяемые после каждого шага (сборка проходит, регрессий нет)
- Журнал прогресса — единый источник истины о состоянии выполнения между сессиями
- Журнал ревью — результаты независимой проверки плана на пробелы и недостатки
### Step 04: Redirect core scheduler calls through plugin registry [x]
**Branch**: `taskflow-step-04-redirect-calls`
**Size**: M
**Isolation**: worktree
**Agent**: strongest
**Context** (cold-start brief):
The core currently calls the scheduler directly via
`import { Scheduler } from './scheduler/index.js'` in 3 files.
The plugin registry now has a `scheduler` slot with `getScheduler()`.
This step replaces all direct imports with registry calls — the critical
bridge that decouples core from the scheduler implementation.
**Tasks**:
1. [guided] Find all files importing from `./scheduler/`
2. [guided] Replace direct imports with `getScheduler()` + descriptive error
3. [guided] Update bootstrap to warn if no scheduler is registered
4. [guided] Update tests to register a mock scheduler in beforeEach
5. [exact] Run: `pnpm -r build && pnpm -r test && pnpm -r typecheck`
**Rollback**: Discard worktree. Main tree is unaffected.
**Verification**:
- [ ] `pnpm -r build && pnpm -r test` — all tests pass
- [ ] `grep -r "from.*scheduler" packages/core/src/ | wc -l` — returns 0
**Exit criteria**: No file in core directly imports from `./scheduler/`.
All tests pass with mock scheduler registration.Поле Context — ключевое: оно сообщает агенту с холодным стартом точное состояние кодовой базы и суть шага без чтения предыдущих. Маркеры задач: [exact] = выполнить команду дословно; [guided] = агент выбирает подход; [open] = только цель, полная автономия.
Step 01 (interface)
├──→ Step 02 (registry slot)
│ └──→ Step 04 (redirect calls) ──→ Step 05a (move files)
│ └──→ Step 05b (tests)
└──→ Step 03 (package scaffold) ──────────────→ Step 05a
Parallelizable:
Group A (after Step 01): Step 02 and Step 03 — no shared files
Полные примеры: small-plan.md (3 шага, прямой воркфлоу) · large-plan.md (9 шагов, ветковый воркфлоу с разбивкой шагов)
Установка
Claude Code
mkdir -p ~/.claude/skills
git clone https://github.com/antbotlab/blueprint.git ~/.claude/skills/blueprintClaude Code обнаруживает скилл автоматически — /blueprint готов к использованию.
Другие агенты
Сгенерированные планы — стандартные Markdown-файлы. Любой агент, умеющий читать файлы, может выполнить Blueprint-план. Укажите агенту SKILL.md как системный промпт или файл инструкций — и он будет знать, как генерировать и выполнять планы.
Требования
Claude Code для slash-команды /blueprint. Git и GitHub CLI открывают полный воркфлоу с ветками/PR/CI, но Blueprint работает и без них — при их отсутствии автоматически переключается в прямой режим.
Быстрый старт
/blueprint myapp "migrate database to PostgreSQL"
Команда сканирует кодовую базу, проектирует пошаговый план, проверяет его sub-агентом на самой мощной модели (при недоступности — откат на модель по умолчанию) и сохраняет в plans/myapp-migrate-database-to-postgresql.md.
Ключевые возможности
Холодный старт — каждый шаг содержит самодостаточный контекстный брифинг. Свежий агент в новой сессии выполняет любой шаг без чтения предыдущих шагов или истории диалога.
Возобновление между сессиями — планы отслеживают состояние выполнения в журнале прогресса. Новая сессия читает журнал, проверяет состояние веток/файлов и продолжает ровно с того места, где остановилась предыдущая.
Живые документы — планы изменяются в процессе выполнения. Шаги можно разбивать, вставлять, пропускать, переупорядочивать или отменять — всё с формальными протоколами и журналом аудита.
Состязательное ревью — каждый план проверяется sub-агентом на самой мощной модели (например, Opus) по чеклисту: полнота, корректность зависимостей, жизнеспособность холодного старта, обнаружение антипаттернов и другое. При недоступности мощной модели — откат на модель по умолчанию.
Обнаружение параллельных шагов — граф зависимостей выявляет шаги без общих файлов или выходных зависимостей, чтобы их можно было выполнять одновременно.
Деградация без отказа — мощная модель недоступна? Откат на модель по умолчанию. Нет GitHub CLI? Переключение в прямой режим. Нет памяти проекта? Опора на сканирование кодовой базы. Blueprint адаптируется вместо того, чтобы падать с ошибкой.
Сравнение
Встроенная команда /plan в Claude Code хорошо работает для простых задач. Blueprint предназначен для многоэтапных задач, которые выходят за рамки одной сессии и требуют координации между агентами, сессиями и ветками.