Manuale/Il lavoro di tutti i giorni

Memoria, note e retro

Capitolo 08 · 3 min di lettura

moh conserva nel tempo tre cose diverse, tenute separate di proposito: una piccola memoria di fatti duraturi, le tue note e la conversazione completa, riassunta quando diventa lunga. Una quarta, la retro, guarda indietro a come è andato il lavoro e propone miglioramenti — solo da approvare.

Cosa ricorda moh tra una conversazione e l'altra#

Dopo ogni scambio, un piccolo aiutante in background individua i fatti che sembrano duraturi — le tue convenzioni, decisioni, preferenze — e li aggiunge alla memoria del progetto. La volta dopo non devi ripeterti. Un indicatore discreto compare quando la memoria cambia.

La memoria sta in ~/.moh/projects/<progetto>/memory/: semplici file di testo che puoi aprire e leggere. I fatti vengono solo aggiunti; quando due sono in contrasto vince il più recente, con una nota datata.

Note di progetto#

Premi ctrl+n per aprire l'editor delle note: un blocco appunti per il progetto — una lista di cose da fare, un promemoria per domani, un link che ti serve. Tutte le conversazioni del progetto vedono le stesse note.

Conversazioni lunghe#

Un'AI può tenere "a mente" solo una quantità limitata di testo — la sua finestra di contesto. L'indicatore in basso mostra quanto è piena. Quando una conversazione supera circa l'80%, moh la compatta da solo: scrive un riassunto fedele della parte più vecchia — il compito, le decisioni, i prossimi passi — tiene parola per parola gli ultimi dieci scambi e continua.

• Scrivi /compact per farlo tu, subito.
• Il riassunto è un'aggiunta al file, non una sostituzione: la cronologia completa resta sul disco per sempre.
• Se un provider dice "è troppo lungo" con un limite più basso del previsto, moh impara quel numero per il resto della conversazione e te lo dice una volta.

Retro: cosa sistemare la prossima volta#

Quando una conversazione si chiude, moh ne rilegge rapidamente il registro — con controlli semplici, senza chiamare l'AI, senza inviare nulla — e annota quello che un revisore attento noterebbe sulla configurazione del progetto. Per esempio:

• il progetto definisce gli script lint e test, ma nulla li esegue in automatico prima di un commit o nella CI;
• lo stesso comando lento è stato lanciato quattro volte in una sessione.

Un secondo passaggio cerca consigli su come orientarsi nel codice e su quali regole di scrittura del codice mettere per iscritto; parte solo ogni dieci conversazioni, mai dopo ciascuna.

1. Avviso. All'inizio di una sessione, una riga ti dice quando ci sono nuove osservazioni in attesa — al massimo una volta ogni due giorni.
2. Revisione. /retro (o moh retro nel terminale) le elenca, prima le più sicure, con le prove dietro a ciascuna.
3. Applica, o scarta. a mostra la modifica esatta — una regola per CODING_STANDARDS.md, un'indicazione in AGENTS.md — e la scrive solo dopo la tua conferma, come nuova riga sotto un titolo ## Retro findings. Il testo che hai già scritto non viene mai modificato. Una modifica che non è testo, come un hook o un job di CI, ti viene descritta perché la faccia tu. d scarta un'osservazione per sempre, e scartare più volte lo stesso tipo rende moh più severo nel riproporlo.

Scritto per moh 0.61. Dentro moh, ctrl+h apre il manuale incluso, aggiornato alla tua versione.