Superpowers Quickstart: installazione, flusso di lavoro e prova

Superpowers racchiude una metodologia completa basata sulle specifiche (spec-driven) in Claude Skills installabili, imponendo brainstorming, pianificazione, implementazione guidata da subagenti e un rigoroso TDD, anziché lasciare che tale struttura dipenda da te.

La maggior parte delle configurazioni SDD per Claude Code fallisce nello stesso modo: qualcuno scrive una solida skill specify-plan-implement una volta, la utilizza diligentemente per una settimana, poi torna silenziosamente al prompting non strutturato non appena un termine di consegna si avvicina. In una skill fatta a mano, nulla impedisce concretamente questo fenomeno. Superpowers è una risposta diretta a questo problema di disciplina: è un pacchetto di skill creato da Jesse Vincent e dal team di Prime Radiant che tratta brainstorming, pianificazione, revisione tramite subagenti e TDD red-green-refactor come passaggi obbligatori che l’agente verifica prima di ogni task, non come suggerimenti facoltativi che può saltare sotto pressione.

Ciò che ne giustifica un’analisi dedicata, anziché trattarla come una nota a margine, è il processo di installazione. Superpowers include manifesti dei plugin per Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Devin CLI, Factory Droid e Hermes Agent, in modo che la stessa metodologia ti accompagni attraverso diversi ambienti (harness) anziché essere confinata nella cartella .claude/skills/ di un singolo repository. Questa guida copre cosa sia effettivamente Superpowers, come installarlo e verificarlo sull’agente che utilizzi, a cosa assomigli una prima esecuzione end-to-end e in quale posizione si collochi rispetto ad altri strumenti per lo sviluppo basato sulle specifiche.

Cos’è Superpowers?

Superpowers si descrive come “una metodologia completa di sviluppo software per i tuoi agenti di coding, costruita sopra un insieme di skill componibili e alcune istruzioni iniziali che assicurano che il tuo agente le utilizzi”. Quest’ultima clausola è la parte che conta. Esistono molte collezioni di skill; il differenziale qui è l’istruzione di avvio che impone all’agente di verificare la presenza di skill rilevanti prima di iniziare qualsiasi task, in modo che il flusso di lavoro si attivi automaticamente anziché richiedere a te di ricordare un comando slash.

La filosofia dietro questo progetto è dichiarata apertamente nei documenti del progetto stesso:

• Sviluppo Guidato dai Test (TDD) – scrivi prima i test, sempre
• Sistematico oltre che ad-hoc – processo anziché indovinamenti
• Riduzione della complessità – semplicità come obiettivo primario
• Evidenze invece di affermazioni – verifica prima di dichiarare il successo

Nella pratica, questa filosofia si manifesta come una sequenza di skill che si passano il testimune l’una all’altra. Se hai letto Claude Skills and SKILL.md per Sviluppatori, i meccanismi ti sembreranno familiari: Superpowers è un grande e opinionato insieme di esattamente quel tipo di directory SKILL.md, distribuito come plugin installabile anziché essere qualcosa che crei da solo.

Installare Superpowers su Diversi Agenti di Coding

L’installazione è specifica per ogni ambiente (harness), e il progetto specifica chiaramente che deve essere installato separatamente per ogni agente che utilizzi: non esiste un’installazione globale unica.

Claude Code

Superpowers viene distribuito tramite due marketplace per Claude Code:

# Marketplace ufficiale dei plugin Anthropic
/plugin install superpowers@claude-plugins-official

Oppure tramite il marketplace dedicato Superpowers, che ospita anche alcuni plugin correlati:

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

Cursor

/add-plugin superpowers

Puoi anche cercare “superpowers” direttamente nell’interfaccia del marketplace dei plugin di Cursor.

Altri agenti

Alcuni dettagli di installazione meritano di essere evidenziati prima di eseguire un task reale:

