With Agents

1. Definir objetivo, escopo e restrições da task
2. Selecionar 1 workflow principal em Workflows/
3. Definir skills de suporte técnico em Skills/
4. Editar os artefatos oficiais de Docs/ da demanda
5. Executar o trabalho técnico (com ou sem agente)
6. Aplicar Quality Gate e registrar evidências
7. Encerrar a task com rastreabilidade em Docs/control.md

Templates em Templates/ são modelo.
Artefatos oficiais do projeto são editados em Docs/.
Protótipos HTML ficam em Prototype/.

Docs/plan.md     — plano da fase em andamento
Docs/tasks.md    — lista de tasks com critérios de aceite
Docs/control.md  — painel de rastreabilidade e status

- Bootstrap estrutural apenas na primeira task
- Após bootstrap: apenas edição de arquivos existentes
- Exatamente 1 commit por task concluída
- Quality Gate obrigatório antes de fechar task

1. Selecionar o agente principal conforme o objetivo da task
2. Carregar contexto base + contexto de especialidade do agente
3. Declarar o formato de saída esperado antes da execução
4. Quando a próxima etapa mudar de domínio → fazer handoff para agente complementar

Objetivo da task → agente principal:
  Escopo não está claro        → ScopeAgent
  Produto, UI ou fluxo         → ProductAgent
  Arquitetura, API, domínio    → SystemAgent
  Implementação e código       → ExecutionAgent
  Validação e encerramento     → QualityAgent
  Publicação e entrega         → ReleaseAgent
  Incidente ou correção urgente→ RecoveryAgent

Entrada:  contexto recebido do agente anterior
Saída:    artefatos produzidos e onde foram salvos
Risco:    o que ficou indefinido ou pode gerar retrabalho
Próximo:  qual agente assume e com qual objetivo

Atue como [AgentName].
Objetivo: [objetivo da task]
Workflow: Workflows/[workflow].md
 
Carregue contexto base:
- GUIDE.md
- Skills/01GUIDE.md
- Workflows/01GUIDE.md
- Quality/01GUIDE.md
- Templates/Full/01GUIDE.md
 
Carregue contexto especializado:
- agents/[role]-agent.md
 
Carregue contexto de execução:
- Docs/plan.md
- Docs/tasks.md
- Docs/control.md
 
Aplique governança:
- bootstrap apenas na primeira task
- edit-only após bootstrap
- 1 commit por task
- Quality Gate obrigatório
 
Entregue:
1) plano da execução
2) execução com evidências
3) riscos e pendências
4) handoff (se houver próxima etapa)

Atue como [AgentName].
Objetivo: [objetivo]
Workflow: Workflows/[workflow].md
Contexto de execução: Docs/plan.md, Docs/tasks.md, Docs/control.md
Saída: plano, execução, evidências, riscos e pendências

# [Nome do cenário]
 
## Contexto
[o que motivou — gatilho]
 
## Objetivo
[resultado esperado]
 
## Workflow
Workflows/[workflow].md
 
## Agente principal
[AgentName]
 
## Skills
- Skills/[skill].md
 
## Docs editados
- Docs/plan.md
- Docs/tasks.md
- Docs/control.md
 
## Etapas
1. Planejar
2. Executar
3. Validar
4. Encerrar
 
## Evidências
- Quality Gate aprovado
- hash do commit
- riscos e pendências

1. Toda etapa do cenário deve ter dono explícito por agente
2. Cada handoff deve registrar entrada, saída e risco residual
3. O QualityAgent valida o fechamento em todos os cenários
4. O contexto de execução sempre em Docs: plan.md, tasks.md, control.md

Docs oficiais atualizados:    Docs/tasks.md e Docs/control.md refletem a task encerrada
Quality Gate aprovado:        Quality/gate.md critérios cumpridos
Hash do commit:               1 commit por task, hash registrado no control
Riscos e pendências:          documentados em Docs/control.md
Handoff registrado:           se houve passagem de agente, consta no control

( ) Agente principal correto para a demanda
( ) Contexto base carregado: GUIDE.md, Skills/01GUIDE.md, Quality/01GUIDE.md
( ) Contexto especializado carregado: agents/[role]-agent.md
( ) Workflow declarado explicitamente
( ) Handoff definido quando há mudança de domínio
( ) Saída registrada em Docs/tasks.md e Docs/control.md
( ) Quality Gate aprovado antes de fechar a task
( ) 1 commit com hash registrado no control