Superpowers: specifica, piano e subagenti per Claude Code

Superpowers è un plugin open source che insegna a Claude Code un metodo di lavoro completo: prima chiarisce cosa vuoi ottenere e scrive una specifica, poi prepara un piano a piccoli passi, lo esegue con subagenti e revisioni, scrive i test prima del codice e verifica il risultato prima di dichiararlo finito. Le sue skills si attivano da sole quando servono, quindi non devi ricordarti comandi particolari.

Per chi non usa Claude Code: è un assistente di programmazione che lavora nel terminale, legge il codice e lo modifica. Lasciato a sé stesso, tende a partire subito a scrivere. Superpowers gli impone la disciplina di un buon gruppo di sviluppo: capire, progettare, scomporre, testare, rivedere. In questa scheda vediamo come funziona il flusso, come si installa, cosa aggiunge alla sessione e quando conviene davvero.

Che cos'è Superpowers?

Superpowers è una raccolta di skills, cioè istruzioni e risorse che Claude carica quando sono pertinenti, accompagnata da un piccolo testo iniziale che spinge l'agente a usarle. Il progetto è di Jesse Vincent e del gruppo Prime Radiant, è pubblicato con licenza MIT e funziona anche con altri assistenti di programmazione, ma qui ci concentriamo su Claude Code.

Il principio dichiarato nel README è che le skills non sono suggerimenti: l'agente controlla se esiste una skill pertinente prima di ogni compito e, se c'è, la segue. Le idee di fondo sono quattro: test prima del codice, processo invece di tentativi, riduzione della complessità e prove invece di affermazioni.

Come funziona il flusso di lavoro?

Il flusso base descritto nel repository di Superpowers passa per sette skill, ciascuna attivata dalla fase in cui ti trovi.

1. brainstorming: prima di costruire qualsiasi cosa, Claude ti fa domande per capire cosa vuoi davvero e perché, poi ti restituisce la sua comprensione perché tu la corregga. Le modifiche piccole si concordano in chat; i progetti veri diventano un documento di design scritto, mostrato a pezzi abbastanza brevi da poterli leggere.
2. using-git-worktrees: dopo l'approvazione del design crea uno spazio di lavoro isolato su un nuovo ramo, prepara il progetto e controlla che i test partano da una base pulita.
3. writing-plans: scompone il lavoro in compiti da pochi minuti ciascuno, con percorsi dei file, codice e passi di verifica.
4. subagent-driven-development oppure executing-plans: nel primo caso ogni compito va a un subagente nuovo con una revisione dopo ciascuno, nel secondo i compiti si eseguono nella sessione corrente con un'unica revisione finale. Il primo è più accurato, il secondo più economico.
5. test-driven-development: impone il ciclo rosso, verde, refactoring. Si scrive un test che fallisce, lo si vede fallire, si scrive il codice minimo per farlo passare. Il codice scritto prima dei test viene eliminato.
6. requesting-code-review: tra un compito e l'altro confronta il lavoro con il piano e segnala i problemi per gravità; quelli critici bloccano l'avanzamento.
7. finishing-a-development-branch: a lavoro concluso verifica i test e ti propone le opzioni, cioè unire il ramo, aprire una pull request, tenerlo o scartarlo, poi pulisce lo spazio di lavoro.

Il README osserva che il piano deve essere chiaro al punto che anche uno sviluppatore junior senza contesto potrebbe seguirlo. È questa precisione a permettere all'agente di lavorare a lungo senza deviare: il piano diventa il contratto, e la revisione dopo ogni compito controlla che venga rispettato.

Quali altre skill contiene?

Oltre al flusso principale ci sono skill che si attivano in situazioni specifiche:

• systematic-debugging: un processo in quattro fasi per trovare la causa vera di un errore, invece di provare correzioni a caso;
• verification-before-completion: obbliga a verificare che un problema sia davvero risolto prima di dirlo;
• dispatching-parallel-agents: lavoro concorrente con più subagenti;
• receiving-code-review: come rispondere ai commenti di una revisione;
• writing-skills: come creare e testare nuove skills seguendo lo stesso metodo;
• diagnosing-superpowers: se una sessione va storta, chiedendo all'agente di capire cosa è successo con Superpowers legge la trascrizione e riporta le prove riga per riga.

Per un titolare o un responsabile IT, la skill da ricordare è la verifica prima della chiusura. Molti problemi con gli assistenti di programmazione nascono da un "fatto" detto troppo presto: una regola che chiede prove, test eseguiti e risultati controllati riduce proprio quel rischio.

