Orquestração de Documentação
Quando esta habilidade for invocada, execute o seguinte pipeline:
Etapa 1: Auditoria de Arquitetura
Invoque o agente general-purpose com este prompt:
Audite o codebase atual para detectar quaisquer mudanças desde a última atualização dos documentos. Leia os documentos de máquina existentes (um único registro raiz
AGENTS.md) e compare com o projeto real. Produza um relatório de alterações conciso cobrindo:
- Novos ou removidos bundles, skills, agentes, chaves de configuração ou comandos CLI
- Exportações modificadas do instalador ou semânticas de template (
installer/lib/*.mjs)- Declarações de configuração
bundle.yamldessincronizadas com o uso de placeholders- Derivação da saída renderizada:
node installer/cli.mjs doctor --allow-missinglimpo (renderização e lock commitados em sincronia — re-renderize e faça commit após edições de bundle);.gitignoreainda cobre as renderizações deliberadamente não rastreadas (fluxo label-hook, worktrees, documentos de visão geral.waffle/)Gere APENAS o relatório de alterações como texto estruturado. NÃO modifique nenhum arquivo.
Etapa 2: Documentação para Máquinas
Pegue o relatório de alterações e invoque o agente docs-agent com este prompt:
Aqui está o relatório de alterações da arquitetura para o codebase do wafflestack:
{saída-da-etapa-1}
Atualize os documentos de máquina — um único registro raiz
AGENTS.md— para refletir o estado atual do projeto. Leia os arquivos fonte reais para verificar detalhes — não confie apenas no relatório de alterações. Siga as diretrizes da habilidade docs-agent para formato e estrutura.
Etapa 3: Documentação para Humanos
Após o docs-agent concluir, invoque o agente docs-human com este prompt:
Os documentos de máquina acabaram de ser atualizados. Atualize a documentação voltada para humanos —
DECISIONS.md,STATUS.mdeARCHITECTURE.mdna raiz do repositório — para corresponder.Leia os documentos de máquina atualizados e o código fonte real para garantir precisão. Siga as diretrizes da habilidade docs-human para formato, estrutura e suas salvaguardas (documentos com voz do proprietário são sinalizados, nunca reescritos).
Importante
- Cada etapa deve ser concluída antes do início da próxima — a saída de cada uma informa a próxima.
- A Etapa 1 é somente leitura — o agente de auditoria apenas reporta.
- docs-agent e docs-human DEVEM modificar seus respectivos arquivos de documentação.