# Skill governance matrix (principali)

Questa matrice sintetizza lo stato delle skill principali richieste per Milestone 0, con focus su:

Riferimenti di governance aggiornati:
- guida viva: `docs/mcp-skills-agents-development-guide.md`
- storico milestone completate: `docs/completed-milestones-mcp-skills.md`

- precisione dei trigger;
- separazione tra contenuti core (`SKILL.md`) e approfondimenti (`references/`);
- supporto script operativo;
- copertura eval;
- confini con `mcp-master-orchestrator` e `mcp-technical-analyst`.

Scala usata:

- **Alto**: requisito chiaramente coperto e verificabile nel repository.
- **Medio**: copertura presente ma non completa o non formalizzata in test/eval.
- **Basso**: copertura assente o solo implicita.

## Matrice

| Skill | Trigger precisione | Separazione core/references | Script support | Eval coverage | Confini con orchestrator/analyst |
| --- | --- | --- | --- | --- | --- |
| `mcp-technical-analyst` | **Alto** — trigger espliciti per intake multi-sorgente e anti-trigger mono-dominio. | **Alto** — `SKILL.md` snello con rimandi multipli a `references/`. | **Basso** — nessuna cartella `scripts/` locale. | **Alto** — presente `evals/evals.json` dedicato. | **Alto** — confini dichiarati: primario su analisi multi-sorgente; non sostituisce specialistici operativi. |
| `mcp-master-orchestrator` | **Alto** — regole di routing e tabella "Se devi..." molto esplicite. | **Alto** — runbook/checklist demandati a `references/`. | **Basso** — nessuna cartella `scripts/` locale. | **Alto** — presente `evals/evals.json` su routing analyst/specialistico e uso sidecar per fase. | **Alto** — boundary forte: coordina, delega intake analitico a `mcp-technical-analyst`. |
| `mcp-git-mantis-workflow` | **Medio** — trigger pratici chiari ma meno formalizzati rispetto a analyst/orchestrator. | **Alto** — pattern aggiuntivi in `references/handoffs-and-conflicts.md`. | **Basso** — nessuna cartella `scripts/` locale. | **Alto** — presente `evals/evals.json` dedicato a preflight/rebase/conflict/verification. | **Medio** — confine dichiarato: per sintesi multi-sorgente passa a `mcp-technical-analyst`. |
| `mcp-code-reviewer` | **Alto** — trigger focalizzati su snippet/file/commit/diff/branch/PR e anti-trigger su intake multi-sorgente. | **Alto** — core snello con workflow/evidenze/output/escalation in `references/`. | **Basso** — nessuna cartella `scripts/` locale (non obbligatoria nella prima iterazione). | **Alto** — presente `evals/evals.json` con copertura minima obbligatoria su output mode e routing. | **Alto** — boundary espliciti verso `mcp-technical-analyst` (intake) e `mcp-master-orchestrator` (multi-step). |
| `mcp-docs-navigator` | **Medio** — trigger orientati a navigazione docs, con escalation esplicita se serve correlazione multi-sorgente. | **Alto** — strategie operative spostate in references dedicate. | **Basso** — nessuna cartella `scripts/` locale. | **Alto** — presente `evals/evals.json` dedicato. | **Medio** — confine definito verso `mcp-technical-analyst` su task cross-sorgente. |
| `mcp-database-expert` | **Medio** — trigger coerenti con dominio SQL/reporting. | **Medio** — reference presente ma meno articolata. | **Basso** — nessuna cartella `scripts/` locale. | **Basso** — non risultano eval dedicati. | **Medio** — confine implicito con orchestrator/analyst tramite routing per task composti. |
| `mcp-coldfusion-developer` | **Alto** — routing scenario-based esplicito per bootstrap pagina, migrazione `mvc3 -> mvc4`, xgrid, boundary `core/client-core/client patch`, security e legacy cliente deploy. | **Alto** — `SKILL.md` snello con references operative locali e template inclusi nella skill. | **Basso** — nessuna cartella `scripts/` locale. | **Alto** — `evals/evals.json` ampliato con copertura scenario-based e boundary Platform/legacy. | **Alto** — skill esecutiva con handoff espliciti a browser, docs, git/mantis, database e analyst quando il task diventa multi-sorgente. |
| `mcp-office-expert` | **Medio** — trigger ben centrati su documenti Office e conversioni. | **Alto** — dettagli operativi in references. | **Basso** — nessuna cartella `scripts/` locale. | **Alto** — presente `evals/evals.json` dedicato. | **Medio** — confine esplicito: se il documento e solo innesco di indagine tecnica, usare analyst. |
| `mcp-browser-automation` | **Medio** — trigger utili su test browser/automazione con riferimenti pratici. | **Alto** — pattern test in references dedicate. | **Basso** — nessuna cartella `scripts/` locale. | **Basso** — non risultano eval dedicati. | **Medio** — confine operativo: usare orchestrator quando il flusso include dipendenze multi-skill. |
| `mcp-mantis-ticket-writer` | **Alto** — trigger focalizzati su drafting/refinement ticket Mantis con anti-trigger verso intake multi-sorgente. | **Alto** — `SKILL.md` snello con regole operative e template in `references/`. | **Basso** — nessuna cartella `scripts/` locale. | **Alto** — presente `evals/evals.json` con copertura su template, interattivita' e escalation. | **Alto** — boundary espliciti verso `mcp-technical-analyst` (intake) e `mcp-master-orchestrator` (multi-fase). |

## Lettura rapida dei gap trasversali

1. **Eval coverage in estensione**: suite esplicita ora presente per `mcp-technical-analyst`, `mcp-master-orchestrator`, `mcp-code-reviewer`, `mcp-git-mantis-workflow`, `mcp-docs-navigator`, `mcp-coldfusion-developer`, `mcp-office-expert` e `mcp-mantis-ticket-writer`; priorita' residua sulle skill ancora senza eval dedicati (es. `mcp-database-expert`, `mcp-browser-automation`).
2. **Script support uniforme ma debole**: le skill principali non espongono `scripts/` locali.
3. **Boundary analyst/orchestrator ben presidiato**: i due skill core hanno confini reciproci espliciti e coerenti.

## Criteri di routing verificabili (Milestone 0)

Per considerare "verificabile" il routing tra skill core devono risultare tutti i punti:

1. `mcp-technical-analyst` dichiara criteri **pass/fail** per intake multi-sorgente e anti-trigger mono-dominio.
2. `mcp-master-orchestrator` dichiara gate di routing con regola esplicita "coordinatore, non intake universale".
3. Entrambe le skill espongono **stop conditions** e direzioni di escalation (verso analyst, specialistico o utente).
4. La checklist orchestrator include campi `PASS/FAIL` per audit veloce durante handoff/review.

## Backlog minimo consigliato

- Introdurre `evals/` minimi per le skill esecutive ancora scoperte ad alto uso (priorita': `mcp-database-expert`, `mcp-browser-automation`).
- Aggiungere micro-script opzionali (`scripts/`) per checklist ripetitive dove utile (es. preparazione input, validazioni rapide).
- Formalizzare un punteggio di trigger precisione (es. 1-5) per ridurre soggettivita' tra review successive.