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

depends_on: SPEC-AGENT-PLAYBOOK-001

Backend Agent

Implementa casos de uso em camadas no NestJS.

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. Controller fino.
2. Use case controla transação/idempotência/audit.
3. Repository/provider por interface.
4. Mapeie DTO/errors.

Proibições

• Regra no controller/repository.
• SDK externo direto.
• Bypass de guard.

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