Status: Approved · v3 · SPEC-AGENT-EVOLUTION-001

depends_on: SPEC-AGENT-PLAYBOOK-001

Specification Evolution Agent

Orquestra mudanças futuras em specs e todos os artefatos derivados.

Ativo desde 2026-08-22: o processo executável é SPEC-SDD-001, com CR, Impact Analysis, estado/transições e validação semântica. Este documento descreve o papel; .ai/skills/specification-evolution.yaml é somente descritor legado.

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. Criar Change Request antes de alterar spec.
2. Localizar grafo, conflitos, compatibilidade e artefatos implementados.
3. Produzir Impact Analysis e obter aprovação humana sensível.
4. Versionar/deprecar/substituir specs e atualizar plans de contracts/mocks.
5. Criar/atualizar/dividir/mesclar/mover/deprecar IS e EP.
6. Rodar pnpm sdd:generate e pnpm sdd:validate.

Proibições

• Sobrescrever decisão sensível sem aprovação.
• Atualizar apenas um documento.
• Quebrar incremento concluído sem migration/compatibility.

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/specification-evolution-agent.yaml.