Impeça que Agentes de Codificação de IA Repitam os Mesmos Erros

Agentes de codificação de IA como Claude Code ou Cursor frequentemente cometem os mesmos erros. Eles usam o test runner errado. Eles usam o estilo de importação errado. Você os corrige no chat, mas eles esquecem a correção na próxima sessão.

O histórico do chat não é memória. Quando uma sessão termina, suas correções desaparecem.

A solução é simples. Escreva suas regras em um arquivo que o agente lê toda vez que é executado.

A maioria das ferramentas suporta arquivos de instrução na raiz do projeto: • Claude Code lê CLAUDE.md. • Cursor usa .cursor/rules/*.mdc. • Muitas ferramentas usam o padrão AGENTS.md.

Esses arquivos são anexados ao contexto do modelo. As regras existem antes de o modelo escrever qualquer código.

Não escreva objetivos vagos. Não diga ao agente para escrever "clean code". Regras vagas não funcionam. Em vez disso, use regras específicas e testáveis.

Use esta estrutura para o seu arquivo de regras:

• Comandos: Defina exatamente como executar testes e typechecks. • Estilo: Especifique ESM em vez de CommonJS ou named exports em vez de defaults. • Limites: Marque pastas como somente leitura ou defina onde os segredos residem. • Definição de Pronto: Estabeleça que cada nova funcionalidade deve ter um teste que falhe primeiro.

Um bom arquivo de regras atua como um "scar log" (registro de cicatrizes). Toda vez que um agente cometer um erro, adicione uma regra de uma linha ao arquivo na mesma sessão.

Mantenha o arquivo curto. Se o seu arquivo de regras for muito longo, ele competirá com seu código pela atenção do modelo. Se uma regra tiver mais de 200 linhas, faça uma poda. Remova regras que não são mais necessárias.

Não presuma que o agente lê o arquivo. Teste-o. Adicione uma regra que peça ao agente para declarar seu comando de teste no início de uma tarefa. Se ele o fizer, o sistema funciona.

Pare de corrigir agentes no chat. Comece a configurá-los com arquivos.

Como implementar isso:

  • Crie CLAUDE.md ou AGENTS.md na raiz do seu projeto.
  • Escreva apenas regras específicas e verificáveis.
  • Adicione uma regra imediatamente após cada erro.
  • Mantenha-o enxuto e remova regras obsoletas.

Fonte: https://dev.to/penloom_studio_829b7817d3/stop-your-ai-coding-agent-from-making-the-same-mistake-twice-a-claudemd-agentsmd-workflow-that-4k61

Comunidade de aprendizado opcional: https://t.me/GyaanSetuAi