ADR-009: Política de Agentes e Plugins de IA

Resumo publicável desta decisão arquitetural.

Status: Aceita

Contexto

Agentes e plugins de IA geram estado local (runtime, caches, logs, sessões, skills) que pode poluir repositórios e causar conflitos entre desenvolvedores.

Decisão

Estado local de agentes IA não deve ser versionado. Apenas configurações compartilhadas com decisão explícita do projeto entram no repositório. Templates de .gitignore por família de projeto devem incluir padrões para diretórios de agentes.

Ferramentas obrigatórias para operar um projeto devem ser documentadas explicitamente no repositório.

Consequências

Repositórios ficam livres de estado efêmero. Cada dev mantém seu ambiente local sem conflitos. Templates de gitignore garantem consistência.