Skip to content

Agent Runtime Protocol

Protocolo operacional obrigatório para qualquer agente de IA que execute tarefas neste workspace.

Fluxo de 7 fases

Todo trabalho — bug fix, feature, refactor, documentação — segue este fluxo. Não é opcional.

FASE 0: Verificar contexto e estado inicial
   ↓
FASE 1: Carregar regras e mandatos
   ↓
FASE 2: Verificar estado de execução (detectar conflitos)
   ↓
FASE 3: Escolher caminho: bug=A | simples=B | complexo=C | multi=D
   ↓
FASE 4: Carregar contexto específico da tarefa
   ↓
FASE 5: Implementar (código + testes, TDD)
   ↓
FASE 6: Validar (testes + definition of done)
   ↓
FASE 7: Checkpoint (documentar + entregar)

Comandos obrigatórios por fase

Fase 0 — Estado inicial

sdd runtime status --verbose   # Verificar saúde do workspace
sdd governance validate        # Confirmar integridade de governança

Fase 1 — Regras e mandatos

Carregar antes de qualquer execução: - M001 — Clean Architecture - M002 — TDD obrigatório - M003 — Context Awareness

Fase 5 — Implementação

sdd test run          # Rodar testes a cada mudança significativa
sdd lint run          # Lint antes de declarar pronto

Fase 6 — Validação final

sdd test run                    # Suíte completa
sdd lint run                    # Qualidade estática
sdd governance validate         # Integridade de governança
sdd runtime status --verbose    # Estado final do workspace

Gerenciamento de contexto (memória LLM)

Fase O que carregar Propósito
Planejamento cognition/decision-models/ Avaliar riscos e confiança
Execução runtime/paths/ Workflow específico por tipo de tarefa
Validação spec/canonical/specifications/definition_of_done.md Critérios de qualidade

Nunca carregar a documentação inteira. Usar sempre path-based context loading via Master Index.

Regras de comportamento

  • Checkpoint a cada 30 minutos de trabalho ativo
  • Rodar sdd governance validate antes de qualquer entrega
  • Documentar decisões arquiteturais em docs/spec/decisions/
  • Anti-padrão crítico: SYMPTOM_FIXING.md

Referências