Superpowers Quickstart: installazione, workflow e prova

Superpowers incapsula un’intera metodologia guidata da specifiche in Claude Skills installabili, imponendo il brainstorming, la pianificazione, l’implementazione guidata da subagenti e il TDD rigoroso, invece di lasciare quella struttura a tua discrezione.

La maggior parte delle configurazioni SDD per Claude Code fallisce nel stesso modo: qualcuno scrive una solida skill specify-plan-implement una volta, la usa diligentemente per una settimana, per poi tornare silenziosamente al prompting non strutturato non appena si avvicina una scadenza. In una skill creata a mano, nulla impedisce davvero ciò che accade. Superpowers è una risposta diretta a questo problema di disciplina: è un pacchetto di skills creato da Jesse Vincent e dal team di Prime Radiant che tratta il brainstorming, la pianificazione, la revisione dei subagenti e il 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 è la procedura 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 ambienti (harness) invece di risiedere in una cartella .claude/skills/ di un singolo repository. Questa guida copre cosa sia effettivamente, come installarlo e verificarlo sull’agente che usi, come appaia una prima esecuzione end-to-end e come si inserisca accanto ad altri strumenti per lo sviluppo guidato da specifiche.

Cos’è Superpowers?

Superpowers si descrive come “una completa metodologia di sviluppo software per i tuoi agenti di codifica, costruita sulla base di un insieme di skills componibili e di alcune istruzioni iniziali che assicurano che il tuo agente le utilizzi”. Questa ultima clausola è la parte che conta. Esistono molte collezioni di skills; la differenza qui sta nell’istruzione di avvio (bootstrap) che forza l’agente a verificare la presenza di skills rilevanti prima di iniziare qualsiasi task, in modo che il flusso di lavoro si attivi automaticamente invece di richiedere a te di ricordare un comando slash.

La filosofia alla base è dichiarata apertamente nella documentazione del progetto:

• Sviluppo Guidato dai Test (TDD) – scrivere sempre prima i test
• Sistematico invece che ad-hoc – processo invece di indovinelli
• Riduzione della complessità – la semplicità come obiettivo primario
• Evidenze invece di affermazioni – verificare prima di dichiarare successo

Nella pratica, questa filosofia si manifesta come una sequenza di skills che si passano il testimone l’una all’altra. Se hai letto Claude Skills e SKILL.md per gli Sviluppatori, i meccanismi ti sembreranno familiari: Superpowers è un insieme vasto e opinioneato di esattamente quel tipo di directory SKILL.md, distribuito come plugin installabile piuttosto che come qualcosa da creare tu stesso.

Installare Superpowers su Diversi Agenti di Codifica

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

Claude Code

Superpowers è distribuito tramite due marketplace per Claude Code:

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

O tramite 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 vale la pena sottolinearli 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 aggiornarlo.
• Pi carica le skills tramite 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 skills.
• Hermes Agent non ha un hook post-compattazione: una sessione molto lunga che si compatta dopo il suo primo turno può perdere il bootstrap, quindi avvia una nuova sessione se le skills smettono di attivarsi.
• OpenCode tratta questo come un percorso di installazione completamente separato da qualsiasi altro ambiente (harness) che si usa già, anche sulla stessa macchina.

Verificare l’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 skills come brainstorming, writing-plans, test-driven-development e subagent-driven-development tra i risultati. Questo è lo stesso controllo di scoperta raccomandato per debug di Claude Skills che non si attivano: se la skill esiste ma non si attiva mai, la descrizione di routing è quasi sempre il problema, non il modello.

Il Flusso di Lavoro Superpowers: dal Brainstorming al Codice Consegnato

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

⬇

