Superpowers Quickstart: installazione, workflow e prova

Superpowers imballa un’intera metodologia guidata da specifiche in Skills di Claude installabili, imponendo brainstorming, pianificazione, implementazione guidata da subagenti e un rigoroso TDD, invece di lasciare che tu strutturi tutto da solo.

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

Ciò che lo rende degno di un’analisi dedicata piuttosto che di una nota a piè di pagina è 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 segua attraverso diversi harness, invece di vivere in una cartella .claude/skills/ di un singolo repository. Questa guida copre cosa sia effettivamente, come installarlo e verificarlo sull’agente che utilizzi, come appare una prima esecuzione end-to-end e dove si colloca rispetto ad altri strumenti di sviluppo guidato da specifiche.

Cos’è Superpowers?

Superpowers si descrive come “una completa metodologia 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 raccolte di skill; il fattore differenziante qui è l’istruzione di bootstrap che forza l’agente a verificare la presenza di skill pertinenti prima di iniziare qualsiasi task, in modo che il workflow si attivi automaticamente invece di richiedere che tu ricordi un comando slash.

La filosofia dietro è dichiarata chiaramente nella documentazione stessa del progetto:

• Sviluppo Guidato dai Test – scrivi prima i test, sempre
• Sistematico invece che ad-hoc – processo invece di congetture
• Riduzione della complessità – semplicità come obiettivo primario
• Evidenza invece di affermazioni – verifica prima di dichiarare successo

Nella pratica, quella filosofia si manifesta come una sequenza di skill che si passano il testimone l’una all’altra. Se hai letto Claude Skills and SKILL.md for Developers, i meccanismi ti sembreranno familiari: Superpowers è un grande e opinabile insieme di esattamente quel tipo di directory SKILL.md, distribuito come plugin installabile piuttosto che come qualcosa che crei tu stesso.

Installare Superpowers su Diversi Agenti di Coding

L’installazione è specifica per ogni harness, e il progetto è esplicito nel dire che va installato separatamente per ogni agente che utilizzi: non esiste un’installazione globale unica.

Claude Code

Superpowers è distribuito attraverso due marketplace per Claude Code:

# Official Anthropic plugin marketplace
/plugin install superpowers@claude-plugins-official

Oppure attraverso il marketplace dedicato Superpowers, che include 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 un’attenzione particolare prima di eseguire un task reale:

• Antigravity esegue automaticamente l’hook di avvio sessione del plugin, quindi Superpowers è attivo dal primo messaggio; reinstalla con lo stesso comando per aggiornare.
• Pi carica le skill attraverso una piccola estensione che inietta il bootstrap using-superpowers all’avvio della sessione e dopo la compattazione del contesto, e non richiede lo strumento di compatibilità Skill di Pi poiché Pi ha supporto nativo per le skill.
• Hermes Agent non ha un hook post-compattazione: una sessione molto lunga che si compatta oltre il suo 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 da qualsiasi altro harness 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 è 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 debugging Claude Skills that fail to trigger – se la skill esiste ma non si attiva mai, la descrizione di routing è quasi sempre il problema, non il modello.

Il Workflow di Superpowers: Dal Brainstorming al Codice Consegnato

Superpowers documenta sette skill come “il workflow di base”, ciascuna che si attiva in un punto specifico e passa il testimone alla successiva:

⬇

1. brainstorming si attiva prima che venga scritto qualsiasi codice. Raffina un’idea vaga attraverso domande, esplora alternative e presenta il design in brevi sezioni rivedibili invece che in un lungo documento – poi salva il risultato come artefatto di design.
2. using-git-worktrees si attiva una volta approvato il design. Crea uno spazio di lavoro isolato su un nuovo ramo, esegue la configurazione del progetto e verifica una baseline di test pulita prima che inizi l’implementazione.
3. writing-plans scompone il design approvato in task di piccole dimensioni – Superpowers mira a due-cinque minuti di lavoro per task – con percorsi di file esatti, codice completo dove rilevante e passi 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: conformità alla specifica prima, poi qualità del codice.
5. test-driven-development impone un rigoroso red-green-refactor: scrivi un test fallente, osservalo fallire, scrivi il codice minimo per farlo passare, osservalo passare, committa. Il codice scritto prima che esistesse un test fallente per esso viene eliminato, non conservato.
6. requesting-code-review si attiva tra i task, rivedendo la diff rispetto al piano e riportando i problemi per gravità; i problemi critici bloccano il progresso verso il 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 neutro agli strumenti a cinque fasi in Spec-Driven Development Workflow From Requirements to Code: specify diventa brainstorming, plan diventa writing-plans, tasks e implement si fondono in subagent-driven-development, e validate è diviso tra TDD e code review. La differenza è l’applicazione forzata: Superpowers è costruito in modo che l’agente verifichi automaticamente queste skill invece di fare affidamento sul fatto che tu invochi ogni fase.

Provarlo: Un Tour del Primo 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 abbia 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 invece che con codice: quali endpoint, quale limite, per utente o per chiave, cosa dovrebbe accadere quando viene raggiunto il limite. Quella frizione è intenzionale: è la stessa disciplina sui non-obiettivi coperta in Spec-Driven Development Workflow From Requirements to Code, solo applicata dalla skill invece che lasciata alla tua memoria. Una volta che approvi il design in sezioni, aspettati un piano con task numerati e piccoli prima di qualsiasi modifica ai file, poi un subagente dispatchato per ogni task con una diff che riesamini a ogni checkpoint.

