Piano Sviluppo Prompt Optimizer

# Piano di Sviluppo: Skill "prompt-optimizer" — Tri-CLI (Claude Code / Codex / Gemini CLI)

> **Paradigma:** Skill testuale pura, replicando l'architettura multi-CLI del repo
> `Spe1977/cli-collaboration`. Compatibilità reale (attivazione, non solo copia-incolla)
> su Claude Code, Codex e Gemini CLI tramite **adattatori dedicati per ogni CLI** +
> **file di guida nativi** + **installer multi-target**.
>
> **Differenza dal repo di riferimento:** `cli-collaboration` è un protocollo *stateful*
> (worktree, handoff, ownership, git). `prompt-optimizer` è *stateless* (input→output).
> Quindi NON servono: script di check-ownership, sentinel di pausa, lang.sh, gestione
> handoff. L'architettura tri-CLI viene replicata; la complessità di stato no.

---

## 1. Obiettivo della skill

Ricevere un prompt grezzo e trasformarlo in un prompt ingegnerizzato ad alte prestazioni
applicando il framework R-O-C-V-F e, se utile, un profilo specializzato.

**Comportamenti chiave:**
- **Output:** restituisce *sempre e solo* il prompt ottimizzato in un singolo blocco
  fenced `text`, modificabile e pronto da inviare. Nessun razionale, commento o preambolo.
- **Lingua:** file della skill in inglese (standard, miglior triggering cross-CLI); il
  **prompt prodotto segue la lingua dell'input dell'utente**.
- **Profilo:** se non specificato, auto-rilevamento da keyword; fallback → `general`.
- **Input ambiguo:** se troppo vago per ottimizzare in modo utile, porre **1-3 domande
  di chiarimento concise**; non inventare obiettivi, audience, contesto, vincoli o formato.

### Framework R-O-C-V-F

Includere solo le componenti che aggiungono valore reale (evitare riempitivi è esso
stesso buon prompt engineering):

1. **Role (R):** identità esperta per il LLM destinatario.
2. **Objective (O):** obiettivo preciso e d'azione.
3. **Context (C):** informazioni/presupposti necessari.
4. **Constraints (V):** limiti espliciti (cosa non fare, lunghezza, stile, tono).
5. **Format (F):** struttura dell'output richiesto.

---

## 2. Architettura dei file (replica tri-CLI)