# Analisi candidati skill da session mining — 2026-07-10

**Stato: implementato.** Tutte le voci "adopt"/"enhance" di questa matrice sono state realizzate lo stesso giorno (vedi sezione "Esito implementazione" in fondo). I candidati "backlog/watch" restano deliberatamente non implementati per evidenza insufficiente.

Documento prodotto incrociando:
- inventario delle 18 skill in `skills/` (audit tecnico);
- mining di sessioni reali Codex CLI (148 thread/183 trascrizioni su disco), Claude Code (150 file/9 progetti), Cursor (~3 sessioni sostanziali), Antigravity/Copilot (dati locali insufficienti);
- un piano operativo prodotto ieri (2026-07-09/10) da una sessione Codex CLI che ha eseguito lo stesso identico compito (`019f488e-b930-...` + sub-agent Leibniz/Hooke/Galileo), mai eseguito oltre la fase di pianificazione.

## Nota metodologica importante

Il conteggio "~1097 sessioni" riportato da `analytics-mcp-server` è un aggregato multi-fonte (include probabilmente sub-agent/worker contati come sessioni separate). I numeri reali su disco sono più bassi e sono quelli effettivamente analizzati: Codex 148 thread indicizzati / 183 file grezzi, Claude Code 150 file (16 sessioni "top-level" + 134 trascrizioni di sub-agent), Cursor ~25 sessioni (solo poche sostanziali). Il campionamento non è stato esaustivo su ogni sub-agent (specialmente su progetti con 30-44 sub-agent); i cluster a bassa frequenza vanno quindi trattati con cautela maggiore di quelli ad alta frequenza.

## Matrice finale dei candidati