1. brainstorming si attiva prima che venga scritto qualsiasi codice. Affina un’idea vaga attraverso domande, esplora alternative e presenta il design in brevi blocchi esaminabili anziché in un lungo documento, salvando poi il risultato come artefatto di design.
2. using-git-worktrees si attiva una volta approvato il design. Crea un’area di lavoro isolata su un nuovo ramo, esegue la configurazione del progetto e verifica una baseline 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 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) invia un nuovo subagente per ogni task, con una revisione in due fasi: prima la conformità alla specifica, poi la qualità del codice.
5. test-driven-development impone il rigoroso red-green-refactor: scrivere un test fallente, osservarne il fallimento, scrivere il codice minimo per farlo passare, osservarne il successo, commit. Il codice scritto prima che esistesse un test fallente viene eliminato, non mantenuto.
6. requesting-code-review si attiva tra un task e l’altro, rivedendo il diff rispetto al piano e segnalando problemi per gravità; i problemi critici bloccano l’avanzamento 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, aprire una PR, mantenere il ramo o scartarlo, e pulisce il worktree.

Questo corrisponde strettamente al ciclo neutro rispetto ai tool in cinque fasi in Flusso di Lavoro SDD dalle Requisiti al Codice: specify diventa brainstorming, plan diventa writing-plans, tasks e implement si fondono in subagent-driven-development, e validate si divide tra TDD e code review. La differenza è l’imposizione: Superpowers è costruito in modo che l’agente verifichi automaticamente queste skills piuttosto che dipendere da te per invocare ogni fase.

Provarlo: Un’Guida al Primo Task

Non indirizzare Superpowers alla tua funzionalità più importante nella prima esecuzione. Scegli qualcosa di reale ma delimitato: un piccolo endpoint, una correzione di bug focalizzata, un refactor di un singolo modulo e avvia una sessione in un progetto che abbia già una suite di test, poiché l’imposizione del TDD è più visibile lì.

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

Con Superpowers installato, aspettati che la sessione inizi con domande di brainstorming anziché codice: quali endpoint, quale limite, per utente o per chiave, cosa dovrebbe accadere quando il limite viene raggiunto. Questa frizione è intenzionale: è la stessa disciplina sui non-obiettivi trattata in Flusso di Lavoro SDD dalle Requisiti al Codice, solo che è imposta dalla skill invece di essere lasciata a te da ricordare. Una volta approvato il design a blocchi, aspettati un piano con task piccoli e numerati prima di qualsiasi modifica ai file, quindi un subagente inviato per ogni task con un diff che rivedi a ogni checkpoint.

Due cose da monitorare in una prima esecuzione:

• Conferma che il TDD sia effettivamente imposto. Chiedi all’agente di implementare un task e verifica che un test fallente appaia prima dell’implementazione. Se il codice arriva per primo, la skill non si è attivata per quel passaggio ed è 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, è un argomento da sollevare durante il checkpoint di revisione di writing-plans piuttosto che a posteriori.

Cosa c’è Dentro: La Libreria di Skills

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

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

Quando Superpowers è Adatto (e Quando No)

Buona aderenza:

• Se ti piace già l’approccio delle skills di Claude Code per lo Sviluppo Guidato da Specifiche vs Vibe Coding, ma continui a tornare al prompting non strutturato perché nulla impone i gate di revisione.
• Se lavori con più agenti di codifica e vuoi una metodologia che viaggi con te invece di una skill solo per Claude Code.
• Se vuoi un’imposizione rigorosa del TDD senza scrivere tu stesso la logica di imposizione.
• Funzionalità multi-sessione dove la deriva architettonica e i vincoli dimenticati sono un rischio reale: esattamente il modo di fallimento descritto in Sviluppo Guidato da Specifiche vs Vibe Coding.

Aderenza 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 un cambiamento di cinquanta righe.
• Team con una skill SDD specifica del progetto già esistente e ben tarata. Superpowers scambia quella personalizzazione per una cerimonia imposta e opinionata; potresti preferire mantenere ciò che già funziona e prendere in prestito solo idee di skill individuali.
• Ambienti in cui la granularità obbligatoria di due-cinque minuti per task o il TDD obbligatorio confliggerebbero con un processo di team consolidato che non sei pronto a cambiare.

Come Superpowers Differs da Altri Tool SDD

