Claude Code Superpowers: framework di skill per lo sviluppo AI strutturato

Claude Code è felice di scriverti mille righe di codice dall’aspetto impeccabile che non hai richiesto.

Nella maggior parte dei casi ti serve una piccola correzione, ma lui ti propone un refactor, una logica “migliorata”, tre file nuovi e test che passano perché non testano niente. L’agente non chiede mai cosa stai davvero cercando di costruire e non si ferma mai a rivedere il proprio lavoro. È il comportamento predefinito di molti assistenti di coding, ed è il motivo per cui così tante sessioni richiedono due ore per compiti da 15 minuti.

Superpowers è un plugin per Claude Code, creato da Jesse Vincent, che risolve il problema mostrando a Claude un workflow di ingegneria disciplinato. Copre brainstorming, sviluppo guidato dai test, debugging sistematico, sviluppo guidato da subagent, code review e authoring di skill, così che Claude si comporti più come un vero ingegnere su cui puoi contare.

In questo articolo ti guiderò attraverso cos’è Superpowers, come funzionano le sue skill e come usarlo per uno sviluppo assistito dall’AI strutturato.

Se stai appena iniziando con l’AI generativa, iscriviti al nostro corso Generative AI Concepts: ti darà basi solide in un pomeriggio.

Che cos’è Claude Code Superpowers?

Superpowers è un framework di skill che cerca di trasformare Claude Code in un ingegnere disciplinato.

È un plugin creato da Jesse Vincent e dal team di Prime Radiant, distribuito tramite il marketplace ufficiale dei plugin di Claude. Il plugin installa una libreria di skill componibili che coprono l’intero ciclo di vita dello sviluppo software, dal refining dei requisiti al merge di un branch finito.

Ogni skill è una metodologia strutturata per un tipo di attività. Alcune coprono pianificazione e design, altre implementazione, debugging, test o review. Lavorano insieme, così Claude può concatenarle lungo un workflow completo invece di trattare ogni richiesta come un caso isolato.

Con Superpowers, ottieni un agente di coding che si ferma a pensare, scrive i test prima del codice, esegue il debug partendo dalla causa radice invece di indovinare e rivede il proprio lavoro prima di dichiararlo concluso.

Come funziona Claude Code Superpowers

Superpowers cambia il comportamento di Claude fornendogli un set di skill a cui può attingere, oltre a slash command che eseguono workflow specifici.

Una skill è un piccolo file markdown con una metodologia chiara scritta per essere seguita da Claude. Quando un compito corrisponde allo scopo di una skill, Claude la legge e applica i passaggi. Non devi memorizzare cosa fa ciascuna skill. Claude verifica le skill pertinenti prima di iniziare qualsiasi attività e le richiama automaticamente.

Puoi anche attivare workflow con gli slash command. Per esempio, descrivere cosa vuoi costruire attiva automaticamente la sessione di design socratico della skill di brainstorming. Una volta approvato il design, la skill writing-plans lo scompone in task piccoli e verificabili, ed executing-plans o subagent-driven-development esegue il piano con checkpoint di review integrati.

Lo schema generale segue sempre gli stessi tre passaggi:

1. Richiami una skill descrivendo il compito o eseguendo uno slash command.
2. Claude segue la metodologia della skill passo dopo passo, invece di improvvisare. Per il debugging, significa un processo in quattro fasi fino alla causa radice. Per il TDD, significa scrivere un test fallito prima di qualsiasi codice di implementazione.
3. Checkpoint o review guidano l’attività. Alcune skill si fermano in attesa della tua approvazione prima di proseguire. Altre avviano un nuovo subagent per rivedere il lavoro rispetto al piano e segnalare i problemi per gravità.

L’agente non aspetta che tu scriva un prompt perfetto perché conosce già il processo e lo esegue, chiedendo input solo quando serve davvero una tua decisione. È questo che rende il framework diverso dall’uso normale di Claude Code.

Skill principali in Claude Code Superpowers

Superpowers include una libreria di skill, ma te ne bastano poche per fare la maggior parte del lavoro.

Brainstorming

La skill brainstorming si attiva prima che venga scritto qualsiasi codice.

Forza un botta e risposta socratico che affina ciò che vuoi davvero, invece di lasciare che Claude salti subito alla soluzione. Claude fa domande mirate ed esplora alternative a cui forse non avevi pensato.

L’output è un documento di design suddiviso in piccole sezioni che puoi leggere e verificare. Nulla prosegue finché non avrai approvato il design, eliminando alla radice il problema “Claude ha costruito la cosa sbagliata”.

Test-Driven Development

