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

depends_on: SPEC-PRINCIPLES-001

AI Agent Playbook

Ponto de entrada obrigatório para qualquer IA/dev.

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 EP e specs referenciadas.
2. Leia contracts e boundaries.
3. Não amplie escopo.
4. Implemente, teste, atualize docs e gere handoff.

Proibições

• Começar pela tela/controller sem contract.
• Inventar regra/status/preço.
• Usar referência antiga de marca.

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