Progetti e regole

Indica il nome quando salvi o cerchi, e il progetto esiste da quel momento: nessuna struttura di cartelle, nessuna configurazione; avviarne uno costa dieci messaggi. Ogni progetto ha la propria memoria, le proprie conoscenze e il proprio focus, definito da uno scopo in una sola riga. Localmente, l’archiviazione è il tuo disco e affare tuo; se hosted, il tuo piano prevede una quantità fissa e se ne può aggiungere altra quando ne hai bisogno. La memoria della tua applicazione è semplicemente un altro progetto, che funziona sulla stessa infrastruttura.

Ogni progetto è un esperto a sé stante. Ha la propria memoria, le proprie regole, la propria storia di decisioni. Quando si apre una sessione, il proprio agente arriva già informato: sulle regole, sulla situazione attuale, su ciò che è stato deciso la settimana scorsa. Non c’è bisogno di spiegare di nuovo né di ricordarglielo: le informazioni necessarie sono già presenti.

Il minuto che finanzia il resto del progetto

Il minuto più prezioso nel utilizzo di questo strumento è quello che si impiega per definire le regole di un progetto. Scrivetele una volta: come viene svolto il progetto, cosa è importante, cosa evitare – e ogni sessione successiva le conoscerà automaticamente.

Non si racconta mai due volte la storia del proprio progetto, né a un nuovo agente né su un altro computer. Quel minuto viene trascorso una sola volta, e l’agente che arriverà domani lo sa già.

Note: dove si è interrotta l’ultima sessione

Il vostro agente redige da solo l’handover: in che fase si trova il lavoro, cosa è in corso, cosa verrà fatto dopo; una nota per sessione per progetto, con le ultime cinque note conservate. La sessione successiva inizia con essa. Avviate il PC, dite “continue”, e il lavoro riprende da dove si era interrotto.

Lo strato del team, secondo le tue condizioni

Quando condividi, condividi alle tue condizioni. Con la memoria ospitata, una chiave non deve essere onnipotente. Limitala ai progetti scelti, in sola lettura o lettura-scrittura — la forma giusta per un collaboratore esterno, un job CI o un agente monouso che non ha motivo di vedere il resto del tuo lavoro. Il tuo brain, le tue regole, le tue chiavi.

Team umani. Un appaltatore riceve una chiave che gli consente di accedere solo al progetto del cliente e a nient’altro. Quando il contratto termina, si revoca una chiave, senza dover gestire la memoria condivisa.

Flotte di agenti. Un lavoro su CI, un bot per la ricerca, un agente a scopo specifico: ognuno riceve esattamente la memoria di cui ha bisogno per svolgere il proprio compito. Un agente che può solo leggere non può mai eliminare nulla.

Molti sistemi di fissaggio, una memoria. Esegui Claude Code, OpenClaw e Codex sullo stesso Brain, ma assegna a ciascuno una chiave diversa, in base al grado di fiducia che nutri nei loro confronti. L’agente autonomo sempre attivo che comunica con il mondo esterno avrà accesso solo in lettura a un progetto; lo strumento che utilizzi quotidianamente avrà accesso a tutto. Memoria condivisa senza Raggio d’impatto condiviso: il problema che affligge ogni sistema a più agenti, risolto dove deve essere risolto.

La cancellazione è intenzionale

L'eliminazione è intenzionale. Tutto ciò che memorizzi puoi eliminarlo — un progetto, una frase esatta o l'intero account, dal pannello, dietro la tua identità. Eliminare un progetto porta con sé la sua cronologia; eliminare l'account distrugge interamente la memoria crittografata. Ciò che gli agenti possono o non possono toccare è una questione a parte, e più sotto trovi una risposta breve.

Il divario tra dire che si farà qualcosa e farla davvero è lì che il lavoro muore silenziosamente. Il Ledger colma quella lacuna. Poiché le tue conversazioni vengono archiviate, esso rileva le intenzioni e le trasforma in righe pronte per te.

