CommunityEscrita e Ediçãogithub.com

dustinkeeton/wafflestack

🧇 Uma massa, todos os repositórios — definições reutilizáveis de agentes e habilidades de IA renderizadas em arquivos nativos do harness (.claude/, .codex/, .agents/)

O que é wafflestack?

O Wafflestack é uma habilidade de agente de IA que orquestra a documentação de múltiplos repositórios, garantindo que os arquivos de documentação voltados para máquinas e humanos estejam sempre sincronizados com o estado real do código. Ele opera em um pipeline de três etapas: primeiro, uma auditoria de arquitetura somente leitura identifica alterações desde a última atualização; em seguida, um agente de documentação para máquinas atualiza o registro central `AGENTS.md`; e, por fim, um agente de documentação para humanos atualiza os arquivos voltados para pessoas (`DECISIONS.md`, `STATUS.md`, `ARCHITECTURE.md`), respeitando diretrizes específicas. Essa habilidade é útil para equipes que gerenciam múltiplos pacotes ou monorepos, automatizando a tediosa tarefa de manter a documentação técnica consistente com o código. Ela suporta qualquer ecossistema de agente de IA (Claude Code, Cursor, Codex) que possa referenciar definições de habilidades e executar prompts encadeados, e pode ser chamada explicitamente para disparar o pipeline completo.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add dustinkeeton/wafflestack

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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.yaml dessincronizadas com o uso de placeholders
  • Derivação da saída renderizada: node installer/cli.mjs doctor --allow-missing limpo (renderização e lock commitados em sincronia — re-renderize e faça commit após edições de bundle); .gitignore ainda 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.md e ARCHITECTURE.md na 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.

Habilidades Relacionadas