La skill test-driven-development impone il classico ciclo RED-GREEN-REFACTOR.

• RED: Claude scrive prima un test che fallisce e lo esegue per confermare che fallisca per il motivo giusto.
• GREEN: Claude scrive il minimo codice necessario per far passare il test.
• REFACTOR: Una volta che il test è verde, Claude ripulisce l’implementazione senza cambiarne il comportamento.

I test devono fallire prima che venga scritto qualsiasi codice di implementazione. Se Claude scrive codice prima che esista un test, la skill gli dice di eliminare quel codice e ricominciare. È una regola ferrea.

Debugging sistematico

La skill systematic-debugging sostituisce le patch casuali con un processo in quattro fasi.

1. Indagine sulla causa radice: Claude riproduce il bug e lo traccia fino alla vera origine invece di lavorare sul primo sintomo che trova.
2. Analisi dei pattern: Claude cerca problemi correlati altrove nel codice che condividono la stessa causa.
3. Verifica dell’ipotesi: Claude formula una teoria esplicita sulla correzione e la valida prima di cambiare qualcosa.
4. Implementazione: Solo dopo le tre fasi precedenti Claude scrive la fix.

La skill ha anche un meccanismo di sicurezza integrato. Se tre tentativi di correzione falliscono di seguito, Claude smette di guardare il codice ed esegue invece una revisione architetturale. Questo interrompe il loop in cui l’agente continua a provare piccole patch su un problema che richiede un ripensamento più profondo.

Sviluppo guidato da subagent

La skill subagent-driven-development suddivide il lavoro tra nuovi subagent invece di eseguire tutto in un unico lungo contesto.

Per ciascun task del piano, Claude crea un nuovo subagent. Quel subagent implementa il task, poi un subagent di review separato esegue un controllo in due fasi sul lavoro: prima per la conformità alle specifiche, poi per la qualità del codice. Se uno dei due controlli fallisce, il task torna indietro per le correzioni prima che inizi il successivo.

Ogni subagent vede solo ciò che gli serve per il proprio task specifico, e la fase di review intercetta le derive prima che creino caos.

Authoring di skill

La skill writing-skills ti permette di costruire nuove skill per Superpowers stesso.

Claude ti guida nello scrivere la metodologia della skill, testarla su scenari reali e affinarla in base a come si comporta. La stessa disciplina TDD si applica anche qui: definisci cosa deve fare la skill, scrivi i test per quel comportamento e solo dopo scrivi le istruzioni della skill.

Questo rende Superpowers estendibile. Puoi codificare le convenzioni specifiche del tuo team o checklist di review, e Claude le seguirà come qualunque altra parte del framework.

Slash command di Superpowers

Gli slash command sono il modo in cui dici a Claude quale workflow eseguire.

Puoi descrivere un’attività in inglese semplice e lasciare che Claude scelga la skill giusta, oppure avere controllo diretto con gli slash command. Sono comodi quando sai esattamente in quale fase del workflow vuoi trovarti e non vuoi che Claude indovini.

I comandi corrispondono a punti specifici del ciclo di sviluppo. Alcuni avviano un workflow da zero, altri eseguono un passaggio discreto all’interno di uno più ampio.

Una sessione tipica potrebbe essere così:

• Parti con /superpowers:brainstorm per affinare i requisiti di una nuova feature. Claude conduce una sessione di domande socratiche, fa emergere i casi limite e produce un documento di design da approvare.

• Una volta approvato il design, esegui /superpowers:plan per suddividerlo in task piccoli e verificabili con percorsi dei file esatti e modifiche al codice.

• Poi /superpowers:execute-plan esegue quei task con checkpoint integrati, creando subagent e fermandosi per la review dove previsto dal piano.

• Dopo l’implementazione, /superpowers:review esegue l’agente di code review sul lavoro per intercettare problemi prima di procedere oltre.

Nota: Superpowers è in fortissimo sviluppo. Al momento della stesura, era stata rilasciata una nuova versione proprio il giorno prima e i nomi dei comandi potrebbero cambiare tra le versioni, quindi controlla il repo GitHub del progetto per la sintassi aggiornata.

Code review in Superpowers

Dopo che Claude implementa un task o un batch di task, l’agente code-reviewer viene eseguito come subagent separato con un contesto pulito. Non vede la cronologia della conversazione che ha portato all’implementazione, ma solo il piano, il codice e i criteri di review. È importante perché vuoi che il revisore sia il più imparziale possibile.

Il revisore controlla tre cose:

