Claude Studio Dashboard · manuale d'uso
Come leggere i numeri, capire quando un valore chiede un'azione e quando invece va tutto bene. Pensata per chi apre la dashboard per la prima volta.
Una fotografia dello studio, scattata dai dati reali di lavoro.
La dashboard fotografa lo stato del lavoro fatto con Claude Code: quanto lavoro passa da processi codificati, per quali clienti Claude Code sta producendo qualcosa, quali strumenti hanno problemi, quanto costa ogni consegna. Non richiede inserimento manuale di dati: uno scanner legge i diari delle sessioni, i file consegnati nelle cartelle dei clienti e la telemetria dei consumi, e ne ricava tutti i numeri.
Quattro cose da sapere prima di leggerla:
Il riassunto in una riga: se hai 30 secondi, guarda solo queste.
È il numero principale: un punteggio unico che combina quattro ingredienti, ciascuno col suo peso. Misura affidabilità e ripetibilità del modo di lavorare, non quanto intensamente usi Claude. Va letto come un semaforo, non come una misura di precisione: i pesi sono una scelta progettuale dichiarata, e il pallino colorato accanto al numero dice subito in che fascia sei.
La formula
Indice = 0,30 × Metodo + 0,25 × Affidabilità + 0,25 × Strumenti + 0,20 × Copertura Claude Code
Metodo = % di sessioni operative dentro flussi codificati · Affidabilità = la «prima stesura buona»: % di consegne uscite giuste al primo colpo, senza interventi successivi · Strumenti = 100 meno le penalità dei problemi su ciò che usi davvero · Copertura = % di clienti per cui Claude Code ha prodotto qualcosa entro la cadenza attesa (14 giorni, salvo cadenze personalizzate): misura quanto è ampia l'adozione tra i clienti, non la salute dei rapporti.
Se nella finestra non c'è nessuna consegna valutabile, l'Affidabilità non entra e vale la formula a tre ingredienti (0,40 × Metodo + 0,30 × Strumenti + 0,30 × Copertura): la nota della tile lo dichiara.
Chiave di lettura concordata:
La nota sotto il numero mostra sempre gli ingredienti: così vedi subito quale sta tirando giù il punteggio, senza fare conti.
Su 100 sessioni di lavoro vero (le chat di sola conversazione non contano), quante sono passate da un flusso codificato — una skill, una pipeline — invece che dal lavoro «a mano libera». Più è alta, più il metodo di lavoro è industrializzato: ripetibile, delegabile, meno costoso. È l'ingrediente che pesa di più nell'Indice operativo (30%).
Per quanti clienti Claude Code non ha prodotto niente oltre la loro cadenza attesa: nessun file toccato nella loro cartella da più di 14 giorni oppure — per chi ha un ritmo diverso (mensili, stagionali, in pausa) — oltre la cadenza fissata per quel cliente nel config (voce cadenza_clienti).
Attenzione a cosa non dice: non dice che quel cliente è fermo, né che lo stai trascurando. Su quel cliente puoi avere avuto tre call, una campagna in corso e due consegne scritte a mano — niente di tutto questo passa da qui. La nota elenca i nomi: è la lista dei clienti che stai lavorando fuori da Claude Code. Serve a una domanda sola: di quel lavoro, c'è un pezzo che varrebbe la pena portare dentro un flusso? Se la risposta è no — perché per quel cliente il lavoro è di natura diversa — la cosa giusta da fare è fissargli la sua cadenza nel config, non rincorrere il numero.
Qui scendere è un bene: la pillola diventa verde quando il numero cala.
Quanto costa in media, in consumo di modello, ogni file consegnato. Il costo in euro compare quando la sonda di telemetria ha coperto almeno una consegna; il cambio dollaro→euro è quello ufficiale BCE del giorno, indicato nella nota. Se la telemetria non ha ancora dati, la tile mostra il vecchio indicatore sostitutivo: il peso del diario di sessione in KB diviso per le consegne. Questo numero non entra nella formula dell'Indice operativo: misura un costo, non un problema.
Quanti problemi concreti pesano sull'Indice operativo in questo momento: una skill invisibile, un connettore rotto, un controllo periodico fallito. Ogni voce ha un peso che viene sottratto al punteggio Strumenti. Zero è lo stato normale.
La pillola accanto a ogni numero
Ogni tile confronta il valore con lo scan precedente: «stabile» se la variazione è minima (sotto 0,5), altrimenti verde o rossa a seconda che il movimento sia buono o cattivo per quella metrica. Per Clienti senza Claude Code, Costo e Da riparare, scendere è un bene.
Cosa trovi scorrendo la pagina e a quale domanda risponde ogni card.
| Sezione | A quale domanda risponde |
|---|---|
| Andamento | Come si muovono nel tempo Indice, Metodo e Copertura? (finestre da 14 giorni a 12 mesi; i punti tratteggiati prima dello storico sono ricostruiti dai diari, settimana per settimana) |
| Confronto periodi | Questo periodo è andato meglio o peggio del precedente? (medie giornaliere su 7, 14 o 30 giorni; «—» = nessuno scan registrato in quel periodo) |
| Da riparare | Cosa è rotto adesso e quanto pesa sull'Indice? (passando il mouse su una voce vedi il peso, es. «pesa −15 sul punteggio Strumenti») |
| Decisioni in sospeso | Cosa aspetta solo una scelta — collegare o scollegare un servizio mai usato? Non penalizza l'Indice: è pulizia, non guasto. |
| Metodo | Dove nascono le prossime skill (Vivaio), quali sono ferme, quali sono nuove e in prova (Banco di prova), quanto lavoro è delegato agli orchestratori, quali flussi lavorano già per 2+ progetti (Flussi trasversali: il riuso del metodo tra clienti), cosa c'è in coda da costruire. |
| Attrito ed esecuzione | Quanto lavoro consegnato torna indietro? Autonomia dati, giri di revisione, prima stesura buona, consegne a settimana, sessioni sanguisuga, consumi del modello. |
| Consigli | La lista delle azioni suggerite, filtrabile per tag (MCP, Skill, Clienti, Metodo, Consumi…). Le voci marcate «ora» nascono dai dati di oggi; le altre sono buone abitudini sempre valide. |
| Controlli periodici | I check ricorrenti (con cadenza), l'ultimo esito e quando tocca rifarli. |
| Flussi di lavoro | Le mappe dei processi reali: chi fa cosa in ogni fase (tu, una skill, un servizio esterno) e con che frequenza. In testa, le barre «Sessioni per divisione del lavoro» (SEO & AEO, Video & YouTube, Gestione clienti…): ogni flusso porta il chip della sua divisione e la barra dei tag filtra le card. Una divisione con poche sessioni e nessun flusso codificato è il prossimo territorio da industrializzare. |
| Orchestratori e agenti | Le regie tra skill esistenti e le fasi di lavoro candidate a diventare agenti automatici. |
| Skill / Progetti / Uso | L'inventario: tutte le skill con il loro stato tecnico, i progetti con l'ultima lavorazione passata da Claude Code (il chip «no Claude Code» dice solo questo, non che il progetto è fermo), le classifiche d'uso di skill e connettori negli ultimi 30 giorni. |
| MCP e plugin | Lo stato dei connettori esterni e dei plugin installati. |
Cinque situazioni prese dalla dashboard demo (la stessa che vedi nella pagina di esempio), lette passo per passo.
Lettura. Il pallino è verde, ma 82 è vicino al limite della fascia. La nota dice da dove viene il punteggio: Metodo 76, Affidabilità 85, Strumenti 85, Copertura 83. Il numero più basso è il Metodo, che è anche quello che pesa di più (30%). Interpretazione: se vuoi far salire l'Indice, il modo più efficiente non è sistemare gli strumenti, ma far passare più sessioni dai flussi codificati — ogni punto di Metodo vale 0,3 punti di Indice, contro 0,25 di Affidabilità e Strumenti e 0,2 della Copertura.
Lettura. Per un cliente, Claude Code non ha prodotto niente oltre la sua cadenza attesa (qui il default: 14 giorni), e la nota dice chi è: B&B Riviera. Lo stesso dato abbassa la Copertura Claude Code (83 invece di 100) e quindi l'Indice.
Interpretazione. Questa è l'unica cosa che il numero dice. Su B&B Riviera puoi averci lavorato eccome — call, sopralluoghi, foto, una campagna avviata a mano — ma quel lavoro non è passato dal workspace, quindi lo scanner non lo vede. Il consiglio che la dashboard genera resta perciò dentro il suo perimetro («Su B&B Riviera non passi da Claude Code da 21 giorni (cadenza attesa: ≤14gg): se ci stai lavorando lo stesso, guarda quale parte di quel lavoro può passare da una skill o da un flusso»): la domanda è se c'è un pezzo di quel lavoro che conviene codificare, non se il cliente va richiamato — quello lo sai tu, la dashboard no. E se per quel cliente il ritmo lento è normale — un report al mese, un servizio stagionale, un lavoro che per sua natura si fa fuori da Claude — fissagli la sua cadenza in cadenza_clienti nel config: smetterà di comparire qui senza motivo.
Lettura. C'è un problema aperto. Nella card «Da riparare» si scopre quale: l'autorizzazione del connettore «SEO Tool (keyword)» è scaduta, e siccome è stato usato di recente pesa −15 sul punteggio Strumenti. Ecco spiegato l'85 dell'esempio 1: 100 − 15. Interpretazione: riautorizzando il connettore (con /mcp in sessione), Strumenti torna a 100 e l'Indice sale di 3–4 punti. Nota il contrasto: le autorizzazioni scadute di servizi mai usati non finiscono qui ma in «Decisioni in sospeso», e non tolgono punti — un servizio che non usi non è un guasto, è una decisione da prendere.
Nella card Attrito ed esecuzione: Prima stesura buona 85% — 34 consegne su 40 uscite giuste al primo colpo; delle altre, 5 corrette o integrate in chat, 1 ripresa in un'altra sessione, 0 corrette a mano. È il first-pass yield dello studio: la percentuale di lavori completati senza interventi successivi.
Lettura. L'85% è sopra la soglia di attenzione del 60%, quindi nessun consiglio scatta: va bene così. Questo numero è anche l'ingrediente Affidabilità dell'Indice operativo (peso 25%): è l'85 che compare nella nota della tile dell'esempio 1. Interpretazione: se scendesse sotto il 60%, comparirebbe il consiglio di travasare le correzioni ricorrenti nel CLAUDE.md del progetto o nella skill — scriverle una volta lì costa meno che ripeterle in chat a ogni consegna. Occhio al limite dichiarato: la metrica non distingue una correzione («rifallo») da un'integrazione («aggiungi anche…»), e non vede le modifiche fatte sulla copia caricata su Google Drive.
Lettura. La telemetria ha registrato 41,85 $ di consumo di modello per 14 consegne: 2,63 € a consegna al cambio BCE del giorno. La parte token dice com'è composta la spesa: 214.000 token di input, 168.000 di output e ben 15,6 milioni di cache — e la cache costa una frazione dell'input pieno, quindi un numero di cache alto è un buon segno, non un allarme. Interpretazione: la media diventa affidabile man mano che le consegne coperte si accumulano. Il confronto utile è il trend nelle settimane, non il singolo giorno.
L'elenco completo degli automatismi: quando scattano e cosa suggeriscono. È la sezione da consultare quando compare un avviso e vuoi sapere «perché me lo sta dicendo».
| Indicatore | Soglia | Cosa succede / cosa ti dice |
|---|---|---|
| Indice operativo | ≥ 80 · 60–79 · < 60 | Chiave di lettura a semaforo — il pallino verde/giallo/rosso accanto al numero: in salute · da tenere d'occhio · serve un intervento. La nota mostra sempre gli ingredienti per capire quale sta pesando. |
| Affidabilità nell'Indice | ≥ 1 consegna valutabile | L'ingrediente Affidabilità (la «prima stesura buona», peso 25%) entra nell'Indice appena la finestra contiene almeno una consegna valutabile; senza, vale la formula a tre ingredienti (0,40·Metodo + 0,30·Strumenti + 0,30·Copertura) e la nota della tile lo dichiara. |
| Pillola di variazione | ± 0,5 | Variazione sotto 0,5 rispetto allo scan precedente = «stabile»; oltre, pillola verde o rossa secondo la direzione buona della metrica (per Clienti senza Claude Code, Costo e Da riparare scendere è un bene). |
| Costo per consegna | ≥ 1 consegna coperta | La tile passa da «Peso per consegna» (KB, indicatore sostitutivo) a «Costo per consegna» (€) appena la telemetria copre almeno una consegna. Cambio BCE del giorno; lo storico resta in dollari. |
| Problema | Peso | Cosa succede / cosa ti dice |
|---|---|---|
| Livello critico | −40 | Guasto strutturale grave (es. un controllo periodico fallito a livello critico). |
| Livello serio | −25 | Es. skill con symlink mancante o incoerente (la skill è invisibile a Claude Code), connettore MCP con un problema di configurazione. |
| Livello attenzione | −10 | Es. skill o progetto non indicizzati in CLAUDE.md, progetto senza CLAUDE.md, cartella anomala tra le skill, controllo periodico con esito «attenzione». |
| Autorizzazione MCP scaduta, ma il servizio serve | −15 | Scatta solo se il servizio è stato usato negli ultimi 30 giorni oppure è una dipendenza di un flusso codificato. Consiglio: riattivala con /mcp o dalle impostazioni claude.ai. |
| Autorizzazione scaduta su servizio mai usato | 0 (nessuna penalità) | Va in «Decisioni in sospeso»: «collegalo o scollegalo». Non è un problema di salute, è mancato utilizzo. |
| Servizio claude.ai collegato ma mai usato in 30 giorni | 0 (nessuna penalità) | Va in «Decisioni in sospeso»: «serve davvero?». Pulizia, non guasto. |
| Sonda telemetria muta | > 2 giorni | Se le sessioni continuano ma i dati di costo non arrivano da più di 2 giorni: alert con il suggerimento di riavvio della sonda (configurabile: telemetry.restart_hint; vedi telemetry/README.md del repo). |
| Indicatore | Soglia | Cosa succede / cosa ti dice |
|---|---|---|
| Cliente senza Claude Code | > 14 giorni, o la cadenza del cliente | Un cliente per cui Claude Code non ha prodotto niente oltre la sua cadenza attesa: entra nella tile Clienti senza Claude Code, abbassa la Copertura (e quindi l'Indice) e genera il consiglio «se ci stai lavorando lo stesso, guarda quale parte di quel lavoro può passare da una skill o da un flusso». Non è un giudizio sul rapporto col cliente: quel cliente può essere il più attivo che hai, se il lavoro lo fai fuori dal workspace. La cadenza è 14 giorni di default (thresholds.freddo_giorni), ma si fissa cliente per cliente con cadenza_clienti — per i clienti mensili, stagionali, in pausa o lavorati per lo più fuori da Claude. Il progetto-hub (voce hub_project del config) non conta: non è un cliente. |
| Indicatore | Soglia | Cosa succede / cosa ti dice |
|---|---|---|
| Vivaio | ≥ 3 volte in 30 giorni | Lo stesso tipo di consegna fatta «a mano libera» (stesso progetto, stesso formato, in sessioni senza skill) si ripete almeno 3 volte: la procedura viene rispiegata a ogni sessione, e conviene fissarla in una skill — risultato costante, sessioni più corte, Quota di metodo che sale. Per farlo: di' in chat «creiamo una skill per questo lavoro»; si progetta con skill-creator, si collauda su un caso reale, e dal giro dopo esce dal Vivaio. |
| Automazioni ferme | 0 usi in 30 giorni | Skill mai usata nella finestra (con 7 giorni di grazia dalla creazione: una skill appena nata non è «ferma»). Consiglio: rilanciala con un caso reale o archiviala. |
| Banco di prova | ≤ 60 giorni di vita | Le skill create di recente restano sotto osservazione ROI: la card mostra età e numero di usi, per capire se l'investimento sta rendendo. |
| Flusso trasversale | consegne per ≥ 2 progetti | Un flusso codificato che ha consegnato per almeno 2 progetti diversi nella finestra: la ricetta è riusata tra clienti, quindi è diventata capitale dello studio. Non fa scattare consigli: si legge come inventario — più flussi trasversali hai, più il metodo si ripaga da solo. |
| Fase candidata ad agente | ≥ 2 sessioni · ≥ 50% del flusso · media ≥ 8 azioni | Una fase di un flusso svolta da servizi esterni o ricerche web, ricorrente, pesante e senza un tuo checkpoint in mezzo: candidata a girare da sola come agente in background. Consiglio: «quando il flusso torna a girare, valutiamo un agente». |
| Orchestratore da creare | sequenze ricorrenti | Skill che vengono usate spesso in sequenza nella stessa sessione: candidata una skill-regia che le concateni. Le candidature contano nella «Coda investimenti». |
| Indicatore | Soglia | Cosa succede / cosa ti dice |
|---|---|---|
| Prima stesura buona | < 60% (su ≥ 5 consegne) | Sotto il 60% la dashboard ti suggerisce di travasare le correzioni ricorrenti nel CLAUDE.md del cliente o nella skill: scriverle una volta lì costa meno che ripeterle in chat. La soglia è volutamente bassa perché la metrica conta anche le integrazioni, non solo le correzioni. |
| Autonomia dati | < 50% (su ≥ 3 sessioni) | Più della metà delle sessioni con dati esterni parte da file esportati a mano: la dashboard suggerisce di guardare quale fonte importi più spesso e coprirla con un connettore MCP (o uno script) per eliminare il copia-incolla. |
| Sessione sanguisuga | > 250 KB · ≥ 3 giri · 0 consegne | Diario pesante, tante richieste, nessun file consegnato. Consiglio: se il lavoro rinasce, spezzalo in sessioni più piccole o passa da una skill. Ne vengono mostrate al massimo 3, le più pesanti. |
| Giri di revisione | nessuna soglia fissa | Media dei tuoi messaggi dopo la prima consegna. Non fa scattare consigli: si legge in tendenza — se cresce, il brief o la skill vanno raffinati. |
| Classificazione | Regola | Cosa significa |
|---|---|---|
| Corretta in chat | riscritta dopo un tuo messaggio | Il file è stato riscritto nella stessa sessione dopo un tuo intervento: la prima stesura non era definitiva (o hai chiesto un'integrazione). |
| Ripresa | tra 1 ora e 7 giorni | Il file è stato riscritto in un'altra sessione entro 7 giorni dalla consegna (i file cumulativi, tipo le content bank, rientrano qui per natura). |
| Corretta a mano | > 1 ora dopo | Il file risulta modificato sul disco più di un'ora dopo l'ultima scrittura di Claude: la modifica è considerata tua. |
| Consegne / settimana | per file, non per salvataggio | Ogni file consegnato conta una volta sola, anche se è stato salvato più volte. |
| Divisioni del lavoro | 1–2 tag per flusso | Ogni flusso appartiene a una o due divisioni (la prima è la principale); la mappa vive nel config.json (voce flow_tags). Un flusso con due divisioni conta in entrambe le barre. Le skill-attrezzo (xlsx, dataviz…) non dicono la divisione: confluiscono nel Lavoro libero. «Da classificare» = flusso nuovo senza tag: il segnale per assegnargliene uno nel config. |
| Storico e confronti | 1 riga/giorno · max 400 giorni | Ogni scan salva la giornata (l'ultimo scan del giorno vince). Il Confronto periodi media i giorni registrati su finestre di 7, 14 o 30 giorni; «—» = nessuno scan in quel periodo. |
| Andamento (backfill) | ≥ 3 sessioni/settimana | Per il periodo precedente allo storico, la Quota di metodo è ricostruita dai diari settimana per settimana, solo per le settimane con almeno 3 sessioni operative. |
I termini della dashboard, in ordine alfabetico.
thresholds.freddo_giorni), personalizzabile cliente per cliente nel config (voce cadenza_clienti) per i contratti mensili, stagionali, in pausa o per i clienti che lavori quasi sempre fuori dal workspace.~/.claude/skills) e si attiva per nome.I limiti dichiarati, per non sovra-interpretare i numeri.
/mcp in sessione è la fonte autorevole.