Idea principale

Quando si lavora a lungo su un argomento con Claude Code lasciando che l'assistente scriva in un file Markdown, la domanda che finisce per porsi non è la dimensione del file, ma per chi è ordinato.

Un assistente ha bisogno di punti di riferimento per riprendere: dove si è fermato il lavoro, quali decisioni sono state prese, dove ritrovare una fonte. Gli servono sezioni stabili, identificativi, stati. Un product manager che rilegge lo stesso file cerca altro: aggregare l'informazione, validarla, risuddividerla per tema o per livello di rischio per poter decidere. Non sono due presentazioni della stessa struttura, sono due strutture.

Tenerle entrambe in un solo file non produce quindi un compromesso, ma un documento che ciascuno dei due lettori deve attraversare ignorandone metà. Sdoppiare il file — uno per l'assistente, uno per l'essere umano — rimanda il problema senza risolverlo: entrambi si gonfiano, e ciascuno finisce per contenere un po' di tutto, fonti, decisioni, ipotesi e direttive mescolate nello stesso flusso. La suddivisione che regge non si fa per destinatario, si fa per natura del contenuto.

Perché è importante

Individua il passaggio che si salta quando si va dal file unico al sistema di file. Prima si crede di avere un problema di volume, poi di pubblico; in realtà è un problema di tipi di oggetti, e finché non lo si è visto si moltiplicano file che tornano tutti a essere contenitori indistinti.

Offre anche un criterio di rilettura semplice per un documento di lavoro condiviso con un assistente: chiedersi a chi serve ogni sezione, e contare quante ne servono a entrambi.

Sfumature e limiti

Un documento breve sfugge alla regola. Finché un file si legge per intero in un minuto, il disordine non costa nulla, e imporgli una struttura costa più di quanto renda.

E la separazione ha un prezzo: due strutture da mantenere finiscono per non essere più allineate, e una delle due smette di essere riletta.

Domande aperte

• Come verificare che la versione destinata all'essere umano non sia rimasta indietro rispetto a quella che l'assistente aggiorna a ogni sessione?