2026-01-18_agent-regras-ouro
Documentação KOLOS

2026-01-18_agent-regras-ouro

🧭 Contexto

O projeto KOLOS depende de consistência arquitetural (DDD modular), stack versionada (Laravel 12 / Livewire 4 / PHP 8.5) e decisões registradas. Para evitar regressões e dívida técnica, o agente precisa operar com princípios explícitos e inegociáveis.

✅ Decisão

Reforçar no agent do KOLOS as regras:

  • Zero alucinação: não adivinhar; consultar documentação oficial.
  • Zero gambiarra: não mascarar problemas; corrigir pela raiz.
  • Doc-first: priorizar documentação em docs/ antes de qualquer mudança relevante.
  • Pesquisar antes de implementar: reusar padrões do projeto (Actions/DTOs/Models/Testes) e evitar duplicação.
  • Correto > fácil: preferir a solução correta; se impossível, explicar o motivo e a alternativa viável.

🛠️ Passos (comandos via Sail)

Nenhum.

🧪 Validação

📦 Impacto