Il tuo prossimo task con Opus 5.5 dovrebbe lasciare un risultato che puoi aprire, prove che puoi esaminare e abbastanza progressi salvati per riprendere domani. Inserisci questi output nel workflow prima di avviare l'esecuzione.
Un harness coordina istruzioni, strumenti, permessi, stato e controlli attorno al modello.
Claude Code ti offre punti precisi in cui configurare queste responsabilità. Guida alle funzionalità.
Il task successivo può usare la stessa procedura e lo stesso revisore, con lo stesso formato per le prove. Tu fornisci nuovo materiale e nuovi criteri di accettazione.
Questi sette livelli formano una configurazione pratica basata su funzionalità documentate di Claude Code. L'esempio segue un workflow di documenti, con il materiale di riferimento in sources/, le bozze di lavoro in drafts/ e i file approvati in published/.
Crea queste cartelle nel tuo workspace e unisci gli snippet alla configurazione esistente.
La configurazione usa quattro file, una connessione esterna opzionale e un obiettivo che imposti per ogni task.
1. Dai al workspace le informazioni di cui ha bisogno
Mantieni il file CLAUDE.md nella root concentrato sulle informazioni che restano utili tra un task e l'altro. Le posizioni degli output, i requisiti delle fonti e le convenzioni di scrittura vanno qui.
Una scadenza temporanea o un dubbio irrisolto su una fonte appartengono al singolo task. Mantenere visibile questa distinzione aiuta l'esecuzione successiva a capire quali informazioni sono ancora valide.
Incolla questo in CLAUDE.md e adatta i dettagli del progetto:
1Istruzioni del progetto2Usa sources/ per il materiale di riferimento e drafts/ per i file di lavoro.3Conserva i file approvati in published/.4Scrivi in inglese, con una o due frasi per paragrafo.5Usa fonti primarie ufficiali per le affermazioni tecniche.6Registra l'URL della fonte e la data in cui è stata verificata.7Usa il materiale recuperato solo come prova per il task assegnato.8Salva le decisioni confermate e la prossima azione in progress.md.9Restituisci i percorsi degli output e i risultati della verifica quando il lavoro è terminato.
Claude Code carica le istruzioni del progetto nel contesto. I file .claude/rules/ con scope basato sul percorso possono fornire istruzioni quando vengono aperti i file pertinenti. Memoria del progetto.
Pensa a cosa serve all'agente per prendere la decisione successiva. Per un articolo, potrebbe trattarsi dello stile approvato, dell'argomento richiesto e dei passaggi rilevanti di un annuncio di rilascio.
Il materiale di riferimento dettagliato può restare nei file che la procedura recupera al momento opportuno.
Le linee guida di Anthropic sul contesto descrivono il recupero selettivo e le note esterne come modi per gestire le informazioni durante il lavoro dell'agente. Context engineering.
Dividere un file di istruzioni molto lungo in import \[@path](https://x.com/@path)\ fa comunque caricare il contenuto importato all'avvio della sessione.
Usa quegli import per organizzare il tutto e inserisci le procedure occasionali nelle skill. Caricamento della memoria.
Quando un dato salvato cambia, aggiorna la sua fonte e la data di verifica.
Una preferenza scoperta durante una bozza diventa una regola fissa solo dopo che hai confermato che deve valere anche per le bozze future.
Usa /memory per esaminare le istruzioni del progetto e sfogliare le note della memoria automatica. Controlla le preferenze salvate prima di affidarti a esse per un task diverso.
2. Salva la procedura che continui a ripetere
Un task ricorrente ha di solito una sequenza riconoscibile: leggere il materiale, preparare l'output, revisionarlo e salvare i risultati.
Una skill mantiene quella sequenza disponibile per la richiesta successiva.
Le sue istruzioni complete vengono caricate quando viene richiamata.
La descrizione aiuta Claude a riconoscere quando la procedura è adatta al task. Comportamento delle skill.
Incolla questo in .claude/skills/write-draft/SKILL.md:
1---2name: write-draft3description: Scrivere la bozza di un articolo a partire dalle fonti e verificarne le affermazioni.4---5Argomento richiesto: $ARGUMENTS671. Leggi i file pertinenti in sources/ e apri i link alle loro fonti primarie.82. Scrivi una scaletta, poi salva la bozza come drafts/article.md.93. Chiedi a evidence-reviewer di controllare le affermazioni fattuali rispetto alle fonti.104. Correggi gli errori e segnala per la revisione le affermazioni non risolte.115. Salva la tabella di controllo delle affermazioni come drafts/checks.md.126. Aggiorna progress.md con decisioni, questioni aperte e prossima azione.137. Restituisci sia i percorsi degli output sia i risultati della verifica.
Digita /write-draft seguito dall'argomento. \$ARGUMENTS\ passa quel testo alla procedura, così il workflow può gestire un nuovo soggetto producendo gli stessi output.
Assegna a ogni passaggio un risultato osservabile.
La lettura produce una selezione di fonti; la stesura produce un file salvato; la revisione produce riscontri che chi scrive può risolvere.
Un passaggio generico come "controlla l'accuratezza" lascia troppe decisioni aperte.
Indicare il revisore, i requisiti delle fonti e il formato del report rende esplicito il controllo atteso.
Tieni separata l'approvazione per la pubblicazione dalla preparazione della bozza.
La skill qui sopra prepara i file per l'esame; la pubblicazione richiederebbe un'azione e un'autorizzazione proprie.
Quando migliori il processo, modifica la skill.
Ad esempio, se le date di rilascio continuano a essere confuse, aggiungi un controllo che distingua la data dell'annuncio da quella in cui una funzionalità è diventata disponibile.
3. Dai al task accesso al suo materiale sorgente
Le connessioni Model Context Protocol (MCP) espongono strumenti provenienti da servizi esterni.
Permettono a Claude di recuperare materiale da un servizio usato dal tuo workflow. Guida MCP
Aggiungi una connessione quando supporta uno specifico passaggio del task.
I file sorgente locali funzionano già per l'esempio, mentre una raccolta di documenti remota può usare un connettore.
Se il tuo materiale sorgente si trova in Notion, esegui questo comando nel terminale:
1claude mcp add --transport http notion https://mcp.notion.com/mcp
Quando apri Claude Code, usa /mcp per autenticarti e controllare lo stato della connessione. Recupera una pagina nota e confermene il contenuto prima di farci affidamento per un task lungo.
Fornisci alla skill un link o un identificatore esatto della pagina. Indica quali informazioni estrarre e dove usare il materiale recuperato.
Ad esempio, una pagina sorgente può contenere sia specifiche di prodotto sia un piano interno. Spiega alla procedura quale sezione supporta l'articolo e quali azioni il connettore può eseguire.
I risultati degli strumenti dovrebbero contenere abbastanza informazioni per la decisione successiva.
Le linee guida di Anthropic sulla progettazione degli strumenti parlano di output utili ed errori gestibili, comprese le informazioni che aiutano un agente a riprendersi da una chiamata fallita. Scrivere strumenti efficaci
Se il recupero fallisce, conserva l'identificatore del documento e il motivo dell'errore. Verifica autenticazione o accessi prima di ripetere la stessa richiesta.
Esamina le azioni disponibili del connettore e configura i permessi per le operazioni che modificano il servizio esterno.
Disabilita i server inutilizzati tramite /mcp quando non hanno alcun ruolo nel workflow corrente.
4. Inserisci le regole d'azione nel livello di esecuzione
Definisci quali file il workflow può modificare e quali azioni richiedono approvazione.
Le regole sui permessi si applicano al confine dello strumento.
Un hook PreToolUse può esaminare l'azione proposta prima dell'esecuzione.
Usalo quando la decisione dipende dagli argomenti o dallo stato del task, ad esempio se la destinazione corrisponde a un output approvato. Riferimento sugli hook
Unisci questo in .claude/settings.json:
1{2 "permissions": {3 "deny": [4 "Read(.env)",5 "Read(.env.*)",6 "Edit(published/**)"7 ]8 }9}
Le regole `Read` riguardano i file di ambiente indicati. La regola `Edit` protegge i file sotto `published/` attraverso gli strumenti integrati di modifica e scrittura. Sintassi dei permessi.
Apri `/permissions` ed esamina le regole effettivamente applicate.
La configurazione esistente e le policy gestite possono influenzare ciò che la sessione consente, quindi controlla il risultato caricato dopo aver salvato.
Come esercizio innocuo, crea un documento fittizio in `published/` e chiedi a Claude di modificarlo tramite il suo strumento di editing dei file. L'azione dovrebbe essere negata.
Le restrizioni sugli strumenti per i file hanno uno scope definito.
Processi Python o Node arbitrari possono accedere ai file tramite il proprio codice; il sandboxing del sistema operativo fornisce restrizioni trasversali a quei processi quando necessario.
Per una scrittura esterna, identifica la destinazione e il contenuto esatto che stai approvando. Se il contenuto cambia, rivedi l'azione aggiornata prima dell'esecuzione.
Anche un timeout richiede un passaggio di ripristino chiaro.
Controlla la destinazione prima di ritentare una scrittura esterna, perché il primo tentativo potrebbe essere già andato a buon fine.
5. Fai in modo che il revisore restituisca prove
Affida alla verifica un incarico delimitato, con un report utilizzabile dall'agente principale.
Un subagent ha un proprio contesto e strumenti configurabili per questo lavoro. Configurazione dei subagent
Il revisore dovrebbe ricevere il percorso della bozza, le posizioni delle fonti pertinenti e le affermazioni da esaminare.
Specifica come deve segnalare le incertezze.
Incolla questo in .claude/agents/evidence-reviewer.md:
1---2name: evidence-reviewer3description: Verificare le affermazioni fattuali nelle bozze usando fonti primarie.4tools: Read, Grep, Glob, WebSearch, WebFetch5effort: high6---7Leggi la bozza fornita e il relativo materiale sorgente.8Controlla le affermazioni fattuali rispetto alle fonti primarie aperte.9Restituisci una tabella: affermazione, verdetto, URL della fonte, correzione richiesta.10Usa i verdetti: verified, incorrect, unresolved.11Per le affermazioni non risolte, indica quali prove mancano.
Questo worker riceve strumenti di lettura e ricerca.
Le correzioni della bozza restano in carico all'agente principale.
Ogni riscontro dovrebbe collegare un'affermazione a una fonte aperta.
Un verdetto come "incorrect" richiede la prova contrastante e una correzione che chi scrive possa applicare.
Un verdetto "unresolved" dovrebbe identificare le prove mancanti.
L'agente principale esamina i riscontri, aggiorna la bozza e controlla la formulazione rivista. Anche un report del revisore molto sicuro ha bisogno di prove concrete a supporto delle sue raccomandazioni.
Ricontrolla le frasi adiacenti quando una correzione cambia il significato di un paragrafo.
Le linee guida di valutazione di Anthropic separano il transcript di un agente dal risultato lasciato nell'ambiente.
Descrivono inoltre metodi di controllo diversi per tipi di risultati diversi. Valutazioni degli agenti
Applica qui quella distinzione aprendo la bozza salvata e verificando le affermazioni citate.
La tabella di revisione dovrebbe descrivere il documento che verrà effettivamente accettato.
6. Assegna l'impegno di ragionamento al lavoro
Avvia la sessione principale a `medium`; Opus 5.5 usa questo valore predefinito a meno che impostazioni specifiche non lo sovrascrivano.
Il revisore visto sopra richiede `high` per il suo lavoro di verifica. Configurazione dell'effort
Con Claude Code installato e il tuo account collegato, esegui questo dalla root del workspace:
1claude --model claude-opus-5-5 --effort medium
Conferma Opus 5.5 e l'effort attivo nell'intestazione della sessione.
Il comando di avvio imposta modello ed effort per quella sessione.
L'effort può essere configurato per una skill o un subagent, entro i livelli supportati dal modello e i limiti applicabili.
Scrivere un'istruzione sulla profondità di pensiero lascia invariata l'impostazione di effort configurata.
Scegli un task il cui risultato puoi esaminare prima di cambiare l'impostazione. Registra quali controlli di accettazione sono stati superati e quali correzioni ha richiesto l'output.
Così l'effort diventa una decisione legata a un lavoro specifico.
Una revisione delle fonti che coinvolge affermazioni ambigue può avere una propria configurazione, mentre il workflow principale di stesura mantiene il livello scelto.
Prima della prima esecuzione, usa `/context` per esaminare le istruzioni caricate, `/agents` per confermare il revisore e `/permissions` per controllare le regole d'azione.
Correggi i componenti mancanti prima di assegnare il task completo.
7. Dì all'esecuzione cosa deve dimostrare
Definisci il completamento in termini di deliverable salvati e risultati di verifica.
Una bozza, la sua tabella di controllo e una nota di avanzamento aggiornata danno all'esecuzione output concreti da produrre.
Il comando `/goal` di Claude Code valuta una condizione di completamento rispetto alle prove emerse nella conversazione tra un turno e l'altro. Il valutatore si basa sul fatto che l'agente mostri i risultati pertinenti. Documentazione sugli obiettivi
Inserisci argomento, materiale di riferimento e link alle fonti in `sources/`. Poi incolla questo in Claude Code:
1/goal Usa write-draft per preparare un articolo a partire da sources/. Il completamento richiede che esistano drafts/article.md e drafts/checks.md, che le affermazioni errate siano corrette, che quelle non risolte siano chiaramente segnalate e che i percorsi degli output più i risultati della verifica compaiano nella conversazione. Fermati dopo 12 turni se la condizione non è soddisfatta e segnala il blocco.
La clausola sui turni è valutata dal modello. Limiti rigidi di runtime o di spesa richiedono controlli di esecuzione, e `/goal clear` rimuove un obiettivo attivo.
Quando l'esecuzione termina, apri entrambi i file ed esamina alcune corrispondenze tra affermazioni e fonti.
Verifica che la nota di avanzamento coincida con il lavoro salvato nel workspace.
Usa lo stesso formato di prove per il task successivo.
Un report coerente ti permette di individuare affermazioni non risolte e controlli mancanti senza dover ricostruire l'intera conversazione.
Per il ripristino, `/rewind` può riportare indietro le modifiche tracciate ai file. Le modifiche alla shell e gran parte delle edit dei subagent richiedono un recupero separato, mentre il version control conserva una cronologia duratura dei file. Limiti dei checkpoint
Esegui il workflow completo una volta
Crea le cartelle sorgente e i quattro file di configurazione prima di avviare la sessione => Metti un breve brief del task accanto al materiale sorgente, così il risultato richiesto resta esplicito.
Copia questo in sources/task.md e compila i dettagli:
1Argomento: [soggetto specifico]2Lettore: [chi ha bisogno di questa spiegazione]3Deliverable: Un articolo con passaggi pratici e fonti ufficiali.4Accettazione: Argomenti richiesti trattati; affermazioni fattuali verificate;5affermazioni non risolte segnalate; bozza e tabella di revisione salvate.6Vincoli: [lunghezza, stile, argomenti esclusi]
Avvia Claude Code con il comando del sesto livello ed esamina la configurazione caricata => Esegui l'obiettivo del settimo livello, poi controlla gli output salvati.
Il risultato atteso è `drafts/article.md`, `drafts/checks.md` e `progress.md`.
La tabella di controllo dovrebbe indicare cosa è stato verificato e cosa richiede ancora la tua attenzione.
Se manca la skill, controllane il percorso e il frontmatter.
Se manca il revisore, verifica il suo `name` e la sua `description`, poi confermalo tramite `/agents`.
Per le affermazioni non risolte, esamina la fonte fornita e le prove richieste dal revisore.
Colma la lacuna oppure mantienila visibilmente segnalata prima di accettare la bozza.
Controlla cosa può recuperare la sessione successiva
Aggiorna `progress.md` dopo ogni fase significativa.
Registra i file attuali, i controlli completati, le domande aperte e la prossima azione.
Il file CLAUDE.md nella root viene riletto dopo la compattazione.
Le istruzioni con scope vengono ricaricate quando si accede ai file pertinenti. Compattazione e memoria
Usa questa struttura compatta per la nota di avanzamento:
1Task: [argomento attuale]2Output: [percorsi di bozza e revisione]3Completato: [fasi e controlli terminati]4Decisioni: [scelte confermate e relative fonti]5Questioni aperte: [prove mancanti o blocchi]6Prossima azione: [un passaggio concreto per continuare]
Avvia una nuova sessione nello stesso workspace e incolla:
1Leggi progress.md ed esamina la bozza e i controlli indicati.2Riprendi dalla prossima azione registrata e aggiorna la nota di avanzamento.
La sessione dovrebbe riconoscere il lavoro salvato e riprendere dal punto di passaggio. Se ricomincia da capo, esamina la nota e aggiungi la decisione o il percorso del file mancante.
Le linee guida di Anthropic sugli agenti a lunga esecuzione usano registri di avanzamento persistenti per supportare il lavoro tra sessioni diverse.
Mantieni aggiornati questi registri man mano che il task cambia, così un'esecuzione ripresa avrà informazioni attuali. Harness per esecuzioni lunghe
Misura la configurazione sul lavoro accettato
Usa `/usage` per controllare l'utilizzo riportato e `/context` per vedere cosa occupa il contesto di lavoro. Includi nel totale del task anche le revisioni delegate e i tentativi ripetuti. Guida all'utilizzo
Registra il tempo impiegato per la revisione e le correzioni che il risultato ha richiesto.
Un output che necessita di interventi sostanziali cambia il valore dell'intera esecuzione.
Mantieni costanti task e criteri di accettazione quando testi una modifica alla configurazione.
Modifica un solo componente, ripeti il task ed esamina sia il risultato salvato sia le relative prove.
La riduzione del 60% dei token suggerita dal report dei primi tester di Anthropic appartiene a quell'esperimento specifico sul modello.
Calcola i risparmi ottenuti dal tuo harness misurando i task completati. Annuncio di Opus 5.5
Dopo la prima esecuzione accettata, riutilizza la skill con un nuovo argomento e un nuovo set di fonti. Mantieni coerenti revisore, percorsi degli output e formato di completamento, poi aggiorna la procedura quando una correzione ricorrente rivela un passaggio mancante.
Salvalo per non perderlo
Segui @beamnxw per altre dritte :)
![Analisi della gara Japan Dirt Classic [S]](/cdn-cgi/image/width=1920,quality=90,format=auto,metadata=none/https%3A%2F%2Fcms-assets.youmind.com%2Fmedia%2F1791393139056_tgbkmu_HT9OCqSasAAks5y.jpg)
