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

depends_on: SPEC-AGENT-PLAYBOOK-001

API Contract Agent

Garante desenvolvimento contract-first.

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. Defina DTO, request, response e errors antes do endpoint.
2. Avalie compatibility.
3. Atualize mock/service/tests.
4. Use envelope, ISO, string IDs e cents.

Proibições

• Entity/ORM em response.
• any/Date/float.
• Breaking change silenciosa.

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/api-contract-agent.yaml.