Come si installa in Claude Code?

Ci sono due strade, entrambe documentate nel README. La più semplice è il marketplace ufficiale di Anthropic, dove Superpowers ha anche una pagina dedicata:

/plugin install superpowers@claude-plugins-official

La seconda è il marketplace dell'autore, che raccoglie Superpowers insieme ad altri plugin collegati:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Non installare lo stesso plugin da entrambe le fonti: scegline una. Se non hai mai aggiunto un marketplace, i passaggi generali sono nella guida ai plugin di Claude Code.

Il marketplace di Superpowers contiene anche plugin utili da soli. Due esempi: elements-of-style, una skill di scrittura chiara basata sul classico manuale di Strunk, utile per documentazione e messaggi, ed episodic-memory, che permette di cercare per significato nelle conversazioni passate. Quest'ultimo lo confrontiamo con altre soluzioni nell'articolo sulla memoria tra le sessioni. Ci sono anche plugin dichiaratamente sperimentali o di sviluppo: il marketplace stesso avverte, per esempio, che la versione di sviluppo di Superpowers richiede di disinstallare prima le altre.

Cosa aggiunge alla tua sessione, e cosa invia all'esterno?

Superpowers registra un hook all'evento SessionStart, cioè all'avvio della sessione, dopo un /clear e dopo la compattazione del contesto. In quel momento esegue uno script del plugin che inietta nel contesto il testo introduttivo della skill using-superpowers. È il meccanismo che fa partire il metodo da solo, ed è anche il motivo per cui conviene saperlo: ogni sessione inizia con istruzioni in più che non hai scritto tu, e lo script gira con i tuoi permessi. Come per ogni plugin, leggi cosa fa prima di installarlo; i criteri sono nell'articolo sulla sicurezza dei plugin.

C'è poi una nota di trasparenza nel README. La fase di brainstorming ha un "visual companion" opzionale che mostra il logo di Prime Radiant caricandolo dal loro sito; la richiesta include la versione di Superpowers in uso. Secondo gli autori non trasmette dettagli su progetto, prompt o assistente, e serve solo a stimare quante persone lo usano.

Se in azienda non vuoi alcuna chiamata esterna di questo tipo, imposta la variabile d'ambiente SUPERPOWERS_DISABLE_TELEMETRY a un valore vero. Il README precisa che Superpowers rispetta anche le impostazioni generali di Claude Code DISABLE_TELEMETRY e CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: se le usi già nella configurazione aziendale, valgono anche per questo plugin.

Quali sono i limiti da considerare?

• Il metodo ha un costo: domande iniziali, piano scritto, subagenti e revisioni richiedono tempo e consumo. Per una correzione di una riga è troppo; il README stesso prevede che le modifiche piccole si concordino in chat.
• Il TDD è rigido per scelta: il codice scritto prima dei test viene eliminato. Su un progetto senza test, o su script usa e getta, può risultare pesante.
• Le skill sono imposte: se convivono con altri framework di metodo o con istruzioni di progetto contrastanti nel CLAUDE.md, l'agente riceve indicazioni in conflitto. Meglio un solo metodo per progetto.
• Gli aggiornamenti cambiano il comportamento: le skill evolvono. Se il team lavora in modo uniforme, decidete quando aggiornare invece di lasciarlo al caso.

Per chi ha senso Superpowers?

Ha senso per chi usa Claude Code su lavori di qualche ora, come una nuova funzione in un gestionale o un modulo di un sito, e vuole che l'agente proceda con lo stesso ordine che si chiederebbe a uno sviluppatore: requisiti chiari, piano, test, revisione. È utile anche per chi è alle prime armi con lo sviluppo assistito, perché rende visibile il processo invece di nasconderlo dietro un risultato.

Conviene meno per interventi rapidi, prototipi da buttare o team che hanno già un metodo consolidato e documentato. Se ti interessa soprattutto la parte di specifica, confronta anche Spec Kit e gli altri framework della rubrica, come BMad Method, GSD Core e SuperClaude.

Cosa fare adesso: installa Superpowers su un progetto di prova con un compito di media dimensione, segui il brainstorming fino al piano e osserva quanto tempo e consumo richiede rispetto al tuo modo abituale. Se il risultato ti convince, decidi con il team quando usarlo e scrivilo nelle regole del progetto. Gli altri plugin da affiancare sono raccolti nella stessa guida.