Memoria
Il Brain
Il quaderno di note di un progetto, che gli agenti leggono prima di lavorare e aggiornano mentre lavorano: come si accende, i tipi di note, come si legge, come si cura da solo e come sa in che branch è nata una nota.
Ogni conversazione con un agente riparte da zero: quello che ha capito ieri, oggi non lo sa più. Il Brain è la memoria del progetto. È un quaderno di note in Markdown, una per cosa che vale la pena ricordare: le decisioni prese e il loro perché, come sono fatti i pezzi del codice, le regole della squadra, le trappole. Gli agenti ci cercano prima di fare qualcosa di non banale e ci scrivono quando prendono una decisione o scoprono qualcosa che non si legge dal codice.
Le note stanno nei dati dell'app, sul tuo computer: mai nella cartella del progetto, mai su un server.
Accenderlo
Il Brain si accende per ogni workspace: nella finestra che crea il workspace, nelle sue impostazioni (Brain → Gli agenti si ricordano il progetto), o dalla scheda Brain, che spenta spiega cos'è e offre Accendi.
Accendendolo, Gloop propone di analizzare il progetto: un Claude in background legge il codice e scrive le prime note (il progetto, i pezzi principali, le pratiche, le decisioni che si leggono dalla storia, i lavori in corso). Ci mette qualche minuto e usa il tuo piano. Puoi rifarlo quando vuoi con Analizza, in fondo all'indice.
Gli agenti avviati da quel momento hanno il Brain: lo raggiungono con i loro strumenti (cercare, leggere, scrivere, aggiungere, collegare) e una regola che dice loro di cercare prima e di scrivere il perché delle cose. I tuoi server MCP restano come sono.
I tipi di note
| Tipo | Cosa racconta | Le sue sezioni |
|---|---|---|
| Progetto | Cos'è il progetto e cosa sapere subito. Una sola. | Cos'è, Com'è fatto, Da sapere subito |
| Decisione | Una scelta, con il perché e cosa si è scartato. Attiva, proposta o superata. | Il problema, La scelta, Perché, Conseguenze |
| Pezzo | Un modulo o un'area del codice, con i suoi file. | Cosa fa, Com'è fatto, Regole da non rompere, Trappole |
| Pratica | Una regola di lavoro della squadra. | La regola, Perché, Come si applica |
| Appunto | Qualcosa da tenere a mente, in breve. | In breve |
| Lavoro | Un lavoro lungo, a che punto è. | Obiettivo, A che punto è, Cosa manca |
| Diario | Una nota per giorno: fatto, deciso, rimasto aperto. | Fatto, Deciso, Rimasto aperto |
Le note si collegano con [[Titolo della nota]]. Un collegamento a una nota che non esiste ancora non è un errore: finisce fra le note Da scrivere.
Leggere e scrivere
La scheda Brain ha tre colonne:
- a sinistra l'indice per tipo, con Da scrivere, Da curare e Senza collegamenti;
- al centro la nota, da leggere come una pagina. Un clic su un pezzo lo rende modificabile; scrivendo
[[Gloop completa il titolo. Si salva da solo; - a destra le Vicine (una piccola mappa della nota e dei suoi collegamenti) e le Recenti.
In alto, Cerca nelle note e Nota per scriverne una nuova (scegli prima il tipo, che dà le sezioni). Sotto ogni nota, quali note la citano.
Il Grafo (dalle Vicine) mostra tutte le note come un globo da girare: trascina per ruotare, la rotellina per avvicinarti, un clic su un punto apre la nota. Per tipo colora i punti per tipo. Serve la grafica 3D: su un computer senza (un desktop remoto, per esempio) Gloop lo dice e l'indice resta.
Dal pannello al Brain
Quando un agente finisce con una risposta lunga (una spiegazione, un'analisi) e non ha già scritto lui nel Brain, il pannello ti chiede "Risposta lunga. La tengo nel Brain?". Si apre una bozza: il titolo, il tipo e il testo riscritto come nota da un modello piccolo, con i collegamenti alle note che esistono. La cambi come vuoi, e niente si scrive senza Salva. Salvando, si aggiunge una riga al diario del giorno.
Anche il Debrief si salva nel Brain, come nota di lavoro, e le decisioni di Scout possono finirci.
Il Brain si cura da solo
Un quaderno si sporca: file citati che non esistono più, collegamenti sbagliati, note doppie, decisioni superate da una più nuova. Una volta al giorno, quando apri il workspace, Gloop cerca questi problemi e li fa confermare a un modello piccolo, che scrive la correzione e il perché.
Le proposte compaiono sotto Da curare nell'indice. Aprendo la nota, in cima c'è la carta: cosa non va, quando è stato controllato, il perché, il prima e il dopo. Applica corregge (e lo scrive nel diario), Ignora la lascia: tornerà solo se la nota cambia e il problema resta. Niente cambia senza il tuo Applica.
In che branch è nata una nota
Il codice cambia da branch a branch, il Brain è uno solo. Per questo ogni nota scritta da un agente si ricorda il branch dove è nata, il commit e i file che citava. Sotto il titolo, una riga dice dove è nata e se quel lavoro è già entrato nel branch principale: in corso, entrata, branch sparito, o non so quando git non può dirlo con certezza.
Gloop riconosce un lavoro entrato in qualunque modo tu chiuda le pull request: merge, rebase o squash. Per saperlo scarica ogni tanto il solo branch principale del repository (mai una password, mai niente in uscita); si spegne in Impostazioni → App → Brain e git.
Anche gli agenti lo vedono: leggendo una nota nata su un altro branch e non ancora entrata, sanno che quello che racconta può non esserci nel loro codice, e lo controllano prima di contarci.
Aree critiche
Una nota può segnare dei percorsi come area critica (la fatturazione, le migrazioni, l'autenticazione). Ogni modifica lì finisce fra i file da guardare nelle Modifiche e nel Debrief. Il modo più semplice per segnarne una è Segna come area critica dentro Modifiche; nell'indice del Brain queste note hanno il segno critica.
La lingua delle note
Gli agenti scrivono le note nella lingua dell'app. Le note già scritte non si traducono mai da sole: Traduci, in fondo all'indice, le passa una per una a un modello piccolo, tiene i file dove sono e alla fine aggiorna i collegamenti con i titoli nuovi.
Spegnerlo
Spegnendo il Brain nelle impostazioni del workspace le note restano (riaccendendolo tornano), a meno che tu non spunti Elimina anche le note. Chiudendo un workspace, la conferma ti chiede se eliminarle.