• Antigravity esegue automaticamente l’hook di avvio della sessione del plugin, quindi Superpowers è attivo fin dal primo messaggio; reinstalla con lo stesso comando per aggiornare.
• Pi carica le skill tramite una piccola estensione che inietta il bootstrap using-superpowers all’avvio della sessione e dopo la compattazione del contesto, e non richiede il tool di compatibilità Skill di Pi poiché Pi ha un supporto nativo per le skill.
• Hermes Agent non ha un hook post-compattazione: una sessione molto lunga che si compatta dopo il primo turno può perdere il bootstrap, quindi avvia una nuova sessione se le skill smettono di attivarsi.
• OpenCode tratta questo come un percorso di installazione completamente separato rispetto a qualsiasi altro ambiente che già utilizzi, anche sulla stessa macchina.

Verifica dell’installazione

Una volta installato, chiedi direttamente all’agente invece di fidarti di un messaggio di successo silenzioso:

What skills are available?

Se Superpowers è stato installato correttamente, l’agente dovrebbe elencare skill come brainstorming, writing-plans, test-driven-development e subagent-driven-development tra i risultati. Questo è lo stesso controllo di scoperta raccomandato per debug delle Claude Skills che non si attivano: se la skill esiste ma non si attiva mai, quasi sempre il problema è la descrizione del routing, non il modello.

Il Flusso di Lavoro Superpowers: dal Brainstorming al Codice Consegato

Superpowers documenta sette skill come “il flusso di lavoro di base”, ognuna si attiva in un punto specifico e si passa al successivo:

⬇

1. brainstorming si attiva prima che venga scritto qualsiasi codice. Raffina un’idea grezza attraverso domande, esplora alternative e presenta il design in piccoli blocchi rivedibili anziché in un lungo documento – quindi salva il risultato come artefatto di design.
2. using-git-worktrees si attiva una volta che hai approvato il design. Crea un workspace isolato su un nuovo ramo, esegue la configurazione del progetto e verifica una base di test pulita prima che inizi l’implementazione.
3. writing-plans spezza il design approvato in task di piccole dimensioni – Superpowers punta a due-cinque minuti di lavoro per task – con percorsi di file esatti, codice completo dove rilevante e passaggi di verifica espliciti.
4. subagent-driven-development (iterazione rapida) o executing-plans (esecuzione in batch con checkpoint umani) dispatcha un nuovo subagente per ogni task, con una revisione in due fasi: prima la conformità alle specifiche, poi la qualità del codice.
5. test-driven-development impone un rigoroso red-green-refactor: scrivi un test che fallisce, guardalo fallire, scrivi il codice minimale per farlo passare, guardalo passare, commit. Il codice scritto prima che esistesse un test fallente per esso viene eliminato, non conservato.
6. requesting-code-review si attiva tra i task, revisionando il diff contro il piano e riportando i problemi per gravità; i problemi critici bloccano il passaggio al task successivo.
7. finishing-a-development-branch si attiva una volta completati tutti i task. Verifica che i test passino, poi presenta opzioni – merge, apri una PR, mantieni il ramo, o scarta – e pulisce il worktree.

Questo si mappa strettamente sul ciclo in cinque fasi neutrale rispetto agli strumenti in Flusso di Lavoro dello Sviluppo Basato sulle Specifiche: dalle Requisiti al Codice: specify diventa brainstorming, plan diventa writing-plans, tasks e implement fold in subagent-driven-development, e validate si suddivide tra TDD e code review. La differenza sta nell’applicazione: Superpowers è costruito in modo che l’agente verifichi automaticamente queste skill anziché contare sul fatto che tu invochi ogni fase.

Provarlo: Una Passata Prima di un Task

Non puntare Superpowers sulla tua funzionalità più importante alla prima esecuzione. Scegli qualcosa di reale ma limitato – un piccolo endpoint, una correzione di bug focalizzata, un refactoring di un singolo modulo – e avvia una sessione in un progetto che ha già una suite di test, poiché l’applicazione del TDD è più visibile lì.

I want to add rate limiting to our public API endpoints.

