15 settembre 2026
Perché la tua AI scrive codice mediocre (e come farla lavorare davvero bene nel tuo repo)
Se la tua AI ripete sempre gli stessi errori, spesso non è colpa del modello: è colpa della configurazione che gli stai inviando a ogni richiesta. In molti progetti l’Agent.md (o Claude.md/Gemini.md) diventa una discarica di regole, checklist, convenzioni duplicate e istruzioni non pertinenti. Risultato: contesto enorme, token sprecati, qualità che cala e decisioni incoerenti. In questo articolo vediamo come strutturare correttamente i file di contesto: tenere l’Agent.md piccolo, spostare le convenzioni in documenti dedicati, usare link interni per caricare solo ciò che serve e mantenere una descrizione del repo ad alto livello per evitare documentazione che invecchia male. Con una strategia incrementale (aggiungere regole solo quando emergono problemi reali) ottieni output più prevedibili e più “in stile progetto”.