82 lines
2.6 KiB
Markdown
82 lines
2.6 KiB
Markdown
# 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
|