Blueprint

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 código pode executar a frio.

Quando Usar

• Dividir um grande recurso em várias 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 subagentes
• Qualquer tarefa onde a perda de contexto entre sessões cause retrabalho

Não use para tarefas que podem ser concluídas em uma única 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:

1. Pesquisa — Verificações pré-voo (git, gh auth, remote, branch padrão), depois lê a estrutura do projeto, planos existentes e arquivos de memória para reunir contexto.
2. Design — Divide o objetivo em etapas do tamanho de uma PR (3–12 típicos). 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.
3. 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 novo agente possa executar qualquer etapa sem ler as anteriores.
4. Revisão — Delega a revisão adversarial a um subagente de 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 ao usuário o resumo da contagem de etapas e paralelismo.

O Blueprint detecta automaticamente a disponibilidade do git/gh. 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 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 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 etapa da interface do 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 (por exemplo, "todos os testes existentes passam", "sem imports de provedor no núcleo").

Principais Recursos

• Execução a frio — Cada etapa inclui um resumo de contexto autocontido. Nenhum contexto anterior é necessário.
• Portão de revisão adversarial — Cada plano é revisado por um subagente de modelo mais forte contra uma lista de verificação que cobre completude, correção de dependências e detecção de antipadrões.
• Fluxo de trabalho de Branch/PR/CI — Incorporado em cada etapa. Degrada graciosamente para o 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 do plano — As etapas podem ser divididas, inseridas, puladas, reordenadas ou abandonadas com protocolos formais e trilha de auditoria.
• Risco zero de tempo de execução — Skill pura em Markdown. Todo o repositório 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 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ê estiver trabalhando a partir do checkout do repositório ECC, verifique se a skill está presente com:

test -f skills/blueprint/SKILL.md

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

cd /path/to/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main       # revise novos commits antes de atualizar
git checkout <reviewed-full-sha>          # fixe em um commit específico revisado

Instalação independente (vendored)

Se você estiver fornecendo 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 fornecidas (vendored) não possuem um git remote, então atualize-as copiando novamente o arquivo de um commit 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 a ausência e muda automaticamente para o modo direto)

Fonte

Inspirado em antbotlab/blueprint — projeto upstream e design de referência.