AI Agent Entry Point¶
Guia operacional para Copilot e outros agentes que atuam neste workspace com governança SDD.
Bootstrap mínimo (quando contexto está baixo)¶
Carregar nesta ordem:
Mandatos obrigatórios¶
| Mandato | Arquivo |
|---|---|
| M001 — Clean Architecture | docs/spec/canonical/features/CLEAN_ARCHITECTURE.md |
| M002 — TDD | docs/spec/canonical/features/TDD.md |
| M003 — Context Awareness | docs/spec/canonical/core/mandates/M003_CONTEXT_AWARENESS.md |
Templates canônicos de contexto¶
Protocolo de execução recomendado¶
# 1) Diagnóstico e estado de workspace
sdd init --type client
sdd runtime status --verbose
sdd doctor run
# 2) Conferir governança compilada e score
sdd governance compile
sdd governance score --verbose
sdd governance load
# 3) Validar mudanças antes de concluir tarefa
sdd test run
sdd lint run
Políticas obrigatórias¶
- Segurança e disclosure: SECURITY.md
Checklist de saída para o agente¶
- Mandatos M001, M002 e M003 respeitados
- Testes e lint executados quando houver alteração de código
- Documentação atualizada quando houver mudança estrutural
- Sem anti-padrões críticos de contexto
Anti-padrões a evitar¶
| Anti-padrão | Referência |
|---|---|
| Fixar sintoma sem causa raiz | SYMPTOM_FIXING.md |
| Executar sem escopo fechado | SCOPE_CREEP.md |
| Pular validação de contexto | CONTEXT_VERIFICATION.md |
Navegação adicional¶
- Índice mestre: docs/indices/MASTER_INDEX.md
- Cognição e modelos de decisão: docs/cognition/INDEX.md
- Protocolo de runtime: docs/runtime/AGENT_RUNTIME_PROTOCOL.md