Manutenção e Evolução das Regras: Aprendendo com os Erros — aula do módulo Regras de Agentes & AGENTS.md, na trilha Governança Ágil com Método OKAM da…
Leitura de aproximadamente 4 minutos.
Módulo: Regras de Agentes & AGENTS.md · Curso: Governança Ágil com Método OKAM · Formação: Formação Nível Zero: Ferramentas Essenciais e Gratuitas de IA e Código
AGENTS.md para evitar lentidão e perda de foco do modelo.No desenvolvimento tradicional, quando você encontra um erro no código, você abre o arquivo, conserta a linha e segue em frente.
No desenvolvimento assistido por IA, corrigir apenas o código é insuficiente. Se a IA cometeu um deslize conceitual hoje (como usar uma biblioteca obsoleta ou apagar um cabeçalho), ela cometerá exatamente o mesmo deslize na semana que vem, a menos que o sistema receba uma atualização de diretrizes.
No método OKAM, adotamos uma postura sistemática: todo erro recorrente da IA revela uma lacuna no nosso arquivo de regras. Em vez de se frustrar com a máquina, tratamos cada incidente como um gatilho para evoluir o AGENTS.md.
O processo de evolução da governança segue um ciclo contínuo de quatro passos:
+-------------------------------------------------------------------------------+
| O CICLO DE RETROALIMENTAÇÃO DE GOVERNANÇA |
+-------------------------------------------------------------------------------+
| |
| 1. DETECÇÃO DO ERRO 2. IDENTIFICAÇÃO DA CAUSA |
| +───────────────────+ +─────────────────────────+ |
| | IA usou biblioteca| ───> | Não havia proibição no | |
| | não autorizada | | arquivo AGENTS.md | |
| +───────────────────+ +─────────────────────────+ |
| ▲ │ |
| │ ▼ |
| 4. OPERAÇÃO BLINDADA 3. ADIÇÃO DA REGRA CIRÚRGICA |
| +───────────────────+ +─────────────────────────+ |
| | Próximos prompts | <─── | "Proibido uso da | |
| | nunca mais erram | | biblioteca X no projeto"| |
| +───────────────────+ +─────────────────────────+ |
| |
+-------------------------------------------------------------------------------+
A tabela abaixo ilustra como transformar problemas do dia a dia em regras de alta densidade:
| Incidente Ocorrido | Causa Raiz | Nova Regra Adicionada ao AGENTS.md | |---|---|---| | A IA escreveu variáveis com nomes misturados (português e inglês). | Falta de padrão de nomenclatura declarado. | Nomenclatura: variáveis e funções exclusivamente em inglês. | | A IA inseriu botões com cores fora da paleta da marca. | Ausência de guia de estilos explícito. | Cores: use exclusivamente as variáveis declaradas em :root no style.css. | | A IA instalou um pacote pesado para formatar uma data simples. | Falta de limite de dependências externas. | Utilitários: manipulação de datas com JavaScript puro nativo (Intl.DateTimeFormat). |
À medida que o projeto ganha complexidade, existe o risco de acumular dezenas de regras antigas, fazendo o AGENTS.md inchar desnecessariamente.
Para manter a inteligência artificial rápida e focada, aplique o Ritual de Poda Periódica: 1. Mantenha o documento abaixo de 2.000 palavras (aproximadamente 3.000 a 4.000 tokens). 2. Elimine regras obsoletas: Se o projeto migrou de tecnologia ou se uma biblioteca antiga foi removida, exclua as regras correspondentes. 3. Agrupe padrões semelhantes: Em vez de ter cinco regras proibindo cinco bibliotecas diferentes de gráficos, unifique em uma única linha: Gráficos: use exclusivamente SVG nativo ou Canvas puro; proibido bibliotecas externas.
Ao trabalhar em múltiplos projetos, você notará que algumas regras valem para absolutamente tudo o que você cria, enquanto outras são específicas:
AGENTS.md da pasta): As cores do produto, as tecnologias daquele aplicativo específico e a estrutura de diretórios do repositório.[!TIP]
Adicionar Regras Longas com Histórico Emocional: Evite escrever regras narrando o problema que ocorreu no passado (por exemplo: "Na semana passada a IA cometeu um erro feio apagando a tabela de clientes, então por favor tome muito cuidado para que isso não se repita nunca mais"). A IA não precisa da história do trauma; ela precisa apenas da ordem técnica direta: Banco de Dados: proibido deletar tabelas ou registros existentes sem confirmação manual.
Vamos simular uma sessão de aprendizado e evolução de regras:
1. Identifique um comportamento indesejado: Lembre-se de uma resposta recente da IA que você precisou corrigir manualmente (exemplo: a IA gerou comentários gigantescos explicando cada linha óbvia do código). 2. Sintetize a causa raiz: A IA não sabia qual era o nível de detalhamento esperado para os comentários. 3. Redija uma nova regra cirúrgica:
- Comentários: Apenas quando a lógica for não óbvia. Máximo de 1 linha por bloco. Proibido comentar declarações triviais.
4. Adicione ao AGENTS.md e teste: Salve o arquivo e peça para o assistente escrever uma função simples. Verifique como o código gerado agora vem limpo e perfeitamente ajustado ao seu gosto.