Documenti

Installato, ma apparentemente non utilizzato? Nei casi in cui la piattaforma prevede degli hook, la memoria viene inviata all'agente e non è necessario alcun addestramento. Nei casi in cui invece ciò non avviene, la configurazione scrive una sezione relativa alla memoria nel file di contesto della piattaforma stessa, in modo che l'agente sappia che deve recuperarla. Se la memoria sembra collegata, ma l'agente non la richiama mai, quel file è la prima cosa da controllare.

Cosa scrive su Claude Code

In Claude Code, il pip install (brethof-brain install-hooks) mantiene un blocco gestito nel tuo CLAUDE.md, riscritto a ogni avvio della sessione. È un puntatore, non una copia dell’insegnamento: indica al tuo agente che la memoria è Brain, come raggiungerla, e che quando dici “ricorda questo” va a Brain, e non nei file di memoria di Claude Code su una singola macchina. Il vero insegnamento arriva all’avvio della sessione. Non tocca mai nulla al di fuori del blocco: le tue convenzioni restano tue. Per disattivarlo, imposta BRETHOF_BRAIN_NO_CLAUDE_MD=1. Il plugin non lo scrive mai: con un’installazione tramite plugin, incolla il blocco dal README del plugin in ~/.claude/CLAUDE.md, oppure chiedilo al tuo agente.

Comandi e versioni

Il plugin Claude Code fornisce tre comandi: /recall (cerca ora), /onboard (il primo minuto di un progetto) e /curate (chiudi una sessione). Non c'è nulla da eseguire manualmente: la memoria si cura e si riordina da sola man mano che i record arrivano.

Ciò che cambia è il modo in cui parli con il tuo agente. Ora puoi dire cose come Cosa abbiamo deciso riguardo ai tentativi di pagamento ripetuti? or Ricordate che la scatola di stoccaggio è quella con il vecchio certificato. — In parole povere, durante una conversazione. Il tuo agente sceglie lo strumento giusto; tu non devi mai nominarne uno.

Ciò a cui può ricorrere il tuo agente

Non hai bisogno di questa lista. È qui affinché tu sappia cosa è possibile quando chiedi qualcosa di specifico.

• Trovare le cose — Cerca nella tua memoria curata, oppure nell’elenco completo degli scambi di conversazione, quando hai bisogno delle parole esatte di una sessione passata.
• Ricordare le cose — Salva un fatto in un progetto, o nello strato condiviso che comprende tutti loro.
• Insegnare cose — Salva una regola, oppure avvia un progetto con una frase che descriva ciò che è importante al suo interno.
• Ispezionare le cose — elencare i tuoi progetti, elencare ciò che sa un progetto, elencarne le regole o leggere un record.
• Rimuovere elementi — elimina un singolo record. La redazione di una frase esatta o l'eliminazione di un intero progetto avviene nel pannello dell'account.
• Esamina il registro — visualizza l'elenco delle intenzioni non ancora decise di un progetto e rimuovi le voci man mano che le decidi.
• Mantieni i manuali di gioco — Salvare una procedura una volta, per l’intero account; recuperarla e eseguirla da qualsiasi progetto; elencare quelle presenti; eliminare quelle non più utilizzate.

Una cosa che un agente non può fare deliberatamente: Eliminare un intero progetto. Quell’unico atto raggiunge l’archivio originale, quindi rimane nel pannello del tuo account, dove una persona digita il nome.

Le regole sono il modo per evitare di ripetersi: le convenzioni, i vincoli e le correzioni acquisite con fatica che i propri agenti non devono mai dimenticare. Le buone regole assomigliano a leggi: “mai utilizzare il venerdì”, “in questo progetto si usano tabulazioni, non spazi”, “il nome del cliente si scrive Brethof, mai Brefoth”. Brevi, definitive e valide anche il mese prossimo.

Chiedi al tuo agente di salvare una regola e ti farà una sola domanda: è valida per tutto ciò che fai, o solo per questo progetto?

