# 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
- **Toggle rapido**: l'utente può attivare/disattivare il feedback vocale con `/agy:vocal` (on|off|status)
- **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."
