Blueprint

Что такое Blueprint?

Blueprint — планировщик для coding-агентов. Он помогает агенту задавать правильные вопросы перед написанием кода, а затем создаёт markdown-план, который агент может выполнить за один проход.

Инструмент разработан как агент-независимый и использует планирование на основе Q&A: он исследует кодовую базу и задаёт вопросы с вариантами ответов, которые легко выбрать. Выходные данные выявляют проблемы и решения, которые вы могли упустить, в структурированном виде как повторно используемую спецификацию/план.

Ключевые возможности

• Q&A-планирование перед кодом: Blueprint замедляет выполнение ровно настолько, чтобы уточнить требования, и генерирует структурированный план.
• Исследование кодовой базы: Он читает вашу рабочую область/кодовую базу и использует этот контекст для формирования вопросов.
• Вопросы с вариантами ответов: Вопросы оформлены для быстрого ответа, но охватывают ключевые неоднозначности.
• Вывод в markdown-план: Результат — markdown-файл для прямой передачи coding-агентам.
• Агент-независимые навыки (совместимо с skills.sh): Blueprint упакован как навыки, совместимые с несколькими harness для coding-агентов.
• Встроенные шаблоны с разделами открытых вопросов: Включает шаблоны планирования по умолчанию с разделами вроде обзора, ожидаемого поведения, фаз реализации, стратегии тестирования и открытых вопросов.

Как использовать Blueprint

1. Установите навык с помощью команды npx из репозитория: npx skills add imbue-ai/blueprint.
2. Запустите сессию планирования, вызвав навык в вашем coding-агенте с кратким описанием задачи (например, /blueprint Add a caching layer to reduce API calls).
3. Выберите шаблон по запросу. Blueprint исследует кодовую базу и начинает задавать вопросы.
4. Ответьте на вопросы, пока Blueprint не решит, что почва достаточно проработана.
5. Сгенерируйте план командой /blueprint-generate. План сохраняется по пути blueprint/<slug>/plan-<slug>.md.
6. Доработайте в чате при необходимости и спросите об открытых вопросах (например, “what are the open questions?”) перед передачей плана coding-агенту.

Случаи использования

• Проекты с нуля / новые функции: Планируйте крупную новую функцию, явно охватывая требования, ожидаемое поведение и стратегию тестирования перед реализацией.
• Инкрементальные изменения, требующие координации: Когда изменение достаточно велико для тщательной спецификации (не просто быстрого правка), Blueprint структурирует решения и фазы.
• Исследования и эксперименты: Для новых моделей, систем или подсистем Q&A-поток Blueprint фиксирует предположения и неизвестные как план с открытыми вопросами.
• Работа с незнакомой кодовой базой: Blueprint исследует рабочую область и задаёт уточняющие вопросы на основе находок, снижая риск пропуска ключевых ограничений.
• Снижение ошибок выполнения в рабочих процессах агентов: Если агент иначе «бросается в код», Blueprint предоставляет явный файл плана для выполнения после фазы планирования.

FAQ

• Какие harness для coding-агентов поддерживаются? Репозиторий указывает на совместимость с harness вроде Claude Code, Codex CLI, Gemini CLI, Pi agent и другими совместимыми.

• Куда сохраняется сгенерированный план? План записывается в blueprint/<slug>/plan-<slug>.md после выполнения /blueprint-generate.

• Какие шаблоны включает Blueprint? По умолчанию поставляются два встроенных шаблона: Default (разделы: обзор, ожидаемое поведение, план/фазы реализации, стратегия тестирования, открытые вопросы) и Concise (разделы: обзор, ожидаемое поведение, изменения).

• Можно ли настроить структуру плана? Да. Репозиторий указывает, что можно описать кастомный шаблон inline по запросу, а также持久но добавлять/редактировать шаблоны через templates.json, чтобы два навыка Blueprint оставались синхронизированы.

• Blueprint ограничен фронтенд-разработкой? Руководство в README предполагает, что он менее идеален для фронтендов, где большинство решений визуальные, и лучше подходит для проектов с нуля, крупных новых функций, исследований или планирования подсистем.

Альтернативы

• Генераторы спецификаций или документов (в стиле ручного ревью): Инструменты, которые создают длинные спецификации после того, как агент сам принимает решения, отличаются от Blueprint обратным рабочим процессом — Blueprint сначала запрашивает ваши ответы через Q&A.
• Режимы «планирования» в инструментах для coding-агентов: Некоторые платформы агентов имеют свои режимы планирования; Blueprint позиционируется специально как планировщик-копилот, который генерирует markdown-план, исполняемый агентом, и задаёт короткие вопросы, ориентированные на требования.
• Универсальные ассистенты для ревью кодовой базы: Альтернативы могут суммировать или анализировать репозитории, но отличительная особенность Blueprint — структурированный markdown-план с заданными разделами и открытыми вопросами для выполнения.
• Рабочий процесс в боковой панели VS Code с расширением для планирования: Если вы предпочитаете инструменты, интегрированные в редактор, Blueprint также доступен как расширение для VS Code, работающее в VS Code, Cursor и Windsurf, что может отличаться от чисто чат-ориентированных настроек агентов.