diff --git a/templates/AGENTS.vocal-feedback.md b/templates/AGENTS.vocal-feedback.md new file mode 100644 index 0000000..66d8cb8 --- /dev/null +++ b/templates/AGENTS.vocal-feedback.md @@ -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."