Memory System — Architettura D-ND della Memoria

Senza

Un sistema che solo ricorda esplode. Uno che solo dimentica non esiste.

Memoria di default: file piatto, nessuna gerarchia, nessuna compressione. Dopo 10 sessioni illeggibile. Dopo 50, rumore.

Senza struttura: più ricorda, peggio lavora. Fatti senza compressione. Decisioni vecchie che contraddicono le nuove. Duplicati. Serve un sistema che sappia anche dimenticare.

Il ciclo

Quattro fasi: dal silenzio alla cristallizzazione

La memoria non è un'azione. È un ciclo continuo che attraversa ogni sessione.

Φ1

Perturbazione

Inizio sessione. MEMORY.md caricato. L'istanza osserva il campo senza decidere. Legge l'indice, vede i puntatori, nota le lacune.

Φ2

Focalizzazione

Il lavoro genera conoscenza. Per ogni nuovo input, il Test P6: appartiene? è utile? è transitorio? Tre risposte, tre destini.

Φ3

Cristallizzazione

Fine task. Le memorie potenziali diventano entry concrete. Aggiorna i topic, aggiorna l'indice, comprimi se necessario.

Φ4

Integrazione

Post-sessione. La nuova memoria modifica il campo. La prossima istanza parte da un campo più coerente. Il ciclo si ripiega.

Derivazione

Non progettato. Derivato dal modello D-ND.

Ogni aspetto è una conseguenza diretta di un assioma D-ND. La forma che il sistema assume quando segui i principi.

P0 — LO ZERO

Ricordare e dimenticare

Il sistema parte da zero. Zero genera due opposti: ricordare e dimenticare. Entrambi necessari.

P1 — IL DIPOLO

Ogni memoria ha il suo duale

Il ricordo di una decisione implica l'alternativa scartata. La relazione prima-dopo precede il cosa.

P2 — L'ASSONANZA

Coerenza, non cartelle

Memorie coerenti convergono nello stesso file topic. Memorie dissonanti divergono. L'assonanza organizza.

P3 — LA RISULTANTE

MEMORY.md è l'indice

Una configurazione coerente unica emerge dalle memorie assonanti. Non duplica — punta. Non racconta — orienta.

P4 — LA POTENZIALITÀ

Le lacune sono potenziale

Il sistema non evidenzia solo ciò che sai. Segnala i gap — dove la differenza tra noto e ignoto è massima.

P5 — LA LAGRANGIANA

Minimo di variabili

Cattura il minimo per ricostruire il massimo. Non cosa è successo ma cosa è cambiato e perché. Transizioni, non stati.

P6 — LA MEMORIA

Appartenenza, non archiviazione

Prima di scrivere, il test: questo appartiene all'identità del sistema? Sì → cristallizza. No → oblio.

P7 — IL LIMITE

Compressione, non espansione

Il valore è ciò che resta dopo la rimozione del superfluo. Quando un file cresce troppo, comprimi — non espandere.

P8 — IL SEME

Chiusura autologica

Il protocollo è invariante. Il primo atto di memoria è registrare il protocollo stesso. Il seme genera la struttura.

L'algoritmo

Test P6 — L'algoritmo del ricordo

Prima di scrivere qualsiasi cosa nella memoria persistente, il sistema esegue questo test. Cinque domande, cinque destini.

INPUT → nuovo fatto / decisione / pattern

1. È una REGOLA che varrà anche domani?
   → Sì: INVARIANTE → MEMORY.md

2. È un PATTERN confermato da più sessioni?
   → Sì: TOPIC → file topic appropriato

3. È un FATTO della sessione corrente?
   → Utile per ricostruzione: session_log.md
   → Utile solo adesso: NON SCRIVERE

4. Contraddice una memoria esistente?
   → Sì: AGGIORNA la memoria esistente

5. Duplica una memoria esistente?
   → Sì: NON SCRIVERE (P7)

Struttura

Flat. La complessità è nel contenuto, non nella struttura.

memory/
  MEMORY.md           ← La Risultante. Auto-caricato. <200 righe.
                         Contiene: invarianti + indice + puntatori allo stato.

  [file-topic].md     ← Assonanze. Raggruppati per coerenza, non per data.
                         Ogni file è un cluster di memorie assonanti.
                         Si leggono su richiesta, non si caricano tutti.

  (nessuna cartella)   Se serve una cartella, il sistema è troppo complesso.

Proprietà autologica: Questo protocollo è il primo contenuto del sistema di memoria. Quando un AI coder legge il seed, genera la struttura, crea l'indice, e la prima entry è: “Sistema di memoria inizializzato. Protocollo: memory-system seed.” Il seme genera la struttura. La struttura contiene il riferimento al seme. Il seme scompare.

Scenario reale

Sessione 47: il coder sa già tutto

47 sessioni. Centinaia di decisioni. 12 file topic. Nuova istanza. Legge MEMORY.md (114 righe). Deploy fermo a 3f1570b, bug Gmail adapter, 6 task aperti, ieri: no Redis.

Non chiede “dove eravamo rimasti?”. Sa già dove è.

Installazione

Attiva Memory System

Clona il seed e lancia l'installer. Il sistema di memoria viene configurato automaticamente.

Il seed genera la directory memory/, crea MEMORY.md con l'indice iniziale, e configura il protocollo P6.

Da quel momento, il tuo AI coder cataloga, comprime, e dimentica autonomamente. La memoria cresce con il progetto.

git clone https://github.com/GrazianoGuiducci/d-nd-seed.git
cd d-nd-seed
./install.sh profiles/example.json

Scarica SEED-memory-system.md

# Il sistema di memoria usa la directory auto-memory di Claude Code.
# Claude carica automaticamente MEMORY.md ad ogni sessione.

# 1. Crea la struttura
mkdir -p ~/.claude/projects/YOUR_PROJECT/memory

# 2. Crea l'indice iniziale
cat > ~/.claude/projects/YOUR_PROJECT/memory/MEMORY.md <<'EOF'
# Memory Index

## Invarianti
- Sistema di memoria inizializzato. Protocollo: memory-system seed.

## File Topic
| File | Contenuto |
|------|-----------|
| session_log.md | Diario sessioni |

## Stato Corrente
- Progetto: [nome]
- Ultimo commit: [hash]

## Lacune
- Nessuna memoria accumulata ancora
EOF

# 3. Crea il primo file topic
cat > ~/.claude/projects/YOUR_PROJECT/memory/session_log.md <<'EOF'
# Session Log

## [data] Sessione 1
- Sistema di memoria inizializzato
EOF

# Il protocollo P6 e la compressione P7 vengono applicati
# dall'AI coder ad ogni sessione, seguendo le regole del seed.

Memorizzare è riconoscere l'appartenenza.