Quella terza opzione è la più importante, e viene scelta più spesso rispetto alle altre due. Una regola ha un costo elevato: occupa spazio in ogni sessione per sempre e insegna al curatore cosa è importante. Archiviare conoscenze ordinarie come regole è esattamente il modo in cui i ricordi vengono sommersi fino a quando nulla non risulta più evidente.

Le regole insegnano al curatore, non solo all’agente

Un progetto con una manciata di regole precise ricorda notevolmente meglio di uno senza — perché le regole dicono al suo curatore cosa conta lì. Salvanne una e, entro pochi minuti, la memoria di quel progetto ha riappreso cosa sia il progetto.

Mantenerle affilate

Una regola dovrebbe essere abbastanza breve da poterla dire ad alta voce: se non ci sta, probabilmente è conoscenza vestita da regola. Unite i duplicati in uno solo ed eliminate le regole ormai superate; nessuno le pota al posto vostro, perché nessun altro dovrebbe avere il diritto di decidere quali siano le vostre leggi. Una dozzina di regole in cui credete valgono più di cinquanta che avete smesso di leggere.

Progetti in pratica

L’unica decisione davvero importante è come suddividerli: uno per codice sorgente, cliente o progetto è il modello che funziona meglio. Se ne sono troppo pochi e non collegati tra loro, i lavori si mescolano tra loro; se ne sono troppi, il contesto diventa confuso. Iniziare un progetto con uno scopo espresso in una sola frase – cosa esso rappresenta e cosa bisogna ricordarne – è il momento più prezioso che si possa dedicargli. Questo permette al responsabile del progetto di capire fin dal primo giorno quali siano le intenzioni, invece di doverle dedurre da frammenti di informazioni.

Tre cose diverse vengono misurate in modo diverso, e vale la pena sapere quale sia quale. Registrazione È limitato dalla capacità di archiviazione. Imparare è limitato dal tuo importo mensile consentito. Richiamare Non è limitato da nulla: la ricerca, le informazioni della sessione e il recupero delle risposte su richiesta continuano a funzionare finché la tua memoria rimane sui nostri sistemi in tempo reale.

Se l’abbonamento scade

Il Brain si ferma immediatamente: non c’è alcun periodo di grazia. La tua memoria viene archiviata dopo il giorno 7; ricevi un avviso intorno al giorno 23 e viene eliminata il giorno 30. Un account attivo e a pagamento non viene mai toccato. Il calendario completo, insieme alle email correlate, è disponibile nella Privacy Policy.

Il vuoto che un limite lascia, e perché non lo colmiamo mai

Anche se c’è un limite, non vengono creati nuovi ricordi. Ciò lascia un vuoto nella tua memoria per quel periodo. Non torniamo indietro per completarlo in seguito.. Quella è una legge di progettazione intenzionale, e dovresti conoscerla.

Un ricordo nasce soltanto da una conversazione. Come capita. Un resoconto scritto in seguito, basato su informazioni ormai vecchie di settimane, sovrascriverebbe ciò che è stato vero finora; la nostra memoria inizierebbe allora a sostenere con certezza cose che non sono più vere. Preferiamo lasciare un vuoto piuttosto che inventare una menzogna convincente.

In parole povere: il vuoto è permanente come memoria. La cronologia completa delle vostre conversazioni di quel periodo è ancora lì e può essere cercata, quindi i dati non vengono persi — solo lo strato distillato presenta una lacuna. Più a lungo dura questo limite, più la vostra memoria si allontana dal lavoro che state effettivamente svolgendo. Inoltre non si ripara da sola quando riprendete: il vostro agente corregge le memorie obsolete man mano che le incontra, e la memoria concilia i nuovi record con quelli vecchi non appena arrivano, ritirando quelli in contraddizione con le memorie più recenti. Entrambi questi processi vanno in avanti, mai all’indietro.

Nessuno viene tagliato fuori in silenzio. Ricevi un'email quando ti avvicini a un limite e un'altra quando scatta, una notifica nella sessione del tuo agente quando inizia, e una breve riga su ogni prompt finché il limite è attivo.