netgescon-day0/docs/ai/START-HERE-AGENT.md

START HERE - Continuità Agent NetGescon

Regola operativa (consigliata)

Non usare una chat infinita. Usa 1 chat per argomento/capitolo e fai rotazione periodica.

Quando aprire una chat nuova

Apri nuova chat se si verifica almeno una condizione:

• hai chiuso un blocco di lavoro (bug fix completo, feature completa, test completati)
• la chat supera ~80-120 richieste
• inizi a vedere rallentamenti evidenti o risposte non coerenti
• cambi argomento (es. da "Fatture Fornitori" a "Voci Spesa")

File da far leggere all'agent (ordine)

Sempre:

1. docs/ai/SESSION_HANDOFF.md
2. docs/ai/TOPICS_INDEX.md
3. docs/ai/LATEST_2_CHATS_RECOVERY.md

Poi il topic attivo: 4. docs/ai/topics/<topic>.md

Se serve contesto operativo: 5. docs/ai/RUNBOOK.md 6. docs/ai/USO-CHAT-CONTINUITA.md

Prompt master di ripartenza

Usa questo testo in una chat nuova:

Riparti da docs/ai/SESSION_HANDOFF.md, docs/ai/TOPICS_INDEX.md, docs/ai/LATEST_2_CHATS_RECOVERY.md e dal topic <NOME_TOPIC>. Obiettivo: continua dal prossimo step operativo senza rifare analisi generale. Prima dammi un piano breve (3-5 step), poi esegui.

Prompt rapido per bug

Riparti dai file handoff/topic e concentra il lavoro sul bug: <DESCRIZIONE_BUG>. Mostra causa probabile, fix minimo, verifica rapida. Evita modifiche fuori scope.

Prompt rapido per feature

Riparti dai file handoff/topic e implementa la feature: <FEATURE>. Procedi con cambi minimali e verifica locale mirata.

Chiusura sessione (obbligatoria)

1. AI: Continuity Auto (Safe)
2. Se chat lente: AI: Heavy Chats (Dry Run)
3. Se necessario: AI: Archive Heavy Chats

Cosa è essenziale mantenere

• decisioni prese
• file cambiati
• comandi eseguiti + esito
• bug e riproduzione
• prossimo passo

Il resto (ragionamenti lunghi intermedi) non è essenziale.