Due cose da monitorare alla prima esecuzione:

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

Cosa c’è Dentro: La Libreria di Skill

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

dispatching-parallel-agents merita una menzione a parte: copre i workflow di subagenti concorrenti, che è la stessa area di Claude Code subagents – contesto isolato, revisione indipendente e un riepilogo riportato alla sessione principale invece di inondarla di output intermedio.

Quando Superpowers Calza (e Quando No)

Buona calce:

• Ti piace già l’approccio delle skill di Claude Code per Spec-Driven Development vs Vibe Coding ma continui a scivolare verso il prompting non strutturato perché nulla applica le porte di revisione.
• Lavori su più agenti di coding e vuoi una metodologia che viaggi con te invece di una skill solo per Claude Code.
• Vuoi un’applicazione rigorosa del TDD senza scrivere tu stesso la logica di applicazione.
• Funzionalità multi-sessione dove la deriva architetturale e i vincoli dimenticati sono un rischio reale – esattamente il modalità di fallimento descritta in Spec-Driven Development vs Vibe Coding.

Calce più debole:

• Script rapidi, prototipi usa-e-getta e automazioni una tantum: l’overhead 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 calibrata. Superpowers scambia quella personalizzazione per una cerimonia forzata e opinabile; potresti preferire mantenere ciò che già funziona e prendere in prestito solo idee di skill individuali.
• Ambienti in cui la rigorosa granularità di task da due-cinque minuti o il TDD obbligatorio confliggerebbero con un processo di team consolidato 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 usuale: opera a livello di skill per Claude Code / agenti trasversali piuttosto che come un CLI autonomo o un IDE. Spec Kit ti dà artefatti markdown portatili e indipendenza dagli agenti; Kiro ti dà un’esperienza IDE guidata e integrata; una skill di Claude Code fatta a mano ti dà flessibilità massima con zero applicazione. Superpowers si colloca tra gli ultimi due: stesso meccanismo basato su skill di un workflow DIY di Claude Code, ma con un’applicazione che sembra obbligatoria e una distribuzione di plugin trasversale agli agenti che una skill locale al repository non fornisce.

Per l’analisi completa della portabilità, dell’attrito di configurazione, delle porte di revisione e del lock-in tra Spec Kit, Kiro, skill di Claude Code, OpenSpec, BMAD-METHOD e Tessl – incluso dove si colloca Superpowers nella tabella di confronto e nel framework decisionale – vedi GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows.

Risoluzione dei Problemi e Cose da Sapere

Gli aggiornamenti sono in gran parte automatici ma dipendono dall’agente. Quanto rimane aggiornato il tuo install dipende dall’harness: Antigravity riesegue l’hook di avvio sessione alla reinstallazione, gli install basati su npm o Git richiedono un comando di aggiornamento esplicito, e gli install basati su marketplace seguono tipicamente il flusso di aggiornamento dei plugin del proprio agente host.

La telemetria è attiva di default ma facile da disattivare. Il compagno visuale opzionale della skill di brainstorming carica il logo di Prime Radiant dal loro sito web, che include la tua versione di Superpowers ma nessun dato su progetto, prompt o click. Imposta SUPERPOWERS_DISABLE_TELEMETRY a qualsiasi valore true per spegnerla. Superpowers onora anche le opt-out di Claude Code DISABLE_TELEMETRY e CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

I contributi richiedono il ramo dev. Se vuoi modificare o aggiungere skill, fork il repository, passa a dev e segui la skill writing-skills per creare e testare le modifiche: i contributi di nuove skill in particolare vengono generalmente 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, verifica di aver installato per l’agente specifico che stai usando in questo momento (non uno diverso sulla stessa macchina) e ricorda che le sessioni Hermes hanno bisogno di un nuovo avvio dopo la compattazione di sessioni lunghe se il bootstrap viene perso 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 What Is Spec-Driven Development? – rende un’idea esistente più difficile da saltare, e lo fa attraverso più agenti di quanti una skill locale al repository possa raggiungere. Installalo prima sull’harness che usi quotidianamente, esegui un piccolo task limitato attraverso il ciclo completo dal brainstorming alla fine, e decidi da lì se la cerimonia forzata vale il suo costo sul tuo carico di lavoro reale.

Link Utili

• Superpowers repository – sorgente, skill e manifesti dei plugin per ogni agente supportato
• Superpowers marketplace – marketplace di Claude Code per Superpowers e plugin correlati
• GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows – confronto completo degli strumenti e framework decisionale
• Claude Skills and SKILL.md for Developers – i meccanismi di skill su cui Superpowers si basa
• Claude Code Subagents: Setup, Config, and When to Use Them – revisione con contesto isolato, il meccanismo dietro subagent-driven-development
• Spec-Driven Development Workflow From Requirements to Code – il processo a cinque fasi neutro agli strumenti che Superpowers automatizza
• What Is Spec-Driven Development? The Spec as Source of Truth – concetti e terminologia SDD di base
• Claude Code install and config for Ollama, llama.cpp, pricing – installa Claude Code stesso prima di aggiungere Superpowers