1. Implementazione rispetto al piano: Il codice fa ciò che il piano diceva? Mancano pezzi o sono state implementate funzionalità extra?
2. Standard di coding: Il codice segue le convenzioni del progetto? Questo include naming, formattazione, gestione degli errori e qualsiasi regola dal tuo file CLAUDE.md.
3. Coerenza architetturale: Il codice si inserisce nell’esistente struttura della codebase o Claude ha introdotto un nuovo pattern fuori posto?

I problemi tornano classificati per gravità. Le criticità bloccano l’avanzamento finché non sono risolte. Le segnalazioni meno gravi vengono riportate così puoi decidere cosa affrontare ora e cosa dopo.

In sintesi, Claude non può dichiarare un task concluso solo perché il codice compila o i test passano. Un agente separato deve confermare che il lavoro rispetta il piano e si integra con la codebase.

TDD con Claude Code Superpowers

La maggior parte degli assistenti di coding considera i test un “nice-to-have”.

Chiedi una feature, loro la scrivono e i test arrivano come ripensamento, se arrivano. Il risultato è codice che “funziona” perché nessuno ha davvero provato che lo faccia. Superpowers fa sì che il test sia la prima cosa che Claude scrive e il meccanismo che governa tutto il resto.

La skill test-driven-development fa passare Claude per il ciclo RED-GREEN-REFACTOR ad ogni modifica.

Passaggio 1: Scrivi un test che fallisce

Claude scrive un test per il comportamento desiderato e lo esegue.

Il test deve fallire. Se passa al primo run, significa che il comportamento esiste già o che il test non verifica ciò che dovrebbe. In ogni caso, Claude non procede finché il test non fallisce e il motivo del fallimento non è chiaro.

Questo passaggio costringe anche Claude a pensare a cosa significhi “finito” prima di scrivere qualsiasi implementazione. Il test è una specifica eseguibile.

Passaggio 2: Implementa la correzione minima

Claude scrive la quantità minima di codice che fa passare il test fallito.

