# Uso Chat con Continuità (senza perdere il filo)

## Obiettivo

Mantenere il filo logico dello sviluppo anche con più chat, senza dover rispiegare tutto ogni volta.

## Regola semplice

La memoria stabile deve stare nei file di progetto, non in una singola chat lunga.

Usiamo 3 elementi:

1. `docs/ai/SESSION_HANDOFF.md` (stato generale sessione)
2. `docs/ai/TOPICS_INDEX.md` (indice argomenti/capitoli)
3. `docs/ai/topics/*.md` (dettaglio per argomento)

## Flusso consigliato (2 minuti)

1. Prima di chiudere una chat:
   - Esegui task: **AI: Session Checkpoint**
2. Se stai lavorando su un argomento specifico:
   - Esegui task: **AI: Topic Checkpoint**
   - Inserisci:
     - nome argomento (es. "Fatture Fornitori")
     - nota breve (es. "fix import legacy + prossimo test UI")
3. Quando apri una nuova chat:
   - Incolla questo prompt:
     - `Riparti da docs/ai/SESSION_HANDOFF.md e docs/ai/TOPICS_INDEX.md; poi apri il topic <NOME_TOPIC> e continua dal prossimo step senza analisi generale.`

## Automazione rapida (1 click)

- Task: **AI: Continuity Auto (Safe)**
  - Aggiorna `SESSION_HANDOFF`
  - Aggiorna il topic (ti chiede nome + nota)
  - Controlla chat pesanti (dry-run)

- Task: **AI: Continuity Auto + Archive**
  - Fa tutto quanto sopra
  - In più archivia le chat pesanti in quarantine (reversibile)

- Task: **AI: Summarize Largest Archived Chat**
  - Genera un riassunto automatico in `docs/ai/chat-summaries/`
  - Utile per testare che la pulizia non perda il filo logico

## Come lanciare "AI: Archive Heavy Chats" (senza terminale)

1. In VS Code premi `Ctrl+Shift+P`
2. Scrivi: `Tasks: Run Task`
3. Premi Invio
4. Seleziona: `AI: Heavy Chats (Dry Run)`
   - Questo fa solo controllo, non sposta nulla
5. Se il report è ok, ripeti `Tasks: Run Task`
6. Seleziona: `AI: Archive Heavy Chats`
   - Questo sposta solo le chat molto grandi in quarantine (reversibile)

## Sicurezza

- Backup già creato in `~/vscode-chat-backups/...`
- Archiviazione reversibile: i file non vengono cancellati definitivamente.
- Per ripristinare serve comando di restore (lo facciamo insieme quando vuoi).

## Nota importante

Questo metodo risolve il problema principale: puoi pulire le chat pesanti e mantenere comunque il contesto di lavoro tramite i checkpoint in repository.

## Dati essenziali vs non essenziali

Essenziali per continuare lo sviluppo:

- obiettivo/decisioni prese
- file modificati davvero
- comandi eseguiti + esito
- bug riproducibili e fix tentati
- prossimo step operativo

Non essenziali (spesso pesanti):

- lunghi ragionamenti intermedi
- varianti scartate
- output ripetuti e verbose
- porzioni molto grandi di contesto già riportate nei file di progetto