Blueprint — Gerador de planos de construção

Transforme um objetivo de uma linha em um plano de construção passo a passo que qualquer programador possa executar sem esforço.

Quando usar

• Ao dividir um recurso grande em vários PRs com uma ordem clara de dependências
• Planejamento de uma refatoração ou migração que se estenda por várias sessões
• Coordenar fluxos de trabalho paralelos entre subagentes
• Qualquer tarefa em que a perda de contexto entre sessões causaria retrabalho

Não use para tarefas que possam ser concluídas em um único PR, que exijam menos de três chamadas de ferramentas ou quando o usuário disser “simplesmente faça isso”.

Como funciona

Blueprint executa um pipeline de 5 fases:

1. Pesquisa — Verificações prévias (git, autenticação no GitHub, conexão remota, ramo padrão); em seguida, analisa a estrutura do projeto, os planos existentes e os arquivos de memória para reunir o contexto.
2. Projeto — Divide o objetivo em etapas do tamanho de um PR (normalmente de 3 a 12). Atribui relações de dependência, ordenação paralela/serial, nível de modelo (mais forte vs. padrão) e estratégia de reversão para cada etapa.
3. Rascunho — Grava um arquivo de plano em Markdown independente em plans/. Cada etapa inclui um resumo do contexto, lista de tarefas, comandos de verificação e critérios de conclusão — assim, um novo agente pode executar qualquer etapa sem precisar ler as etapas anteriores.
4. Revisão — Delega a revisão crítica a um subagente de modelo mais robusto (por exemplo, o Opus) com base em uma lista de verificação e um catálogo de antipadrões. Corrige todas as falhas críticas antes da finalização.
5. Registro — Salva o plano, atualiza o índice de memória e apresenta ao usuário a contagem de etapas e o resumo de paralelismo.

Blueprint Detecta automaticamente a disponibilidade do Git/GitHub. Com o Git + GitHub CLI, gera planos completos de fluxo de trabalho para ramificações/PRs/CI. Sem eles, muda para o modo direto (edição no local, sem ramificações).

Exemplos

Uso básico

/blueprint myapp "migrate database to PostgreSQL"

Gera plans/myapp-migrate-database-to-postgresql.md com etapas como:

• Etapa 1: Adicionar o driver PostgreSQL e a configuração de conexão
• Etapa 2: Criar scripts de migração para cada tabela
• Etapa 3: Atualize a camada de repositório para usar o novo driver
• Etapa 4: Adicionar testes de integração com o PostgreSQL
• Etapa 5: Remover o código e a configuração antigos do banco de dados

Projeto multiagente

/blueprint chatbot "extract LLM providers into a plugin system"

Gera um plano com etapas paralelas sempre que possível (por exemplo, “implementar o plug-in Anthropic” e “implementar o plug-in OpenAI” são executados paralelamente após a conclusão da etapa de interface do plug-in), atribuições da camada de modelo (mais rigorosas para a etapa de projeto de interface, padrão para a implementação) e invariantes verificadas após cada etapa (por exemplo, “todos os testes existentes são aprovados”, “nenhuma importação de provedor no núcleo”).

Principais recursos

• Execução a partir do zero — Cada etapa inclui um resumo de contexto autônomo. Não é necessário contexto prévio.
• Porta de revisão adversária — Cada plano é revisado por um subagente do modelo mais robusto, com base em uma lista de verificação que abrange integridade, correção de dependências e detecção de antipadrões.
• Fluxo de trabalho de ramificação/PR/CI — Integrado a cada etapa. Reverte suavemente para o modo direto quando git/gh estiver ausente.
• Detecção de etapas paralelas — O gráfico de dependências identifica etapas sem arquivos compartilhados ou dependências de saída.
• Protocolo de modificação de plano — As etapas podem ser divididas, inseridas, puladas, reordenadas ou abandonadas por meio de protocolos formais e trilha de auditoria.
• Risco zero em tempo de execução — Tecnologia Markdown pura. Todo o repositório contém apenas .md arquivos — sem hooks, sem scripts de shell, sem código executável, sem package.json, nenhuma etapa de compilação. Nada é executado na instalação ou na invocação além do carregador nativo de habilidades Markdown do Claude Code.

Instalação

Esta habilidade vem incluída no Everything Claude Code. Não é necessária nenhuma instalação separada quando o ECC está instalado.

Instalação completa do ECC

Se você estiver trabalhando a partir do checkout do repositório do ECC, verifique se a skill está presente com:

test -f skills/blueprint/SKILL.md

Para atualizar posteriormente, analise o diff do ECC antes de atualizar:

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

Instalação autônoma como produto de terceiros

Se você estiver utilizando apenas esta habilidade fora da instalação completa do ECC, copie o arquivo revisado do repositório do ECC para ~/.claude/skills/blueprint/SKILL.md. Cópias fornecidas como vendors não possuem um git remote; portanto, atualize-as recopiando o arquivo a partir de um commit revisado do ECC, em vez de executar git pull.

Requisitos

• Claude Code (para /blueprint comando de barra)
• Git + GitHub CLI (opcional — habilita o fluxo de trabalho completo de ramificação/PR/CI; Blueprint detecta a ausência e muda automaticamente para o modo direto)

Fonte

Inspirado em antbotlab/blueprint — projeto original e modelo de referência.