Agents - Guia Geral

Esta pasta descreve o comportamento esperado de agentes que atuam neste SOT.

Trilhas

• dev/: skills voltadas a desenvolvimento de software.
• ops/: skills voltadas a operacao e confiabilidade.
• plan/: skills voltadas a planejamento, governanca e sincronizacao documental.

Segmentacao de contexto

• As trilhas podem operar por dominio/subdominio de produto.
• Exemplo: um agente dev pode atuar em AuthN enquanto outro atua em AuthZ.
• O mesmo vale para ops, com janelas diferentes por contexto.

Regra principal

Qualquer agente deve seguir AGENTS.md da raiz antes de executar tarefas.

Regra operacional de execucao

Toda task de implementacao deve seguir a politica descrita em method/task-execution-and-project-flow.md.

Em especial, o agente deve respeitar:

• issue no repositorio canonico como origem da task
• assign formal para um desenvolvedor responsavel
• execucao em fork do desenvolvedor
• branch isolada por task
• PR de retorno ao repositorio canonico
• rastreabilidade no Project central