siae-dev-analytics

name

siae-dev-analytics

description

Use when measuring velocity and quality of SIAE developers using Claude Code + DevForge, or generating the ROI / KPI Excel report. Misura velocità e qualità degli sviluppatori SIAE che usano Claude Code + DevForge. Genera report Excel con 11 KPI (DORA + DX AI Measurement) + ROI Index. Trigger: "misura produttività dev", "ROI Claude Code", "KPI sviluppatori", "analytics dev", "report performance team", "/forge-analytics", "dev metrics", "velocity quality report", "dashboard produttività", "cosa fanno gli sviluppatori", "benchmark dev", "ROI AI coding".

siae-dev-analytics — Developer Analytics & ROI Report

Tipo: Rigid | Fase SDLC: 5. Review/Metrics

LA LEGGE DI FERRO

DATI NOMINATIVI SOLO DOPO CONFERMA ESPLICITA — CARD 🔴 ALTO OBBLIGATORIA

Scopo

Analizza repository GitHub SIAE per calcolare KPI velocity + quality per sviluppatore, produce report Excel consumabile da management.

AUTO-BEST mode: la skill rileva automaticamente le fonti dati disponibili e tira il massimo:

• GitHub (sempre obbligatorio, ground truth)
• S3 telemetria DevForge (opzionale, se disponibile blend con costi Claude Code)
• Git trailers locali (se repo clonato)

Flow

Step 1 — Check ambiente

Run:

gh auth status 2>&1 | grep -q "Logged in" || echo "ABORT: gh not authenticated"
python3 --version | awk '{print $2}' | awk -F. '{if ($1 < 3 || $2 < 10) print "ABORT"}'
pip install -r skills/siae-dev-analytics/scripts/requirements.txt 2>&1 | tail -3

Se ABORT → mostra errore e ferma.

Step 2 — Carica config

1. Cerca devforge-analytics.yml nella working directory
2. Se non esiste → prompt utente per scope minimo (repos + finestra)
3. Valida con Pydantic

Step 3 — Autodetect sources

Run:

python3 skills/siae-dev-analytics/scripts/run_analytics.py autodetect --config <path>

Output atteso (JSON):

{"github": true, "s3_devforge": false, "s3_blend": false, "mode": "GITHUB-ONLY"}

Step 4 — Gate 🔴 ALTO privacy

Mostra card con N dev, N repo, finestra, mode. Richiedi conferma esplicita.

Template card:

🔴 ALTO (dati personali sviluppatori) — 🔨 DevForge · siae-dev-analytics
⚠️ OPERAZIONE CON DATI PERSONALI
👥 Dev coinvolti: <N> · 📅 Finestra: <from → to> · 📁 Repo: <N> · 🎯 Mode: <FULL/HYBRID/GITHUB-ONLY>
▼ Azione
1. 📊 Fetch dati GitHub nominativi + calcolo KPI individuali
2. 📤 Output Excel con tabelle per-dev
💡 Perche': Valutazione ROI Claude Code + reportistica management
🚫 Se NO: Abort. Nessun fetch, nessun file prodotto.
🔒 Alternativa: rerun con --anonymize → hash SHA256 dei login

⏸️ ATTENDI CONFERMA ESPLICITA — mostra la card e NON eseguire finché l'utente risponde esplicitamente ("sì, procedi" / "no, annulla"). Silenzio ≠ consenso.

Step 5 — Pipeline

Run:

python3 skills/siae-dev-analytics/scripts/run_analytics.py run --config <path> [--anonymize] [--format xlsx|csv|both]

Step 6 — Report narrativo

Dopo produzione Excel, Claude genera markdown summary con:

• Top 3 dev per ROI Index
• Insight principali (es. "il team ha cycle time mediano 24h, in linea con DORA elite")
• Raccomandazioni management
• Path file Excel prodotto

Trigger Keywords

• "misura produttività dev"
• "ROI Claude Code"
• "KPI sviluppatori"
• "analytics dev"
• "report performance team"
• "/forge-analytics"
• "dev metrics"
• "velocity quality report"
• "dashboard produttività"
• "cosa fanno gli sviluppatori"
• "benchmark dev"
• "ROI AI coding"

Limiti Operativi

Vincolo	Limite	Se superato
Repo max per run	50	Batch in più run
Dev max per run	100	Report diventa rumoroso
Finestra max	365gg	Spezza in più run annuali

Anti-Pattern

Pensiero	Realtà
"È solo un report, non serve card 🔴"	Dati nominativi = GDPR. Card sempre.
"LOC/giorno è una metrica valida"	Anti-pattern DORA. Non includerla mai.
"Self-reporting dev sarebbe utile"	Perception gap documentato (METR 2025). Solo metriche oggettive.
"Posso saltare autodetect, so cosa c'è"	L'ambiente cambia. Autodetect sempre.

Permission Denied Handling

• Se pip install negato → prompt card 🟡 MEDIO con alternative (venv, pipx, uv)
• Se gh non autenticato → ABORT con istruzioni gh auth login
• Se S3 creds mancanti → graceful degrade GITHUB-ONLY, noted in report

Guardrail operativi (centralizzati)

• Classificazione Rischio Operazioni: vedi lib/risk-taxonomy.md (tassonomia comune DevForge).
• Tabella Anti-Razionalizzazione: vedi lib/risk-taxonomy.md + lib/permission-denied-handling.md; regola locale: nessuna scorciatoia "solo questa volta" — se un gate blocca, il fix è soddisfarlo, non aggirarlo.