Evita che gli agenti di coding AI ripetano gli stessi errori
Gli agenti di coding AI come Claude Code o Cursor spesso commettono gli stessi errori. Usano il test runner sbagliato. Usano lo stile di importazione errato. Li correggi in chat, ma dimenticano la correzione nella sessione successiva.
La cronologia della chat non è memoria. Quando una sessione termina, le tue correzioni svaniscono.
La soluzione è semplice. Scrivi le tue regole in un file che l'agente legge ogni volta che viene eseguito.
La maggior parte degli strumenti supporta file di istruzioni nella root del progetto: • Claude Code legge CLAUDE.md. • Cursor usa .cursor/rules/*.mdc. • Molti strumenti utilizzano lo standard AGENTS.md.
Questi file vengono inseriti all'inizio del contesto del modello. Le regole esistono prima che il modello scriva qualsiasi codice.
Non scrivere obiettivi vaghi. Non dire all'agente di scrivere "clean code". Le regole vaghe non funzionano. Usa invece regole specifiche e testabili.
Usa questa struttura per il tuo file di regole:
• Commands: Definisci esattamente come eseguire test e typecheck. • Style: Specifica ESM rispetto a CommonJS o named exports rispetto ai default. • Boundaries: Segna le cartelle come di sola lettura o definisci dove risiedono i segreti. • Definition of Done: Stabilisci che ogni nuova funzionalità deve avere prima un test fallito.
Un buon file di regole agisce come un registro degli errori (scar log). Ogni volta che un agente commette un errore, aggiungi una regola di una riga al file nella stessa sessione.
Mantieni il file breve. Se il file delle regole è troppo lungo, entrerà in competizione con il tuo codice per l'attenzione del modello. Se una regola supera le 200 righe, tagliala. Rimuovi le regole che non sono più necessarie.
Non dare per scontato che l'agente legga il file. Testalo. Aggiungi una regola che chieda all'agente di dichiarare il suo comando di test all'inizio di un task. Se lo fa, il sistema funziona.
Smetti di correggere gli agenti in chat. Inizia a configurarli tramite file.
Come implementarlo:
- Crea CLAUDE.md o AGENTS.md nella root del tuo progetto.
- Scrivi solo regole specifiche e verificabili.
- Aggiungi una regola immediatamente dopo ogni errore.
- Mantienilo snello e rimuovi le regole obsolete.
Community di apprendimento opzionale: https://t.me/GyaanSetuAi