Blueprint — Gerador de Plano 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 "a frio".

Quando Usar

• Dividir um recurso grande em vários PRs com ordem clara de dependência
• Planejar um refatoramento ou migração que abrange várias sessões
• Coordenar fluxos de trabalho paralelos entre subagentes
• Qualquer tarefa onde a perda de contexto entre sessões causaria retrabalho

Não use para tarefas que podem ser concluídas em um único PR, menos de 3 chamadas de ferramenta, ou quando o usuário diz "apenas faça".

Como Funciona

Blueprint executa um pipeline de 5 fases:

1. Pesquisa — Verificações pré-voo (git, autenticação gh, remoto, branch padrão), em seguida, lê a estrutura do projeto, planos existentes e arquivos de memória para coletar contexto.
2. Design — Divide o objetivo em etapas do tamanho de um PR (3–12 típicas). Atribui arestas de dependência, ordenação paralela/serial, nível do modelo (mais forte vs. padrão) e estratégia de rollback por etapa.
3. Rascunho — Escreve um arquivo Markdown de plano autônomo 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 etapas anteriores.
4. Revisão — Delega a revisão adversarial a um subagente do modelo mais forte (por exemplo, Opus) contra uma lista de verificação e um catálogo de antipadrões. Corrige todas as descobertas críticas antes de finalizar.
5. Registro — Salva o plano, atualiza o índice de memória e apresenta a contagem de etapas e o resumo de paralelismo ao usuário.

Blueprint detecta a disponibilidade de git/gh automaticamente. Com git + GitHub CLI, ele gera planos completos de fluxo de trabalho de branch/PR/CI. Sem eles, ele muda para o modo direto (edição no local, sem branches).

Exemplos

Uso Básico

/blueprint myapp "migrate database to PostgreSQL"

Produz plans/myapp-migrate-database-to-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 a camada de repositório para usar o 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 Multiagente

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

Produz um plano com etapas paralelas sempre que possível (por exemplo, "implementar plugin Anthropic" e "implementar plugin OpenAI" executam em paralelo após a conclusão da etapa da interface do plugin), 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 (por exemplo, "todos os testes existentes passam", "nenhuma importação de provedor no núcleo").

Principais Recursos

• Execução de "cold-start" — Cada etapa inclui um resumo de contexto autônomo. Nenhum contexto prévio é necessário.
• Portão de revisão adversarial — Cada plano é revisado por um subagente do modelo mais forte contra uma lista de verificação que cobre completude, correção de dependência e detecção de antipadrões.
• Fluxo de trabalho de branch/PR/CI — Integrado a cada etapa. Degrada graciosamente para o modo direto quando git/gh está ausente.
• Detecção de etapas paralelas — O grafo de dependência 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.
• Risco de tempo de execução zero — Habilidade pura de Markdown. O repositório inteiro contém apenas arquivos .md — sem hooks, sem scripts shell, sem código executável, sem package.json, sem etapa de build. Nada é executado na instalação ou invocação além do carregador de habilidade Markdown nativo do Claude Code.

Instalação

Esta habilidade é distribuída com o ECC. Nenhuma instalação separada é necessária quando o ECC está instalado.

Instalação completa do ECC

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

test -f skills/blueprint/SKILL.md

Para atualizar mais tarde, revise o diff do ECC antes de atualizar:

cd /path/to/ECC
git fetch origin main
git log --oneline HEAD..origin/main       # review new commits before updating
git checkout <reviewed-full-sha>          # pin to a specific reviewed commit

Instalação independente "vendored"

Se você estiver "vendoring" apenas esta habilidade fora da instalação completa do ECC, copie o arquivo revisado do repositório ECC para ~/.claude/skills/blueprint/SKILL.md. Cópias "vendored" não têm um remoto git, então atualize-as recopiando o arquivo de um commit ECC revisado em vez de executar git pull.

Requisitos

• Claude Code (para o comando de barra /blueprint)

…