Superpowers non è un concorrente di GitHub Spec Kit o AWS Kiro nel senso usuale: opera a livello di skills di Claude Code / inter-agenti piuttosto che come un CLI standalone o un IDE. Spec Kit ti dà artefatti markdown portabili e indipendenza dagli agenti; Kiro ti dà un’esperienza IDE guidata e integrata; una skill di Claude Code creata a mano ti dà massima flessibilità con zero imposizione. Superpowers si colloca tra gli ultimi due: stesso meccanismo basato su skills di un workflow Claude Code fai-da-te, ma con un’imposizione dal tono obbligatorio e una distribuzione dei plugin inter-agenti che una skill locale al repository non fornisce.

Per il dettaglio completo su portabilità, attrito di configurazione, gate di revisione e lock-in tra Spec Kit, Kiro, skills di Claude Code, OpenSpec, BMAD-METHOD e Tessl – incluso dove Superpowers si colloca 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 imposta e più libertà di iterare su un codebase brownfield, la guida rapida OpenSpec copre l’alternativa più leggera e centrata sui cambiamenti. E se i ruoli che ti mancano sono quelli che Superpowers non ricopre – revisione del prodotto, QA browser, audit di sicurezza, ingegneria del rilascio – gstack li incapsula come un team di ingegneria virtuale che può essere combinato con Superpowers, con Superpowers che fornisce la disciplina all’interno della fase di implementazione.

Troubleshooting e Cose da Sapere

Gli aggiornamenti sono per lo più automatici ma dipendono dall’agente. Quanto sia aggiornata la tua installazione dipende dall’ambiente (harness): Antigravity riesegue l’hook di avvio sessione alla reinstallazione, le installazioni basate su npm o Git hanno bisogno di un comando di aggiornamento esplicito e le installazioni basate su marketplace seguono tipicamente il flusso di aggiornamento dei plugin dell’agente host stesso.

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 di progetto, prompt o click. Imposta SUPERPOWERS_DISABLE_TELEMETRY a qualsiasi valore true per spegnerlo. Superpowers onora anche le opt-out DISABLE_TELEMETRY e CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC di Claude Code stesso.

I contributi richiedono il ramo dev. Se vuoi modificare o aggiungere skills, fai fork del repository, passa a dev e segui la skill writing-skills per creare e testare i cambiamenti: i contributi di nuove skills 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 con le Claude Skills. Chiedi “What skills are available?” per confermare la scoperta, verifica di averla installata per l’agente specifico che stai usando in quel momento (non un altro sulla stessa macchina) e ricorda che le sessioni Hermes hanno bisogno di una nuova avvio dopo la compattazione di sessioni lunghe se il bootstrap viene perso silenziosamente.

Conclusione

Superpowers vale la pena di installarlo 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 di specify-plan-implement – quel loop è già ben coperto da Cos’è lo Sviluppo Guidato da Specifiche? – rende un’idea esistente più difficile da saltare, e lo fa su più agenti rispetto a ciò che una skill locale al repository può raggiungere. Installalo prima sull’unico ambiente (harness) che usi quotidianamente, esegui un piccolo task delimitato attraverso il ciclo completo dal brainstorming alla conclusione, e decidi da lì se la cerimonia imposta vale il suo costo sul tuo carico di lavoro effettivo.

Link Utili

• Repository Superpowers – codice sorgente, skills 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 dei tool e framework decisionale
• Claude Skills e SKILL.md per gli Sviluppatori – i meccanismi di skill sottostanti su cui Superpowers si basa
• Subagenti di Claude Code: Configurazione, Setup e Quando Usarli – revisione con contesto isolato, il meccanismo dietro subagent-driven-development
• Flusso di Lavoro SDD dalle Requisiti al Codice – il processo neutro rispetto ai tool in cinque fasi che Superpowers automatizza
• Cos’è lo Sviluppo Guidato da Specifiche? La Specifica come Fonte di Verità – concetti e terminologia fondamentali dello SDD
• Installazione e configurazione di Claude Code per Ollama, llama.cpp, prezzi – installa Claude Code stesso prima di aggiungere Superpowers