Ho già scritto in precedenza su come fare prompt nel modo migliore per la nuova generazione di modelli Claude 5 e lavorare con loro in modo iterativo per scoprire cosa vuoi costruire.
Ma quando invii un messaggio a Claude, il prompt è solo una piccola parte del contesto che riceve. Gran parte del tuo contesto viene assemblato dal tuo system prompt, dalle Skills, dai file CLAUDE.md, dalla memoria e da altre fonti. Chiamiamo questo processo context engineering, e ha un grande impatto sui risultati che ottieni quando usi Claude Code o quando costruisci i tuoi agenti.
A differenza di un prompt, il contesto viene usato in generale per molte richieste, quindi non può essere troppo specifico. Come si costruiscono questi prompt e linee guida generali per Claude, specialmente quando non si sa quale potrebbe essere il prompt di un utente?
Questo può essere sorprendentemente difficile man mano che le capacità di Claude si evolvono. Più recentemente, abbiamo notato un grande salto nel modo in cui facciamo prompt per la nuova generazione di modelli Claude. Abbiamo rimosso oltre l'80% del system prompt di Claude Code per modelli come Claude Opus 5 e Claude Fable 5 senza alcuna perdita misurabile nelle nostre valutazioni di coding.
Ecco cosa abbiamo imparato sul fare prompt per questa nuova classe di modelli e come puoi usarlo per aggiornare il tuo context engineering. Abbiamo messo queste best practice in claude doctor; usa il comando /doctor in Claude Code per dimensionare correttamente le tue Skills e i file CLAUDE.md.
Sbloccare Claude
In generale, abbiamo scoperto che stavamo sovraccaricando Claude Code, sia attraverso il nostro system prompt che nei nostri file CLAUDE.md e nelle Skills.
Ad esempio, quando leggiamo le trascrizioni del nostro uso interno di Claude Code, vediamo diversi messaggi contrastanti in una singola richiesta come "lascia la documentazione dove appropriato" o "NON aggiungere commenti", mentre il nostro system prompt, le Skills e le richieste degli utenti entrano in conflitto tra loro.
In generale, Claude può interpretare l'intenzione dell'utente per arrivare alla risposta giusta, ma deve riflettere più attentamente su questi messaggi sovrapposti e contrastanti prima di decidere cosa fare.
E mentre queste limitazioni erano una volta necessarie per evitare scenari peggiori, abbiamo scoperto che possiamo eliminarne molte e lasciare che il modello usi invece il contesto circostante e il suo giudizio.
Inoltre, Claude Code ora ha molti più strumenti. Claude un tempo si affidava a CLAUDE.md come fonte di memoria, informazioni e linee guida. Ora abbiamo memoria, artefatti e Skills, che Claude può usare per creare nuovi modi di caricare e condividere il contesto tra sessioni diverse.
Prima e ora
C'erano diverse best practice di context engineering del passato che erano diventate miti. Tra cui:
**
Prima: Dare regole a Claude
Ora: Lasciare che Claude usi il giudizio
**Quando abbiamo lanciato Claude Code per la prima volta, dovevamo essere sicuri che Claude evitasse scenari peggiori, come l'eliminazione di file. Questo significava dare istruzioni particolarmente rigide che non sempre erano vere. Ad esempio, nel system prompt dicevamo:
Nel codice: per impostazione predefinita, non scrivere commenti. Non scrivere mai docstring multilinea o blocchi di commenti su più righe — massimo una riga breve. Non creare documenti di pianificazione, decisioni o analisi a meno che l'utente non li richieda — lavora dal contesto della conversazione, non da file intermedi.
Ma per un certo sottoinsieme di prompt, questa istruzione sarebbe stata sbagliata. Nel caso della documentazione, l'utente potrebbe avere le proprie preferenze, o parti specifiche di codice molto complesso potrebbero aver bisogno di blocchi di commenti su più righe.
Tuttavia, senza queste protezioni per i modelli più vecchi, i commenti scritti da Claude sarebbero stati errati in molti casi e abbiamo dovuto accettare questo compromesso. Ma i modelli più nuovi hanno un giudizio migliore e possono gestire queste decisioni bene senza regole esplicite.
Nel nuovo system prompt diciamo: Scrivi codice che si legga come il codice circostante: abbina la sua densità di commenti, la nomenclatura e lo stile.
**Prima: Dare esempi a Claude
Ora: Progettare interfacce
**La regola numero uno per l'uso degli strumenti era dare a Claude esempi su come usarli. Con i nostri modelli più recenti, abbiamo scoperto che dare esempi in realtà li vincola a un certo spazio di esplorazione.
Invece di usare esempi, pensa di più alla progettazione dei tuoi strumenti, script e file: quali parametri ha Claude e come possono essere più espressivi?
Ad esempio, nello strumento Todo, elencare semplicemente lo stato come un'enumerazione tra pending, in_progress e completed, suggerisce a Claude come usarlo. L'istruzione di mantenere un elemento in_progress aiuta a definire il comportamento richiesto.
**Prima: Mettere tutto all'inizio
Ora: Usare la divulgazione progressiva**
Poiché Claude Code era focalizzato sul coding, il nostro system prompt includeva informazioni dettagliate su come fare code review e verifica. Non erano sempre necessarie, ma quando lo erano, erano informazioni cruciali.
Da allora, Claude Code è diventato molto competente nell'usare la divulgazione progressiva, caricando il contesto giusto al momento giusto. Ad esempio, abbiamo spostato la verifica e il code review in Skills dedicate che Claude Code poteva chiamare selettivamente.
Ma la divulgazione progressiva non è solo per le Skills; la usiamo anche per gli strumenti. Alcuni dei nostri strumenti sono a 'caricamento differito', il che significa che l'agente deve cercare le loro definizioni complete usando ToolSearch prima di usarli. Questo ci permette di avere più strumenti (come i nostri strumenti Task) che non occupano contesto finché non sono necessari.
Lo stesso può essere applicato ai tuoi file CLAUDE.md e Skill.md. Un mito comune è che si voglia creare un repository centrale per ogni pratica nota che potresti incontrare, perché Claude non la troverebbe altrimenti. Invece, considera di avere un albero di file che possono essere caricati al momento giusto.
**Prima: Ripeterti
Ora: Descrizioni semplici degli strumenti**
I modelli Claude precedenti a volte avevano bisogno di istruzioni ripetute o erano più propensi ad ascoltare le istruzioni alla fine della loro finestra di contesto piuttosto che all'inizio. Questo significava che il nostro system prompt a volte aveva riferimenti agli strumenti nel system prompt principale, oltre alle istruzioni nella descrizione dello strumento.
Abbiamo scoperto di poter eliminare questi esempi ripetuti e mettere le istruzioni su come usare gli strumenti nelle descrizioni degli strumenti, piuttosto che nel system prompt.
**Prima: Memoria nei file CLAUDE.md
Ora: Memoria automatica**
Incoraggiavamo gli utenti a salvare le cose nella memoria di Claude, usando il tasto # per scrivere automaticamente nel loro CLAUDE.md. Invece, ora Claude salva automaticamente le memorie che sono rilevanti per il lavoro e per te.
**Prima: Specifiche semplici
Ora: Riferimenti ricchi**
In modalità piano, Claude Code si è sempre basato pesantemente su file markdown con piani. Salvare questi file come piani aiutava Claude a farvi riferimento quando necessario. Un'altra best practice simile era quella di memorizzare le specifiche nel codebase a cui Claude potesse fare riferimento mentre lavorava su progetti più lunghi.
Ma abbiamo scoperto che Claude può gestire riferimenti sempre più complessi. Invece di semplici file markdown, Claude può fare riferimento ad artefatti HTML creati dalla nostra nuova funzionalità di artefatti.
Puoi anche dare a Claude riferimenti sotto forma di codice. Una specifica può anche essere una suite di test dettagliata, o una funzione in un altro codebase che Claude potrebbe portare.
Le rubriche sono un'altra forma di riferimento. Le rubriche permettono a Claude di provare e verificare il tuo gusto in un campo particolare (ad esempio, come dovrebbe essere un buon design di API) usando workflow dinamici e creando agenti di verifica con quelle rubriche.
Applicare questo al tuo contesto
Mettendo tutto insieme, come si presenta quando assembli il tuo contesto?
**System Prompt
**Un system prompt è fortemente legato al contesto del prodotto. Dice a Claude in quale prodotto sta operando e cosa sta facendo. Per Claude Code, probabilmente non lo modificherai mai, ma se stai costruendo il tuo harness per agenti, è qui che dovresti investire molto tempo.
**CLAUDE.md
**Mantieni il tuo CLAUDE.md leggero e descrivi brevemente a cosa serve il tuo repo, ma spendi la maggior parte dei token sui "gotcha" all'interno del codebase. Ad esempio, potresti organizzare il tuo codice per tenere i tipi in un unico file monolitico e da nessun'altra parte. Evita di dichiarare cose 'ovvie' che Claude dovrebbe sapere guardando il tuo file system o il tuo repo.
Usa la divulgazione progressiva per maggiori dettagli; ad esempio, se hai diverse istruzioni uniche su come verificare il tuo lavoro, crea una Skill di verifica e fai riferimento ad essa dal tuo CLAUDE.md.
**Skills
**Pensa alle Skills come a guide leggere per permettere a Claude di trovare informazioni quando necessario. Evita di renderle troppo vincolanti, tranne che in aree molto importanti.
Per le Skills lunghe, cerca di usare il più possibile la divulgazione progressiva: dividile in molti file e separali.
È meglio quando le Skills codificano opinioni, conoscenze o best practice particolari che sono specifiche per te, il tuo team o il tuo prodotto.
**Riferimenti
**Puoi menzionare file con @ per includerli come riferimenti. I riferimenti permettono a Claude di consultare informazioni approfondite sul piano corrente.
Questi possono essere file di specifiche, mockup o persino interi codebase. In generale, dovresti preferire file che sono in codice, poiché forniscono istruzioni chiare e ad alta fedeltà a Claude in un linguaggio che conosce molto bene. Ad esempio, un mockup HTML di un design produrrà generalmente risultati migliori di una descrizione del design o di uno screenshot.
Prova a semplificare
Attraverso il tuo system prompt, le Skills e i file CLAUDE.md, potresti aver bisogno di semplificare proprio come abbiamo fatto noi. Abbiamo lanciato un nuovo comando chiamato claude doctor, che ti aiuterà a farlo automaticamente. Per maggiori dettagli su come fare prompt specificamente per modelli più avanzati, dai un'occhiata alla nostra guida su Fable.
