Evita que los agentes de codificación de IA cometan los mismos errores
Los agentes de codificación de IA como Claude Code o Cursor suelen cometer los mismos errores. Utilizan el ejecutor de pruebas (test runner) incorrecto. Utilizan el estilo de importación incorrecto. Los corriges en el chat, pero olvidan la corrección en la siguiente sesión.
El historial del chat no es memoria. Cuando una sesión termina, tus correcciones desaparecen.
La solución es sencilla. Escribe tus reglas en un archivo que el agente lea cada vez que se ejecute.
La mayoría de las herramientas admiten archivos de instrucciones en la raíz del proyecto: • Claude Code lee CLAUDE.md. • Cursor utiliza .cursor/rules/*.mdc. • Muchas herramientas utilizan el estándar AGENTS.md.
Estos archivos se anteponen al contexto del modelo. Las reglas existen antes de que el modelo escriba cualquier código.
No escribas objetivos vagos. No le digas al agente que escriba "clean code". Las reglas vagas no funcionan. En su lugar, utiliza reglas específicas y comprobables.
Utiliza esta estructura para tu archivo de reglas:
• Commands: Define exactamente cómo ejecutar las pruebas y las comprobaciones de tipos (typechecks). • Style: Especifica ESM sobre CommonJS o exportaciones con nombre (named exports) sobre las predeterminadas (defaults). • Boundaries: Marca carpetas como de solo lectura o define dónde se encuentran los secretos. • Definition of Done: Establece que cada nueva funcionalidad debe tener primero una prueba que falle.
Un buen archivo de reglas actúa como un registro de cicatrices (scar log). Cada vez que un agente cometa un error, añade una regla de una sola línea al archivo en esa misma sesión.
Mantén el archivo corto. Si tu archivo de reglas es demasiado largo, competirá con tu código por la atención del modelo. Si una regla supera las 200 líneas, recórtala. Elimina las reglas que ya no sean necesarias.
No asumas que el agente lee el archivo. Pruébalo. Añade una regla que pida al agente que indique su comando de prueba al inicio de una tarea. Si lo hace, el sistema funciona.
Deja de corregir a los agentes en el chat. Empieza a configurarlos con archivos.
Cómo implementarlo:
- Crea CLAUDE.md o AGENTS.md en la raíz de tu proyecto.
- Escribe solo reglas específicas y comprobables.
- Añade una regla inmediatamente después de cada error.
- Mantén el archivo ligero y elimina las reglas obsoletas.
Comunidad de aprendizaje opcional: https://t.me/GyaanSetuAi