| Candidato | Tipo | Evidenza | Decisione |
|---|---|---|---|
| **mcp-grid-ui-debugger** | Nuova skill | 2 fonti indipendenti (Codex: cluster TesiGrid/SuperPlanning su più date; Claude Code: 4 sessioni indipendenti in `S--netcore-dotnet-platform` sullo stesso componente grid Blazor/DevExpress) convergono sullo **stesso sistema reale** visto da due tool AI diversi. Workflow stabile e distintivo: ispezione DOM live (`javascript_tool`) + screenshot iterativo + ciclo fix CSS/JS, non coperto da `mcp-browser-automation` (orientata a Playwright/validazione flussi, non diagnosi di componenti grid proprietari). Trigger riconoscibile (scroll/flicker/drag/layout su TesiGrid/SuperPlanning/DevExpress grid), output ripetibile (fix + doc "genesi tentativi"). | **Adopt come nuova skill — priorità più alta.** Soglia dei criteri dichiarati (≥2 casi indipendenti, workflow stabile, trigger riconoscibile, output ripetibile, valore non coperto) soddisfatta con margine. |
| **mcp-git-mantis-workflow** — enhancement "implementazione da spec ticket" | Enhance | Codex: ~18 thread indipendenti su portale Claims B2C (React/TS), tutti conclusi con successo. Pattern stabile: spec ticket incollata → pianificazione con sub-agent low-cost → implementazione → doc-sync obbligatoria su `_documentation/*.md` → gate typecheck+build prima di dichiarare chiuso. | **Enhance prioritario.** Aggiungere fase/checklist dedicata alla skill esistente; non giustifica una skill separata (stesso dominio ticket/commit). |
| **mcp-git-mantis-workflow** — checklist "risoluzione conflitto inclusiva + verifica pre-push" | Enhance (minore) | Codex: 1 caso dettagliato (conflitto rebase MUSA/Yii) con correzione esplicita dell'utente e verifica finale (lint sintattico + scan marker residui + scan encoding prima di push manuale). Basso costo di aggiunta, alto valore pratico. | **Enhance a basso rischio.** Da aggiungere come checklist di sicurezza, indipendentemente dalla frequenza. |
| **mcp-docs-navigator** — pattern "audit source-grounded" | Enhance | Confermato indipendentemente da Codex (cluster documentazione TesiGrid/footer, letta dal codice sorgente non da altra doc) e dal piano di ieri. | **Enhance, upgrade da "reference" (piano di ieri) ad "adopt-enhance".** Doppia corroborazione. |
| **mcp-technical-analyst** — playbook "audit legacy pre-migrazione" | Enhance | Claude Code: 2 progetti client indipendenti (`S--xamp7212-htdocs-cambia`, 44 sub-agent read-only su DB/funzionalità/UI legacy PHP; `S--netcore-ETrainNavigator-Api`, stesso pattern su Yii→​.NET), stesso schema: fan-out di sub-agent read-only per dominio, output Markdown agent-friendly versionato, propedeutico a riscrittura. | **Enhance.** Non giustifica nuova skill: è un playbook aggiuntivo dentro l'analyst esistente, con rimando a `mcp-database-expert`/`mcp-docs-navigator`/`mcp-sophia-yii-developer` per le sotto-fasi. |
| **Eval coverage**: `mcp-database-expert`, `mcp-browser-automation`, `mcp-analytics-operator`, `mcp-runtime-integrator` | Enhance (hygiene) | Audit skill: zero eval dedicati su 4 skill ad alto utilizzo/criticità (dato dall'inventario, indipendente dal session mining). | **Enhance — priorità governance**, da fare comunque indipendentemente dai nuovi candidati. |
| **mcp-mantis-ticket-writer / mcp-mantis-test-writer** — confine trigger | Enhance (minore) | Audit skill: overlap di formato output copy-paste Mantis-ready; rischio di routing ambiguo su "test plan in Mantis". | **Enhance minore**: precisare i trigger ("checklist manuale" vs "testo ticket"), nessuna fusione/nuova skill. |
| **mcp-ai-runtime-onboarding** (onboarding AGENTS.md/CLAUDE.md/.cursor su progetti client nuovi) | Nuova skill (contestato) | Segnale misto: Codex la valuta "forte" (2 casi: piano di ieri + sessione dotnet-platform); Claude Code la valuta "reference-backlog" (1 solo progetto con evidenza diretta, altri progetti client hanno già CLAUDE.md/MEMORY.md propri ma nati ad-hoc, non da un workflow ripetuto osservabile). | **Backlog/watch, non adopt ora.** Servono 1-2 casi indipendenti aggiuntivi con trigger/output stabili prima di impegnare lavoro. Da NON confondere con `mcp-runtime-integrator` (che è lato-framework: estendere installer/analytics a un nuovo host AI, già esistente), mentre questo candidato sarebbe lato-progetto-cliente: bootstrap di regole agentiche su un nuovo repo esterno. |
| **mcp-runtime-integrator** | Già esistente — nessuna nuova skill | Claude Code: la sessione che ha esteso installer/analytics a Claude Code e Cursor (`S--mcp-servers`, 2026-07-09/10) si è conclusa proprio con la creazione di questa skill, inclusi i pitfall reali riscontrati. | **Adopt confermato (già fatto).** Nota operativa: rollout ancora incompleto (`.claude\skills` ha solo 1/18 skill symlinkate, `.cursor\skills-cursor` risulta vuota) — è lavoro residuo di questa skill/installer, non un nuovo gap di prodotto. |
| **mcp-doc-governance-auditor** (proposta nel piano di ieri) | Scartata | Nessuna delle 3 fonti di mining odierne ha trovato evidenza indipendente distinta da quanto già confluito nell'enhancement di `mcp-docs-navigator` sopra. | **Non creare** — assorbita nell'enhancement di `mcp-docs-navigator`, evita duplicazione. |
| **mcp-render-pipeline-consolidator** | Backlog/scarta | Codex: confermato di nicchia, 6 sessioni su un solo repo (`advanced-guided-renders`). | **Backlog**, conferma la valutazione di ieri. |
| **mcp-sophia-yii-developer** — checklist business-rule/document sync | Backlog/watch | Solo 1 caso trovato oggi (validazione CF/PIVA, esito non confermato con certezza, sessione interrotta a metà dall'utente). Sotto soglia (richiesti ≥2 casi indipendenti). | **Downgrade a backlog/watch** rispetto al piano di ieri: non procedere ora, tenere d'occhio. |
| Altri cluster minori (debug live tab Chrome/VS Code, fix QA non-Mantis, pattern multi-worker su file singoli in SVG/render, fan-out per deliverable paralleli didattici) | Reference/backlog o scarta | Evidenza singola o fuori dominio aziendale (es. dispensa didattica). | **Reference-backlog o scarta.** Dettagli nei report dei sub-agent (vedi sotto). |

## Punto di attenzione trasversale

`mcp-browser-automation` era candidata nel piano di ieri per un enhancement "eval UI readiness/grid". Con l'evidenza di oggi, la parte "grid" va assegnata al nuovo `mcp-grid-ui-debugger` (tool signature diversa: ispezione DOM live + screenshot iterativo, non validazione di flusso Playwright). L'enhancement eval generico su `mcp-browser-automation` resta comunque valido e va mantenuto separatamente (vedi riga eval coverage).

## Esito implementazione (2026-07-10, stessa sessione)

Su richiesta esplicita, la matrice sopra è stata eseguita in ordine di priorità con sub-agent low-cost paralleli (haiku), ciascuno su una directory skill indipendente, e verificata manualmente file per file dall'orchestratore (non solo fidandosi del report del sub-agent).

| Voce | Azione | Esito |
|---|---|---|
| Meta-skill "mining sessioni → candidati skill" (aggiunta su richiesta utente, non era nella matrice originale) | Nuova skill `mcp-skill-miner` | Creata. **Nota di qualità**: la prima bozza dei reference `worked-example` e `sampling-heuristics` conteneva dati completamente inventati (sessioni fittizie, "24 skill" invece di 18) — riscritti dall'orchestratore con i dati reali di questo stesso esercizio prima di chiudere il task. |
| `mcp-grid-ui-debugger` | Nuova skill | Creata (SKILL.md, 2 reference, evals con 5 scenari). Contenuto verificato coerente con l'evidenza raccolta, nessuna fabbricazione rilevata. |
| `mcp-git-mantis-workflow` — implementazione da ticket + conflitto inclusivo | Enhance | Fatto: nuovo reference `ticket-implementation-checklist.md`, sezione 3.4 aggiunta a `rebase-playbook.md`, 2 nuovi eval. |
| `mcp-docs-navigator` — audit source-grounded | Enhance | Fatto: nuovo reference `source-grounded-audit.md` (riscritto in italiano dall'orchestratore, la bozza del sub-agent era in inglese, incoerente con la convenzione del repo), routing aggiornato, 1 nuovo eval. |
| `mcp-technical-analyst` — audit legacy pre-migrazione | Enhance | Fatto: nuovo reference `legacy-pre-migration-audit.md`, routing aggiornato, 1 nuovo eval. |
| Eval coverage `mcp-database-expert`, `mcp-browser-automation`, `mcp-analytics-operator`, `mcp-runtime-integrator` | Enhance (hygiene) | Fatto: 5 eval realistici per ciascuna delle 4 skill, verificati coerenti con i rispettivi SKILL.md. |
| Trigger `mcp-mantis-ticket-writer`/`mcp-mantis-test-writer` | Enhance minore | Fatto: righe di cross-reference esplicite aggiunte in entrambi i file. |
| `mcp-ai-runtime-onboarding`, `mcp-sophia-yii-developer` checklist, `mcp-doc-governance-auditor`, `mcp-render-pipeline-consolidator` | Backlog/scarta | **Non implementati**, come da decisione: evidenza sotto soglia. |

## Fonti complete

I report integrali dei 4 sub-agent (tabelle dettagliate per cluster, id/date sessione, limiti di campionamento dichiarati) sono disponibili nella trascrizione della sessione Claude Code che ha prodotto questa sintesi (progetto `S--mcp-servers`, sessione corrente). Non sono stati salvati come file separati in questa fase per evitare duplicazione; se servono come allegati permanenti per la Wave 3 di implementazione, vanno estratti su richiesta.