MCP Technical Analyst

• "analisi tecnica", "stato dell'arte", "gap analysis", "dossier", "allinea ticket-doc-codice";
• richiesta di collegare ticket + commit + documenti + dati;
• richiesta di distinguere fatto/inferenza/punti aperti con output strutturato.

Escalation consigliata:

1. Se il prompt e breve o ambiguo, parti con ticket-first-light.
2. Se emergono dipendenze tra piu repository, DB, ambienti o allegati eterogenei, passa a ticket-first completo.
3. Se il prompt e puramente operativo su un solo dominio (solo SQL, solo docs, solo CFML), non forzare questo skill: instrada allo specialistico e mantieni mcp-technical-analyst solo come coordinatore se serve report finale.

Criteri verificabili di intake primario

Considera mcp-technical-analyst primario solo se almeno un criterio e verificato:

1. richiesta di correlare almeno 2 sorgenti eterogenee (ticket/docs/commit/db/allegati);
2. richiesta esplicita di deliverable analitico strutturato (stato dell'arte, gap analysis, dossier);
3. conflitto da risolvere tra fonti tecniche (es. ticket dice A, codice mostra B).

Anti-trigger verificabili (instradare allo specialistico):

• task eseguibile end-to-end in un dominio singolo senza correlazioni;
• nessuna esigenza di separare evidenza/inferenza/punti aperti nel deliverable finale.

Principi operativi

1. Parti sempre dai fatti disponibili e fai discovery prima di fare domande.
2. Distingui sempre:
   • evidenza osservata
   • inferenza
   • punto aperto
3. Produci artefatti riusabili, di default in .md.
4. Usa Playwright solo quando codice, dati, log e documenti non bastano o quando serve una prova funzionale.
5. Se trovi dati sensibili necessari all'analisi, leggili ma redigili nei deliverable finali salvo richiesta esplicita di conversione locale.

Workflow Base

Entry point ticket-first

1. Leggi ticket, note, relazioni e allegati con mcp-git-mantis-workflow.
2. Estrai commit, branch, repo e riferimenti esterni citati.
3. Cerca documentazione interna collegata con mcp-docs-navigator.
4. Ricostruisci lo stato del codice con git-node e, se serve, mcp-coldfusion-developer.
5. Verifica schema e dati reali con mcp-database-expert.
6. Solo se serve una prova funzionale, usa mcp-browser-automation.
7. Genera i documenti di analisi e, se richiesto, indicizzali.

Variante light ticket-first-light (prompt guidato di avvio)

Usa questa variante quando serve un avvio rapido da ticket con output breve, mantenendo la possibilita di escalation verso il flusso completo.

1. Leggi ticket, note e allegati essenziali con mcp-git-mantis-workflow.
2. Estrai riferimenti minimi (repo/commit/docs/db) e formula ipotesi iniziale.
3. Verifica velocemente una sola fonte tecnica prioritaria (di norma codice oppure docs).
4. Produci un mini-output con:
   • contesto del ticket
   • evidenze gia verificate
   • primi gap/punti aperti
   • prossimo passo consigliato
5. Se emergono dipendenze cross-repo, cross-db o dubbi sostanziali, passa subito a ticket-first completo.

Prompt guidato di avvio (template):

Parti dal ticket {ticket_id} in modalita ticket-first-light. Dammi un avvio rapido con evidenze osservate, inferenze iniziali e punti aperti prioritari. Se trovi complessita multi-sorgente, proponi esplicitamente l'escalation al flusso ticket-first completo di mcp-technical-analyst.

Entry point document-first

1. Leggi il documento sorgente con mcp-office-expert o mcp-docs-navigator.
2. Estrai nomi di ticket, repo, commit, DB, ambienti, URL e allegati menzionati.
3. Apri i filoni tecnici necessari con gli skill specialistici.
4. Confronta i fatti trovati e chiudi con deliverable strutturati.

Politica Interattiva

Prima esplora. Fai domande solo se manca davvero uno di questi elementi:

• un identificativo esterno non ricavabile localmente;
• il repository corretto tra piu candidati plausibili;
• il database o ambiente corretto tra piu opzioni equivalenti;
• una scelta di output che cambia materialmente il deliverable.

Quando devi chiedere, fai 1-3 domande mirate, corte e ad alto impatto. Se puoi procedere con un default ragionevole senza rischio alto, procedi e registra l'assunzione.

Vedi references/interactive-escalation.md.

Stop conditions ed escalation esplicite

Interrompi il flusso corrente e dichiara escalation quando:

• emerge una dipendenza non prevista su un secondo repository o database;
• la verifica minima produce evidenze in contraddizione non chiudibili con le fonti attuali;
• manca un identificativo esterno critico non ricavabile localmente.

Escalation standard:

1. ticket-first-light -> ticket-first completo quando scatta una condizione di complessita';
2. mcp-technical-analyst -> skill specialistico quando il problema si riduce a sola esecuzione mono-dominio;
3. verso utente solo per decisioni bloccanti non inferibili in sicurezza.

Contratto Di Output

Se il task e ampio, genera uno o piu documenti .md con sezioni chiare. Di default usa queste famiglie di output:

• requisiti e contesto;
• fonti e specifiche;
• stato attuale / sviluppo gia fatto;
• confronto tra implementazioni o ambienti;
• analisi tecnica finale con gap, rischi e proposta di completamento.

Nei documenti:

• redigi credenziali, token e segreti;
• cita ticket, commit, query, documenti e file in modo verificabile;
• separa le conclusioni dai fatti di partenza.

Vedi references/deliverable-templates.md.

Selezione Degli Skill Sidecar

• mcp-git-mantis-workflow: ticket, note, allegati, commit, branch, relazioni.
• mcp-docs-navigator: wiki, markdown, scaffali docs, tagging finale.
• mcp-database-expert: schema, dati reali, confronti dev/qa/prod.
• mcp-office-expert: PDF, DOCX, Excel, conversioni in Markdown.
• mcp-coldfusion-developer: CFML, log applicativi, codice legacy lato server.
• mcp-browser-automation: verifica UI, flussi, download, network e console quando strettamente necessario.

Riferimenti

• references/analysis-workflow.md
• references/ticket-first-light.md
• references/source-matrix.md
• references/deliverable-templates.md
• references/interactive-escalation.md
• references/functional-exploration.md