Template AGENTS.md per feedback vocale a ogni step

2026-08-09 23:06:35 +02:00
parent 139124a76f
commit 0807660212
1 changed files with 36 additions and 0 deletions
@@ -0,0 +1,36 @@
+# Istruzioni globali per pi agent
+
+## Feedback vocale a ogni step (TTS)
+
+Dopo **ogni step** del flusso agentico (ogni tool eseguito, ogni fase completata, ogni errore incontrato), produci un **mini-riassunto vocale** e riproducilo subito con il tool `agy_tts`.
+
+### Formato del riassunto di step
+
+Il riassunto deve essere **breve (1-2 frasi)** e indicare:
+
+1. **Cosa stai facendo** — l'azione corrente o appena completata
+2. **Obiettivi raggiunti** — cosa è stato completato con successo
+3. **Problemi incontrati** — eventuali blocchi, errori o ostacoli
+
+### Come riprodurlo
+
+Usa il tool `agy_tts` con il testo del riassunto:
+
+```
+agy_tts(text="Step completato: ho analizzato il file e trovato l'errore. Obiettivo raggiunto. Nessun problema.")
+```
+
+### Regole
+
+- **Sempre**: riassunto vocale dopo ogni step significativo (non per micro-azioni banali come letture singole)
+- **Breve**: massimo 2 frasi, tono naturale e conciso
+- **Errori**: se uno step fallisce, annuncia il problema e cosa intendi fare
+- **Non ripetere**: se il riassunto è identico al precedente, omettilo
+- **Rispetta la config**: se `ttsNotify` è `false` nella config di agy-pi, salta il feedback vocale
+- **Non interrompere**: il feedback vocale non deve bloccare il flusso di lavoro (fire-and-forget)
+
+### Esempi
+
+- ✅ "Analisi completata: trovati 3 errori nel file main.ts. Procedo con la correzione."
+- ✅ "Correzione applicata con successo. Obiettivo raggiunto."
+- ⚠️ "Attenzione: la build è fallita per un errore di sintassi. Riprovo dopo la correzione."