Blueprint — Gerador de Plano de Construção

Transforme um objetivo de uma linha em um plano passo a passo que qualquer agente de codificação pode executar "a frio".

Visão Geral

Blueprint é para projetos de engenharia multi-sessão e multi-agente, onde cada passo deve ser executável independentemente por um agente novo que nunca viu o histórico da conversa. Instale-o uma vez, invoque-o com /blueprint <project> <objective>.

Quando Usar Esta Habilidade

• Use quando a tarefa exigir múltiplos PRs ou sessões
• Use quando múltiplos agentes ou membros da equipe precisarem compartilhar a execução
• Use quando você quiser uma revisão adversarial do plano antes da execução
• Use quando a detecção de passos paralelos e grafos de dependência forem importantes

Como Funciona

1. Pesquisa — Escaneia a base de código, lê a memória do projeto, executa verificações pré-voo
2. Design — Divide o objetivo em passos do tamanho de um PR, identifica paralelismo, registra as restrições do modelo selecionadas pelo usuário
3. Rascunho — Gera o plano a partir de um template estruturado com regras de fluxo de trabalho de branch, política de CI e estratégias de rollback inline
4. Revisão — Revisa o plano contra os critérios de aceitação; delega apenas quando o usuário ou instruções aplicáveis autorizarem explicitamente sub-agentes, e usa as restrições de modelo deles
5. Registro — Salva o plano/registro de tarefas em um local de projeto autorizado; atualizações de memória global exigem uma solicitação explícita

Exemplos

Exemplo 1: Migração de banco de dados

/blueprint myapp "migrate database to PostgreSQL"

Exemplo 2: Extração de plugin

/blueprint antbot "extract providers into plugins"

Melhores Práticas

• ✅ Use para tarefas que exigem 3+ PRs ou múltiplas sessões
• ✅ Deixe o Blueprint detectar automaticamente a disponibilidade de git/gh — ele degrada graciosamente
• ❌ Não invoque para tarefas que podem ser concluídas em um único PR
• ❌ Não invoque quando o usuário disser "apenas faça"

Diferenciais Chave

• Execução em "cold-start": Cada passo tem um resumo de contexto autônomo
• Portão de revisão adversarial: Revisão baseada em evidências antes da execução, com delegação autorizada opcional
• Distribuição com Markdown em primeiro lugar: A revisão da versão é primariamente instruções e templates, mas a instalação ou o seguimento dela ainda podem fazer um agente executar comandos. Trate o repositório como não confiável até ser inspecionado.
• Protocolo de mutação de plano: Passos podem ser divididos, inseridos, pulados com trilha de auditoria

Instalação

Não clone um branch em movimento diretamente em um diretório de habilidades ativo. Inspecione a revisão imutável nomeada em um diretório de revisão separado usando a autorização de tarefa/rede existente. A ativação ou instalação do host ainda precisa da instrução explícita aplicável; não pergunte novamente se já foi concedida:

review_dir="$(mktemp -d)"
git clone --filter=blob:none https://github.com/antbotlab/blueprint.git "$review_dir/blueprint"
git -C "$review_dir/blueprint" checkout --detach 07c5b305cf2d95d584a0d0398c390e839fec5954
git -C "$review_dir/blueprint" ls-files
git -C "$review_dir/blueprint" status --short

Leia SKILL.md e todos os arquivos empacotados naquele commit exato. Verifique scripts, hooks, symlinks, chamadas de rede, acesso a credenciais e instruções que solicitam comandos ou permissões elevadas. Somente dentro da aprovação explícita do usuário para instalação no host, copie os arquivos revisados para o diretório de habilidades do host selecionado. Re-revise uma versão mais recente em vez de atualizar silenciosamente este pin.

Recursos Adicionais

• Repositório no GitHub
• Exemplos: plano pequeno
• Exemplos: plano grande

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem faltando.
• Uma revisão fixada é reproduzível, não automaticamente confiável; seu conteúdo ainda requer revisão.