Claude Code è potente di base, ma senza struttura salta direttamente alla codifica: niente pianificazione, niente test, nessun approccio sistematico. Il plugin Superpowers risolve questo problema applicando workflow di sviluppo collaudati che prevengono il caos.

Cosa fa realmente Superpowers

Superpowers è un framework di competenze che intercetta Claude Code nei momenti chiave. Invece di scrivere immediatamente codice quando chiedi qualcosa, si ferma e fa prima delle domande. Poi applica il TDD, crea piani di implementazione e rivede il proprio lavoro prima di procedere.

Il workflow principale:

1. Brainstorm: affina la tua idea attraverso domande socratiche
2. Plan: crea task di piccole dimensioni (2-5 minuti ciascuno) con percorsi file esatti
3. Execute: invia subagent per task con revisione a due fasi
4. Finish: verifica i test, offre opzioni PR/merge, pulisce

Installazione (10 Secondi)

bash

Apri il menu plugin

/plugin

Vai alla scheda "Discover"

Cerca "superpowers"

Seleziona e installa

Dopo l'installazione, riavvia Claude Code. Vedrai "SessionStart:startup hook succeeded: Success" che conferma l'attivazione del plugin.

Cosa viene installato

Il plugin include tutto ciò di cui hai bisogno:

I tre comandi principali

/superpowers:brainstorm

Usalo prima di QUALSIASI nuova funzionalità. Claude:

• farà domande chiarificatrici sul tuo obiettivo
• esplorerà alternative che non hai considerato
• presenterà il design in blocchi digeribili per la validazione
• salverà un documento di design come riferimento

Quando attivarlo: Inizio di qualsiasi funzionalità, refactoring o migrazione.

/superpowers:write-plan

Dopo il brainstorming, questo crea un piano di implementazione dove:

• ogni task richiede massimo 2-5 minuti
• ogni task ha percorsi file esatti e snippet di codice completi
• i passaggi di verifica sono integrati in ogni task
• il piano presuppone che lo eseguirà un "ingegnere junior entusiasta senza contesto"

/superpowers:execute-plan

Esegue il piano usando lo sviluppo guidato da subagent:

• nuovo subagent generato per task (contesto pulito)
• revisione a due fasi: conformità alle specifiche, poi qualità del codice
• checkpoint umani tra i batch
• i problemi critici bloccano automaticamente il progresso

Le 14 competenze spiegate

Come si attivano automaticamente le competenze

Le competenze non sono comandi che chiami, si attivano in base al contesto:

• inizi a discutere una nuova funzionalità → si attiva brainstorming
• design approvato → si attiva using-git-worktrees
• inizia l'implementazione → si attiva test-driven-development
• task completato → si attiva requesting-code-review
• tutti i task completati → si attiva finishing-a-development-branch

Claude verifica le competenze rilevanti prima di qualsiasi task. Questi sono workflow obbligatori, non suggerimenti.

Integrazione con git worktree

Superpowers usa i git worktrees per lo sviluppo isolato: bash

Cosa succede dietro le quinte:

git worktree add ../project-feature feature-branch cd ../project-feature

Claude lavora qui, il branch main rimane pulito

Vantaggi:

• esegui più istanze di Claude su funzionalità diverse
• mantieni stabile il branch main durante la sperimentazione
• pulizia facile se qualcosa va storto

Sviluppo guidato da subagent

Il pattern più potente. Invece di una lunga sessione di Claude:

1. L'agent principale crea il piano
2. Un nuovo subagent esegue ogni task
3. L'agent di revisione (code-reviewer) controlla il lavoro
4. L'agent principale continua o richiede correzioni

Perché funziona: ogni subagent inizia con un contesto pulito focalizzato su UN task. Nessuna confusione accumulata da sessioni lunghe.

Applicazione del TDD

Superpowers prende sul serio il TDD. La competenza:

• richiede un test fallito PRIMA dell'implementazione
• osserva il test fallire (dimostra che testa qualcosa)
• implementa il codice minimo per passare
• fa commit al verde
• refactorizza solo dopo il verde

Se Claude scrive codice prima dei test, la competenza gli ordina di eliminare quel codice e ricominciare.

Esempio pratico

Tu: Ho bisogno di autenticazione utente per la mia app Express

Claude (con Superpowers): → Attiva la competenza brainstorming → Chiede: OAuth o password? Sessione o JWT? Quali provider? → Esplora: Rate limiting? Blocco account? Requisiti password? → Presenta il design in sezioni per la tua approvazione

Tu: Sembra buono, pianifichiamolo

Claude: → Attiva la competenza writing-plans → Crea 12 task, ciascuno 2-5 minuti → Task 1: Crea test fallito per endpoint /signup → Task 2: Implementa handler signup per passare il test → Ogni task ha percorsi file esatti e codice

Tu: Esegui

Claude: → Genera subagent per Task 1 → L'agent code-reviewer valida l'output → Genera subagent per Task 2 → Riporta il progresso, chiede approvazione per continuare

Gestione del plugin

Dal menu /plugin puoi:

• Disable plugin: disattiva temporaneamente
• Mark for update: contrassegna per il prossimo ciclo di aggiornamento
• Update now: ottieni l'ultima versione immediatamente
• Uninstall: rimuovi completamente
• View on GitHub: vedi il codice sorgente

Quando NON usare Superpowers

• domande rapide una tantum
• semplici modifiche ai file
• task sotto i 5 minuti

Per questi casi, il sovraccarico non ne vale la pena. Superpowers brilla su funzionalità multi-file, refactoring e migrazioni che richiedono un'esecuzione sistematica.

Riferimento Rapido

Superpowers trasforma Claude Code da "assistente utile che a volte deraglia" a "partner di sviluppo sistematico che segue processi collaudati". Il workflow strutturato previene le modalità di fallimento più comuni: test saltati, casi limite mancanti e funzionalità che si discostano dai requisiti.