L’obiettivo è passare da RED a GREEN con il minor codice possibile. Se Claude prova a fare di più, la skill lo limita. Qui entra in gioco YAGNI (You Aren't Gonna Need It). Claude costruisce solo ciò che serve oggi, non quello che forse servirà domani.

Passaggio 3: Refactor

Quando il test è verde, Claude ripulisce il codice senza cambiarne il comportamento.

Il refactor è la fase in cui migliora la struttura. Claude potrebbe estrarre un helper o dividere una funzione lunga, ma il test deve continuare a passare dopo ogni modifica. Se un refactor rompe il test, si torna indietro.

Passaggio 4: Review

Prima che inizi il prossimo task, l’agente di code review esegue i controlli sul nuovo codice.

Controlla l’implementazione rispetto al piano, il test rispetto al requisito e l’intera modifica rispetto agli standard del progetto. Se qualcosa fallisce, il task non è concluso.

La regola è che il codice scritto prima che esista un test viene eliminato. Se Claude salta avanti e implementa qualcosa senza un test fallito già in posizione, la skill gli impone di buttare quel codice e iniziare correttamente il ciclo.

Debugging con Claude Code Superpowers

Il debugging è un’area in cui gli strumenti di coding AI sono ancora carenti, anche nel 2026.

La skill systematic-debugging è stata progettata per evitare che ciò accada.

Invece di applicare patch a caso, Claude attraversa quattro fasi in ordine. Prima l’indagine sulla causa radice: riprodurre il bug in modo affidabile, poi tracciarlo fino alla vera origine invece del primo sintomo. Poi l’analisi dei pattern, dove Claude cerca problemi correlati altrove che condividono la stessa causa. Quindi la verifica dell’ipotesi, in cui Claude dichiara una teoria esplicita sulla fix e la valida prima di modificare qualcosa. Solo dopo questi tre passaggi avviene l’implementazione.

È più lento per tentativo, ma molto più rapido nel complesso. Passi meno tempo a guardare Claude indovinare e più tempo a risolvere davvero il problema.

La skill include anche una salvaguardia integrata quando le cose vanno male. Se tre tentativi di correzione falliscono di seguito, Claude smette di fare piccole patch ed esegue invece una revisione architetturale.

Ripetuti fallimenti sono un segnale che il problema non è dove pensi, o che il design è sbagliato. Superpowers tratta il terzo fallimento come un segnale di stop e impone un passo indietro per guardare il quadro generale.

Scrivere nuove skill con Superpowers

Superpowers offre una buona libreria predefinita, ma la parte migliore è che puoi estenderla.

Ogni team ha convenzioni che non si allineano perfettamente alle best practice pubbliche. Di default, Claude non conosce le tue convenzioni, quindi finisci per ripeterti in ogni prompt. Le skill personalizzate risolvono il problema codificando una volta le tue regole e lasciando che Claude le segua sempre.

La skill writing-skills ti guida nella costruzione di una nuova skill. Applica la stessa disciplina TDD che Superpowers usa per il codice: definisci cosa deve fare la skill, scrivi i test per quel comportamento e solo poi scrivi la skill stessa.

Scrivere una skill

Una skill è un file markdown con una metodologia che Claude può seguire.

Inizi descrivendo il problema che la skill risolve e il trigger che dovrebbe attivarla. Poi scrivi i passaggi che Claude deve svolgere, i controlli da eseguire e le regole da non infrangere mai. Il formato è testo strutturato, non codice, così chiunque nel team può leggerlo e modificarlo.

La skill writing-skills ti aiuta a evitare le trappole comuni. Skill troppo vaghe vengono ignorate e skill troppo rigide di solito non funzionano sui casi limite. Skill sovrapposte a quelle esistenti portano Claude a scegliere la metodologia sbagliata.

Testare una skill

Superpowers tratta il test delle skill come un compito di ingegneria. Scrivi scenari che la skill dovrebbe coprire, esegui Claude su quegli scenari con la skill caricata e verifica se il comportamento corrisponde a quanto specificato. Se Claude fa la cosa sbagliata, la skill va migliorata.

Questo colma il divario tra ciò che intendevi e ciò che hai scritto. Una skill che per te è chiara potrebbe essere ambigua per Claude, e l’unico modo per saperlo è provarla su casi reali.

Migliorarla nel tempo

La prima versione di una skill di solito manca di casi limite a cui non avevi pensato. Magari Claude segue la metodologia ma salta un passaggio che davi per scontato. Magari la skill si attiva in situazioni in cui non dovrebbe. Ogni lacuna ti indica come raffinare la skill.

Col tempo, la tua libreria di skill diventa il resoconto di come lavora davvero il tuo team. Contiene gli errori che hai già pagato e le regole nate da quegli errori. I nuovi ingegneri non devono imparare le tue convenzioni, perché Claude le segue già.

È questo che rende Superpowers un framework e non solo un plugin.

Le skill di default sono un punto di partenza. Il vero valore emerge quando tratti la libreria di skill come codice di tua proprietà, da rivedere e migliorare come qualsiasi altra cosa nel repo.

Claude Code Superpowers vs Claude Code standard

Claude Code standard è un agente di coding generico. Gli dici cosa vuoi e lui capisce come farlo.

Quella flessibilità è l’essenza. Puoi chiedergli di rifattorizzare un file, fare il debug di una funzione, scrivere test o spiegare un pezzo di codice, e lui si adatta alla richiesta. Ma la qualità dell’output dipende da quanto bene lo guidi con il prompt. Un prompt vago produce una risposta vaga e un prompt dettagliato con vincoli ed esempi di solito porta a qualcosa di più vicino a ciò che vuoi.

Superpowers è tutto questo con struttura aggiuntiva. Le skill definiscono come Claude affronta compiti specifici, così non devi specificare la metodologia ogni volta. Il TDD ha già un workflow. Il debugging ha già un processo. La code review ha già criteri. Più cose sono pronte all’uso.

Ecco una panoramica affiancata:

Claude Code vs Superpowers

Claude Code standard resta utile perché non ogni attività richiede un workflow, e imporre struttura a una correzione di cinque righe è eccessivo. Scegli Superpowers quando il lavoro è più grande di quanto un singolo prompt possa descrivere bene.

Claude Code Superpowers vs altri plugin di Claude

Superpowers non è l’unico plugin nel marketplace di Claude, ma è uno dei pochi che si concentra su come lavori.

Gli altri plugin popolari risolvono problemi più specifici.

• Frontend Design genera frontend con un’estetica distintiva, così la tua UI non assomiglia a ogni altra pagina costruita dall’AI.
• Code Review esegue agent di review specializzati sulle pull request con filtraggio basato sulla confidenza, utile se la review è l’unica parte del tuo workflow che vuoi migliorare.
• Context7 porta nel contesto di Claude documentazione e esempi di codice live e specifici di versione dai repo sorgente, risolvendo il problema “Claude usa API obsolete”.
• Skill Creator ti aiuta a costruire, valutare e fare benchmark di singole skill.

Ognuno di questi fa bene una cosa. Installi Frontend Design quando vuoi codice UI migliore. Installi Context7 quando vuoi documentazione aggiornata nel contesto.

Superpowers è l’opposto. Non aggiunge una nuova capacità a Claude, cambia il modo in cui Claude affronta l’intero ciclo di sviluppo. Brainstorming, pianificazione, implementazione, test, debugging, review e merge ottengono tutti una metodologia definita. Le skill lavorano insieme invece di esistere come funzionalità isolate.

Puoi usare Superpowers insieme agli altri.

Context7 dentro una sessione Superpowers significa che Claude segue un workflow disciplinato e usa documentazione aggiornata. Frontend Design dentro una sessione Superpowers significa che Claude costruisce la tua UI con lo stesso ciclo piano-implementazione-review del resto.

Chi dovrebbe usare Claude Code Superpowers?

Superpowers dà il meglio quando il lavoro è abbastanza complesso da richiedere struttura.

Ecco alcune situazioni concrete:

• Vuoi workflow di coding AI disciplinati: Hai già visto Claude produrre codice sicuro ma sbagliato e vuoi un framework che obblighi l’agente a fermarsi e pensare prima di agire.

• Il tuo team pratica il TDD: Il plugin impone il ciclo, quindi Claude inizierà sempre dai test e produrrà il minimo codice necessario a farli passare.

• Stai costruendo workflow complessi con Claude Code: Feature multi-step e refactor che toccano molti file traggono beneficio da pianificazione e review.

• Vuoi creare le tue skill: Se hai scritto lunghi file CLAUDE.md per codificare le convenzioni del team, le skill sono un modo più pulito per ottenere lo stesso risultato.

Probabilmente Superpowers è eccessivo se:

• Vuoi aiuto rapido stile autocomplete: Una correzione di una riga non ha bisogno di un processo di debugging in quattro fasi. Claude Code standard è più veloce.
• Stai scrivendo semplici script “usa e getta”: Per codice temporaneo non vale la pena dell’overhead di pianificazione, test e review.

La discriminante è di solito quanto il codice conterà dopo oggi. Se non lo rivedrai mai più, Superpowers è troppo. Se qualcun altro lo leggerà, lo eseguirà o lo manterrà, probabilmente è una buona scelta.

Vantaggi e limitazioni

Anche se singoli sviluppatori e team di ingegneria possono beneficiare di Superpowers, ci sono alcune limitazioni e casi in cui il sovraccarico extra potrebbe non valere la pena.

Vantaggi

La metodologia strutturata è il principale “punto di forza”. Claude segue processi definiti per compiti su cui di solito improvvisa, rendendo gli output più coerenti tra sessioni e tra membri del team.

Questo riduce il comportamento caotico che rende frustranti gli strumenti di coding AI. Niente più patch casuali, niente più funzionalità indesiderate, niente più test saltati, niente più “Claude ha costruito qualcosa di diverso da ciò che ho chiesto”.

Vale la pena menzionare anche TDD e debugging. I test vengono prima del codice. Il debugging parte dalla causa radice. Il framework Superpowers impone questi principi.

Il sistema di authoring delle skill rende il framework “tuo”. Puoi codificare le convenzioni del team e la conoscenza del progetto in skill che Claude seguirà ogni volta.

Limitazioni

C’è una curva di apprendimento. Devi capire cosa fanno le skill, quando invocarle e come si collegano le fasi del workflow. Le prime sessioni sembreranno più lente di Claude Code “liscio” perché stai imparando il framework mentre lavori.

Può anche sembrare pesante per compiti semplici. Non ti serve un processo in quattro fasi per un piccolo fix. Devi sviluppare il senso di quando usare il framework e quando farne a meno.

Inoltre, il framework dipende dal fatto che tu segua davvero il workflow. Se salti il brainstorming, perdi il documento di design da cui dipende la pianificazione. Se salti la pianificazione, l’esecuzione non ha un piano a cui attenersi. Le skill sono progettate per concatenarsi, e rompere la catena fa perdere valore.

Nessuna di queste è una controindicazione assoluta, ma è bene saperlo. Superpowers premia gli ingegneri che vogliono lavorare così su progetti più grandi. Progetti piccoli o demo non sono il suo campo ideale.

Conclusione

Superpowers è un plugin che dà a Claude una metodologia definita che un team di ingegneria esperto seguirebbe manualmente: design, implementazione, test, debugging e review.

Il valore principale è la disciplina. Con Superpowers, Claude smette di indovinare e inizia a seguire processi che funzionano davvero, il che significa meno ripetizioni da parte tua, meno sessioni sprecate, meno rework e codice di cui fidarti senza rileggere ogni riga.

Se vuoi che Claude si comporti meno come un chatbot e più come un vero partner di ingegneria, Superpowers merita una prova.

L’AI generativa funziona in un contesto business? Iscriviti al nostro corso Generative AI for Business per vedere il valore per piccole imprese e grandi aziende.