Con Superpowers installato, aspettati che la sessione si apra con domande di brainstorming anziché con codice: quali endpoint, quale limite, per utente o per chiave, cosa dovrebbe succedere quando il limite viene raggiunto. Questo attrito è intenzionale: è la stessa disciplina sui “non-obiettivi” coperta in Flusso di Lavoro dello Sviluppo Basato sulle Specifiche: dalle Requisiti al Codice, solo applicata dalla skill anziché lasciata alla tua memoria. Una volta che hai approvato il design in blocchi, aspettati un piano con task numerati e piccoli prima di qualsiasi modifica ai file, poi un subagente dispatchato per ogni task con un diff che rivedi a ogni checkpoint.

Due cose a cui fare attenzione alla prima esecuzione:

• Conferma che il TDD sia effettivamente applicato. Chiedi all’agente di implementare un task e controlla se un test fallente appare prima dell’implementazione. Se il codice arriva per primo, la skill non si è attivata per quel passaggio e vale la pena rieseguire il controllo di scoperta dalla sezione di installazione.
• Osserva la granularità dei task. La dimensione del task di due-cinque minuti è aggressiva per alcuni codebase. Se i task sembrano frammentati inutilmente per il tuo progetto, vale la pena farlo notare durante il checkpoint di revisione della writing-plans anziché dopo.

Cosa c’è Dentro: La Libreria di Skill

Oltre alle sette skill del flusso di lavoro, Superpowers include skill di supporto raggruppate per area:

dispatching-parallel-agents merita una menzione separata: copre i flussi di lavoro di subagenti concorrenti, che è lo stesso ambito di Subagenti di Claude Code – contesto isolato, revisione indipendente e un riepilogo riportato alla sessione principale anziché inondarla con output intermedi.

Quando Superpowers Si Adatta (e Quando No)

Buon adattamento:

• Ti piace già l’approccio delle skill di Claude Code allo Sviluppo Basato sulle Specifiche vs Vibe Coding ma continui a scivolare verso il prompting non strutturato perché nulla applica i gate di revisione.
• Lavori su più agenti di coding e vuoi una metodologia unica che ti accompagni, anziché una skill solo per Claude Code.
• Vuoi un’applicazione rigorosa del TDD senza scrivere tu stesso la logica di applicazione.
• Funzionalità in più sessioni dove il drift architetturale e i vincoli dimenticati sono un rischio reale – l’esatto modalità di fallimento descritta in Sviluppo Basato sulle Specifiche vs Vibe Coding.

Adattamento più debole:

• Script rapidi, prototipi usa-e-getta e automazioni una tantum – il sovraccarico di brainstorming e pianificazione è reale e non vale la pena pagarlo per una modifica di cinquanta righe.
• Team con una skill SDD specifica del progetto già esistente e ben regolata. Superpowers scambia quella personalizzazione con una cerimonia applicata e opinionata; potresti preferire mantenere ciò che funziona già e prendere in prestito solo idee di skill individuali.
• Ambienti in cui la rigorosa granularità dei task di due-cinque minuti o il TDD obbligatorio confliggerebbero con un processo di team stabilito che non sei pronto a cambiare.

Come Superpowers Differisce da Altri Strumenti SDD

Superpowers non è un concorrente di GitHub Spec Kit o AWS Kiro nel senso abituale – opera a livello di skill di Claude Code / inter-agenti anziché come CLI o IDE standalone. Spec Kit ti offre artefatti markdown portatili e indipendenza dall’agente; Kiro ti offre un’esperienza IDE guidata e integrata; una skill di Claude Code fatta a mano ti offre massima flessibilità con zero applicazione. Superpowers si colloca tra gli ultimi due: stesso meccanismo basato sulle skill di un workflow Claude Code fai-da-te, ma con un’applicazione che sembra obbligatoria e una distribuzione di plugin inter-agenti che una skill locale al repository non fornisce.

