Anthropic butta l’80% delle istruzioni di Claude Code. E ha ragione.

C’è una cosa che tutti noi che lavoriamo con l’AI abbiamo fatto almeno una volta: scrivere un file di istruzioni lunghissimo. Pagine di regole, format, comportamenti da avere e da evitare. Più righe, pensavamo, più controllo. Anthropic ha appena dimostrato che stavamo sbagliando approccio, e lo ha fatto cancellando l’80% del proprio sistema di prompt interno per Claude Code.

Non è una questione di pulizia estetica. È una scoperta metodologica: i nuovi modelli come Opus 5 e Fable 5 vengono degradati dalle istruzioni rigide. Come un musicista jazz a cui dai uno spartito troppo dettagliato: il risultato è più meccanico, non migliore.

“Le istruzioni rigide e i lunghi file markdown limitanti peggiorano le risposte dei nuovi modelli dotati di capacità di giudizio autonomo. La divulgazione progressiva del contesto produce risultati superiori.”

Cosa sta cambiando nel prompt engineering

Per anni il mantra era: più sei specifico nelle istruzioni, meglio si comporta il modello. Funzionava. Con i modelli della generazione precedente, quella precisione chirurgica era necessaria perché il modello non riusciva a ragionare sul contesto: dovevi dirgli esattamente cosa fare in ogni scenario.

I nuovi modelli cambiano questa equazione radicalmente. Opus 5 e Fable 5 hanno capacità di giudizio autonomo: capiscono il contesto, inferiscono le intenzioni, si adattano alla situazione. Quando li sovraccarichi di istruzioni rigide, li stai di fatto disturbando. È come dare troppe indicazioni stradali a qualcuno che conosce la città meglio di te.

• Vecchio approccio: istruzioni dettagliate per ogni scenario, file .md lunghi e prescrittivi
• Nuovo approccio: contesto progressivo, il modello riceve le informazioni man mano che servono
• Effetto collaterale: i prompt system gonfi non solo non aiutano, ma degradano attivamente le risposte
• Conseguenza: i tuoi file CLAUDE.md scritti con cura potrebbero essere controproducenti

1. 80% del prompt di sistema di Claude Code eliminato in un colpo solo
2. 2 modelli di nuova generazione che hanno innescato il cambio: Opus 5 e Fable 5
3. 1 nuovo strumento rilasciato: claude doctor, per diagnosticare e alleggerire i file di istruzione

Il caso pratico: claude doctor

Anthropic ha rilasciato un nuovo comando terminale: claude doctor. Analizza i file di configurazione degli sviluppatori, i famosi CLAUDE.md, e suggerisce cosa tagliare. Non è un tool secondario: è il segnale più chiaro che questo cambio di paradigma riguarda tutti. Se hai accumulato strati di istruzioni nel tempo, e chi usa Claude Code seriamente lo fa, questo è il punto di partenza per il reset. Il messaggio implicito è forte: se persino Anthropic ha tagliato l’80% delle proprie istruzioni, probabilmente anche tu stai sovraccaricando il modello che usi ogni giorno.

“Non stai dando più potere al modello con più regole. Stai costruendo una gabbia. I nuovi modelli hanno bisogno di spazio per ragionare, non di un manuale operativo di 200 righe.”

Tre cose che mi porto via

1. Meno istruzioni rigide non significa meno controllo: significa più fiducia nel giudizio del modello, che con i nuovi LLM funziona meglio delle regole esplicite
2. Se usi Claude Code con file di configurazione accumulati nel tempo, claude doctor è la prima cosa da eseguire questa settimana
3. Il prompt engineering non è morto: si sta evolvendo dalla lista di regole alla cura del contesto

Scrivere meno e ottenere di più. C’è qualcosa di soddisfacente nel fatto che la risposta a “come faccio a controllare meglio l’AI” sia spesso semplicemente: togli, non aggiungere.

Leggi l’analisi su AI Weekly

✍️ Articolo firmato da “La Redazione”: sistema editoriale multi-agente (AI) orchestrato con Claude Code e supervisionato da Luca Cazzaniga · lucacazzaniga.it