Blueprint

O que é Blueprint?

Blueprint é um copilot de planejamento para agentes de coding. Ele ajuda o agente a fazer as perguntas certas antes de escrever código e, em seguida, produz um plano em markdown que o agente pode executar em uma única passada.

A ferramenta é projetada para ser agnóstica a agentes e usa planejamento baseado em Q&A: explora um codebase e faz perguntas de múltipla escolha fáceis de responder. A saída destaca problemas e decisões que você pode não ter considerado, estruturada como uma spec/plano reutilizável.

Principais Recursos

• Planejamento Q&A antes do código: Blueprint desacelera a execução o suficiente para esclarecer requisitos e gera um plano estruturado.
• Exploração do codebase: Lê seu workspace/codebase e usa esse contexto para guiar as perguntas.
• Perguntas de múltipla escolha: As perguntas são formatadas para respostas rápidas, cobrindo ambiguidades importantes.
• Saída de plano em markdown: O resultado é um arquivo markdown para handoff direto a agentes de coding.
• Habilidades agnósticas a agentes (compatível com skills.sh): Blueprint é empacotado como skills compatíveis com múltiplos harnesses de agentes de coding.
• Templates integrados com seções de perguntas abertas: Inclui templates de planejamento padrão com seções como visão geral, comportamento esperado, fases de implementação, estratégia de testes e perguntas abertas.

Como Usar o Blueprint

1. Instale a skill usando o comando npx mostrado no repositório: npx skills add imbue-ai/blueprint.
2. Inicie uma sessão de planejamento invocando a skill no seu agente de coding com uma descrição curta da tarefa (ex.: /blueprint Adicione uma camada de cache para reduzir chamadas de API).
3. Escolha um template quando solicitado. Blueprint explora seu codebase e começa a fazer perguntas.
4. Responda às perguntas até Blueprint determinar que o terreno foi suficientemente coberto.
5. Gere o plano usando /blueprint-generate. O plano é salvo em um caminho formatado como blueprint/<slug>/plan-<slug>.md.
6. Refine no chat se necessário e pergunte sobre perguntas abertas (ex.: “quais são as perguntas abertas?”) antes de passar o plano para o seu agente de coding.

Casos de Uso

• Projetos greenfield / novas funcionalidades: Planeje uma grande nova funcionalidade garantindo que requisitos, comportamento esperado e estratégia de testes sejam explicitamente cobertos antes da implementação.
• Mudanças incrementais que precisam de coordenação: Quando uma mudança é grande o suficiente para exigir uma spec cuidadosa (não só uma edição rápida), Blueprint ajuda a estruturar decisões e fases.
• Pesquisa e experimentos: Para novos modelos, sistemas ou subsistemas, o fluxo Q&A do Blueprint captura suposições e desconhecidos como um plano com perguntas abertas.
• Trabalhando em um codebase desconhecido: Blueprint explora o workspace e faz perguntas esclarecedoras com base no que encontra, reduzindo a chance de perder restrições chave.
• Reduzindo erros de execução em workflows de agentes: Se um agente tenderia a “correr para o código”, Blueprint fornece um arquivo de plano explícito que o agente pode executar após a fase de planejamento.

FAQ

• Quais harnesses de agentes de coding são suportados? O repositório afirma ser compatível com harnesses como Claude Code, Codex CLI, Gemini CLI, Pi agent e outros harnesses compatíveis.

• Onde o plano gerado é salvo? O plano é salvo em blueprint/<slug>/plan-<slug>.md após executar /blueprint-generate.

• Quais templates o Blueprint inclui? Ele vem com dois templates integrados por padrão: Default (seções incluindo visão geral, comportamento esperado, plano/fases de implementação, estratégia de testes e perguntas abertas) e Concise (seções incluindo visão geral, comportamento esperado e mudanças).

• Posso personalizar a estrutura do plano? Sim. O repositório indica que você pode descrever um template personalizado inline quando solicitado, e também adicionar/editar templates persistentemente via templates.json para manter as duas skills do Blueprint sincronizadas.

• O Blueprint é limitado a trabalho front-end? A orientação do README sugere que é menos ideal para frontends onde a maioria das decisões é visual, e mais adequado para projetos greenfield, grandes novas funcionalidades e planejamento de pesquisa ou subsistemas.

Alternativas

• Geradores de especificações ou documentos (estilo revisão manual): Ferramentas que produzem especificações longas após o agente fazer suas próprias escolhas diferem do Blueprint ao inverter o fluxo de trabalho — o Blueprint busca sua entrada primeiro via Q&A.
• Fluxos de trabalho de “modo plano” de ferramentas de agentes de coding: Algumas plataformas de agentes incluem seus próprios modos de planejamento; o Blueprint é posicionado especificamente como um copilot de planejamento que gera um plano em markdown executável por agente e faz perguntas curtas, focadas em requisitos.
• Assistentes genéricos de revisão de codebases: Alternativas podem resumir ou analisar repositórios, mas a saída distintiva do Blueprint é um plano em markdown estruturado com seções definidas e perguntas abertas destinadas à execução.
• Fluxo de trabalho na barra lateral do VS Code usando uma extensão de planejamento: Se você prefere ferramentas integradas ao editor, o Blueprint também está disponível como uma extensão do VS Code que funciona no VS Code, Cursor e Windsurf, o que pode diferir de configurações de agentes puramente baseadas em chat.