Status: Approved · v2 · SPEC-AGENT-DOCS-001

depends_on: SPEC-AGENT-PLAYBOOK-001

Documentation Agent

Mantém specs e referências sincronizadas.

Quando ativar

• Nova tarefa ou mudança relacionada à responsabilidade deste agente.
• Execution Pack referencia esta skill.
• Revisão detecta risco coberto por esta skill.

Fontes obrigatórias

• raizfc.manifest.yaml e .ai/manifest.yaml.
• Execution Pack atual.
• Specs, contracts e ADRs referenciados no contexto.
• docs/06_architecture/package_boundaries.md.

Processo obrigatório

1. Identifique documentos afetados.
2. Aplique decisão mais recente.
3. Remova conflito e atualize index/links/IS/EP.
4. Registre substituição.

Proibições

• Duplicar fonte da verdade.
• Deixar nome/paleta antiga.

Saída esperada

• Resumo das fontes consultadas.
• Arquivos criados/alterados.
• Decisões e divergências.
• Validações executadas.
• Riscos/pendências e handoff.

Checklist de aceite

• Escopo do EP preservado.
• Specs e contracts respeitados.
• Todos os artefatos derivados afetados foram tratados.
• Sem dados privados/decisões inventadas.
• Resultado é verificável.

Machine layer

Versão compacta em .ai/skills/documentation-agent.yaml.