netgescon-day0/docs/ai/USO-CHAT-CONTINUITA.md

2.6 KiB

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