Di’ “controlla il registro” e il tuo agente porta le righe una per una — tu rispondi a ciascuna con una sola parola. Quelle con cui hai finito spariscono; le altre restano finché non le gestisci — o finché un lavoro successivo le mostra completate, abbandonate o superate, ed escono da sole. Nessuno stato, nessuna lavagna stantia; la pila si può solo ridurre. Niente di ciò che intendevi fare sparisce in silenzio.

La memoria di un progetto è privata di quel progetto. Una procedura appartiene a tutto ciò che fai. Scrivi un playbook in markdown una volta, conservalo per l’intero account, e qualsiasi agente in qualsiasi progetto su qualsiasi macchina può recuperarlo e seguirlo — il deploy, il rapporto settimanale, l’esecuzione della traduzione, fatti sempre allo stesso modo.

Si scrive il flusso di lavoro una volta sola e non più. I playbook non vengono mai potati. L'esempio pratico è l'atlante: il tuo agente disegna la mappa dell'intero sistema sotto forma di playbook, e una regola indica a ogni sessione che è lì. Playbook e atlante →

Ogni progetto è isolato. Ha i propri registri curati, le proprie regole, il proprio grafico, le proprie note, il proprio piano, il proprio registro contabile. Le regole generali valgono per tutti i progetti e si applicano a ciascuno di essi; le regole specifiche di un progetto, invece, riguardano soltanto quel progetto. I manuali di procedura rappresentano l'unico elemento condiviso tra tutti i progetti, poiché una procedura scritta una volta deve poter essere utilizzata ovunque.

Due client significano due progetti e due chiavi. Sulla memoria hosted, una chiave con ambito limitato a un progetto non può vederne un altro, non può cercarvi dentro e non può essere informata della sua esistenza. Le uniche cose che attraversano i confini sono quelle che richiedi tu: una ricerca fatta senza indicare un progetto, e il proposer quando ritiene che una sessione sia stata archiviata nel posto sbagliato.

Niente sanguina, a meno che non lo si chieda.

Le regole sono istruzioni permanenti, caricate con la maggior parte dei messaggi. Il resto del briefing arriva all’inizio della sessione: di cosa tratta ciascun progetto, dove si erano interrotte le sessioni precedenti, e un indice di ciò che è già noto – tutto già disponibile per l’agente prima ancora che risponda. Impostate regole per tutto ciò che fate, o per un singolo progetto; tali regole influenzano il modo in cui ogni agente opera, ovunque. Salvare o modificare una regola costa un messaggio; eliminarla è gratuito.

Le regole sono il programma del curatore.

Mentre lavori, la memoria legge ciò che è stato detto e conserva ciò che una sessione futura richiederebbe: le decisioni salvate, i fatti modificati integrati, le affermazioni superate dalla realtà eliminate. Le tue regole sono il programma che le indica cosa conta. Scrivi la legge una volta, ed essa viene applicata senza che occorra chiederlo.

Non ne archivi mai uno.

Nessun salvataggio, nessuna etichetta, nessun rituale del tipo "ricorda il mio contesto". La curatela avviene mentre lavori, non quando ti ricordi di chiederla. Non archivi mai nulla — e la memoria fa il suo lavoro che qualcuno si ricordi o meno di interrogarla. Un archivio che l'agente deve essere pregato di controllare vale solo quanto la disponibilità del modello a chiedere; questo fa il lavoro da sé.

L'unica cosa che nessun modello può toccare

L'archivio delle conversazioni grezze è la registrazione originale ed è fuori dalla portata di ogni agente. La minaccia è il tuo stesso agente — un errore, o un'istruzione dannosa nascosta in qualcosa che gli è stato chiesto di leggere — eppure non può eliminare nemmeno un messaggio né toccare la tua cronologia recente. L'archivio resta tuo.

← Come funziona Dì al tuo agente di installarlo