Blueprint — Gerador de Planos de Construção
Transforme um objetivo de uma linha em um plano de construção passo a passo que qualquer agente de codificação pode executar do zero.
Quando Usar
- Dividir uma funcionalidade grande em vários PRs com ordem de dependência clara
- Planejar uma refatoração ou migração que abrange várias sessões
- Coordenar fluxos de trabalho paralelos entre sub-agentes
- Qualquer tarefa onde a perda de contexto entre sessões causaria retrabalho
Não use para tarefas concluíveis em um único PR, com menos de 3 chamadas de ferramenta, ou quando o usuário disser "apenas faça".
Como Funciona
O Blueprint executa um pipeline de 5 fases:
- Pesquisa — Verificações de pré-voo (git, gh auth, remote, branch padrão), depois lê a estrutura do projeto, planos existentes e arquivos de memória para coletar contexto.
- Design — Divide o objetivo em etapas do tamanho de um PR (3–12 típico). Atribui arestas de dependência, ordenação serial/paralela, nível de modelo (mais forte vs. padrão) e estratégia de reversão por etapa.
- Rascunho — Escreve um arquivo de plano Markdown autocontido em
plans/. Cada etapa inclui um resumo de contexto, lista de tarefas, comandos de verificação e critérios de saída — para que um agente novo possa executar qualquer etapa sem ler as anteriores. - Revisão — Delega a revisão adversarial a um sub-agente de modelo mais forte (ex.: Opus) contra uma lista de verificação e catálogo de antipadrões. Corrige todas as descobertas críticas antes de finalizar.
- Registro — Salva o plano, atualiza o índice de memória e apresenta ao usuário a contagem de etapas e um resumo do paralelismo.
O Blueprint detecta automaticamente a disponibilidade de git/gh. Com git + GitHub CLI, gera planos completos de fluxo de trabalho de branch/PR/CI. Sem eles, alterna para modo direto (edição no local, sem branches).
Exemplos
Uso básico
/blueprint meuapp "migrar banco de dados para PostgreSQL"
Produz plans/meuapp-migrar-banco-de-dados-para-postgresql.md com etapas como:
- Etapa 1: Adicionar driver PostgreSQL e configuração de conexão
- Etapa 2: Criar scripts de migração para cada tabela
- Etapa 3: Atualizar camada de repositório para usar novo driver
- Etapa 4: Adicionar testes de integração contra PostgreSQL
- Etapa 5: Remover código e configuração antigos do banco de dados
Projeto multi-agente
/blueprint chatbot "extrair provedores de LLM em um sistema de plugins"
Produz um plano com etapas paralelas onde possível (ex.: "implementar plugin Anthropic" e "implementar plugin OpenAI" executam em paralelo após a etapa de interface de plugin ser concluída), atribuições de nível de modelo (mais forte para a etapa de design da interface, padrão para implementação) e invariantes verificados após cada etapa (ex.: "todos os testes existentes passam", "nenhum import de provedor no núcleo").
Principais Características
- Execução a frio — Cada etapa inclui um resumo de contexto autocontido. Nenhum contexto anterior é necessário.
- Portão de revisão adversarial — Todo plano é revisado por um sub-agente de modelo mais forte contra uma lista de verificação que cobre completeza, correção de dependências e detecção de antipadrões.
- Fluxo de trabalho Branch/PR/CI — Integrado em cada etapa. Degrada graciosamente para modo direto quando git/gh está ausente.
- Detecção de etapas paralelas — O grafo de dependências identifica etapas sem arquivos compartilhados ou dependências de saída.
- Protocolo de mutação de plano — Etapas podem ser divididas, inseridas, puladas, reordenadas ou abandonadas com protocolos formais e trilha de auditoria.
- Zero risco em tempo de execução — Skill puramente Markdown. O repositório inteiro contém apenas arquivos
.md— sem hooks, sem scripts shell, sem código executável, sempackage.json, sem etapa de construção. Nada é executado na instalação ou invocação além do carregador nativo de skill Markdown do Claude Code.
Instalação
Esta skill acompanha o Everything Claude Code. Nenhuma instalação separada é necessária quando o ECC está instalado.
Instalação completa do ECC
Se você está trabalhando a partir do checkout do repositório ECC, verifique se a skill está presente com:
test -f skills/blueprint/SKILL.md
Para atualizar depois, revise o diff do ECC antes de atualizar:
cd /caminho/para/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main # revise novos commits antes de atualizar
git checkout <sha-revisado-completo> # fixe em um commit específico revisado
Instalação autônoma empacotada
Se você está empacotando apenas esta skill fora da instalação completa do ECC, copie o arquivo revisado do repositório ECC para ~/.claude/skills/blueprint/SKILL.md. Cópias empacotadas não têm um remote git, então atualize-as copiando novamente o arquivo de um commit do ECC revisado, em vez de executar git pull.
Requisitos
- Claude Code (para o comando de barra
/blueprint) - Git + GitHub CLI (opcional — permite fluxo de trabalho completo de branch/PR/CI; o Blueprint detecta ausência e alterna automaticamente para modo direto)
Fonte
Inspirado por antbotlab/blueprint — projeto upstream e design de referência.