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

61 lines
1.8 KiB
Markdown

# 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.