Per la completa suddivisione della portabilità, attrito di setup, gate di revisione e lock-in tra Spec Kit, Kiro, skill di Claude Code, OpenSpec, BMAD-METHOD e Tessl – incluso in quale posizione si collochi Superpowers nella tabella di confronto e nel framework decisionale – vedi GitHub Spec Kit vs Kiro vs Flussi di Lavoro SDD di Claude Code. Se vuoi meno cerimonia applicata e più libertà di iterare su un codebase esistente, il Quickstart di OpenSpec copre l’alternativa più leggera e centrata sulle modifiche.

Risoluzione dei Problemi e Cose da Sapere

Gli aggiornamenti sono in gran parte automatici ma dipendono dall’agente. Quanto l’installazione resti aggiornata dipende dall’ambiente – Antigravity riesegue l’hook di avvio della sessione alla reinstallazione, le installazioni basate su npm o Git richiedono un comando di aggiornamento esplicito, e le installazioni basate su marketplace tipicamente seguono il flusso di aggiornamento plugin dell’agente host.

La telemetria è attiva di default ma facile da disattivare. Il compagno visivo opzionale della skill di brainstorming carica il logo di Prime Radiant dal loro sito web, che include la tua versione di Superpowers ma non dati di progetto, prompt o clic. Imposta SUPERPOWERS_DISABLE_TELEMETRY su un valore vero qualsiasi per spegnerla. Superpowers onora anche gli opt-out DISABLE_TELEMETRY e CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC di Claude Code.

I contributi richiedono il ramo dev. Se vuoi modificare o aggiungere skill, fork the repository, passa a dev e segui la skill writing-skills per creare e testare modifiche – i contributi di nuove skill in particolare sono generalmente non accettati, poiché ogni skill deve funzionare identicamente su tutti gli agenti supportati.

Se una skill non si attiva, trattala come qualsiasi altro problema di Claude Skill. Chiedi “What skills are available?” per confermare la scoperta, controlla che l’abbia installato per l’agente specifico che stai usando in questo momento (non per un altro sulla stessa macchina) e ricorda che le sessioni Hermes hanno bisogno di un riavvio fresco dopo la compattazione di una sessione lunga se il bootstrap si perde silenziosamente.

Conclusione

Superpowers vale l’installazione quando il divario tra le tue intenzioni SDD e ciò che accade effettivamente in una sessione è il problema che stai cercando di risolvere. Non introduce una nuova idea specify-plan-implement – quel ciclo è già ben coperto da Cos’è lo Sviluppo Basato sulle Specifiche? – rende più difficile saltare un’idea esistente, e lo fa attraverso più agenti di quanto una skill locale al repository possa raggiungere. Installalo prima sull’unico ambiente che usi quotidianamente, esegui un task piccolo e limitato attraverso il ciclo completo dal brainstorming alla fine, e decidi da lì se la cerimonia applicata vale il costo sul tuo carico di lavoro reale.

Link Utili

• Repository Superpowers – fonte, skill e manifesti dei plugin per ogni agente supportato
• Marketplace Superpowers – marketplace di Claude Code per Superpowers e plugin correlati
• GitHub Spec Kit vs Kiro vs Flussi di Lavoro SDD di Claude Code – confronto completo degli strumenti e framework decisionale
• Claude Skills and SKILL.md per Sviluppatori – i meccanismi di skill sottostanti su cui Superpowers si basa
• Subagenti di Claude Code: Setup, Configurazione e Quando Usarli – revisione a contesto isolato, il meccanismo dietro subagent-driven-development
• Flusso di Lavoro dello Sviluppo Basato sulle Specifiche: dalle Requisiti al Codice – il processo in cinque fasi neutrale rispetto agli strumenti che Superpowers automatizza
• Cos’è lo Sviluppo Basato sulle Specifiche? La Specifica come Fonte di Verità – concetti e terminologia core dello SDD
• Installazione e configurazione di Claude Code per Ollama, llama.cpp, prezzi – installa Claude Code stesso prima di aggiungere Superpowers