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

1.8 KiB

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.