Repo del giorno: Superpowers, la metodologia di sviluppo per agenti di coding

💡 Cos'è Superpowers: una metodologia, non una raccolta di prompt

Superpowers è un repository open source (licenza MIT) che impacchetta una libreria di skill componibili — file Markdown con istruzioni operative — più un bootstrap che si assicura che l'agente le consulti prima di agire. Le skill coprono l'intero ciclo di vita dello sviluppo: brainstorming socratico, piani di implementazione, worktree Git isolati, TDD, debugging sistematico, code review in due fasi e chiusura del branch. La regola centrale è brutale nella sua semplicità: se esiste una skill pertinente al task, l'agente DEVE usarla — workflow obbligatori, non suggerimenti.

Il progetto è nato a ottobre 2025 da un post sul blog dell'autore ed è esploso nel giro di pochi mesi: oggi è mantenuto da Jesse Vincent con il team di Prime Radiant, ha una suite di eval dedicata per testare il comportamento delle skill e viene distribuito dal marketplace ufficiale dei plugin Claude. Non è legato a un solo strumento: lo stesso repo si installa su Claude Code, Codex (CLI e App), Cursor, GitHub Copilot CLI, Antigravity, Factory Droid, Kimi Code, OpenCode e Pi.

repo       obra/superpowers
stelle     ~224.700 · licenza MIT · autore Jesse Vincent (Prime Radiant)
cosa       ~14 skill componibili + bootstrap che le rende vincolanti
flusso     brainstorming → piano → TDD → review → merge
harness    Claude Code · Codex · Cursor · Copilot CLI · OpenCode · altri
extra      marketplace dedicato · eval harness per testare le skill

🧭 Il flusso di lavoro: dal brainstorming al merge, senza saltare passaggi

Il cuore di Superpowers è il flusso in sette tappe che si attiva da solo. Appena l'agente capisce che stai costruendo qualcosa, non si butta sul codice: parte la skill di brainstorming, che fa domande, esplora alternative e ti presenta il design in sezioni brevi da validare una alla volta. Approvato il design, l'agente crea un worktree Git isolato su un branch dedicato, verifica che i test partano puliti, e solo allora scrive un piano di implementazione fatto di task da 2-5 minuti ciascuno, con percorsi file esatti e passi di verifica.

Al «vai» parte il subagent-driven development: un subagente fresco per ogni task, e ogni risultato passa una review in due fasi — prima la conformità alla specifica, poi la qualità del codice. Il README rivendica sessioni in cui l'agente lavora in autonomia per un paio d'ore senza deviare dal piano; nella mia esperienza il valore vero è un altro: anche quando intervengo, il lavoro arriva già strutturato, testato e motivato.

⚙️ Come si installa: marketplace ufficiale e dieci harness

Su Claude Code l'installazione è un comando solo, dal marketplace ufficiale dei plugin Anthropic; in alternativa c'è il marketplace dedicato dell'autore, che pubblica anche plugin correlati. Su Codex (CLI e App) Superpowers è nel marketplace ufficiale OpenAI, su Cursor si installa con `/add-plugin`, e per Copilot CLI, OpenCode e gli altri harness il README documenta il percorso passo-passo. Se usi più di un agente, va installato separatamente su ciascuno.

Una volta installato non serve fare nulla: un hook di inizio sessione carica la skill introduttiva `using-superpowers`, e da lì in poi le skill si attivano da sole quando il contesto le rende pertinenti. È la differenza pratica rispetto a tenere gli stessi consigli in un file di istruzioni: qui il trigger è parte del sistema, non affidato alla memoria del modello.

# Claude Code — marketplace ufficiale Anthropic
/plugin install superpowers@claude-plugins-official

# in alternativa: il marketplace dedicato dell'autore
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

# Codex CLI: /plugins → cerca "superpowers" → Install Plugin
# Cursor:
/add-plugin superpowers

🧪 TDD e verifica: la disciplina che al vibe coding manca

Le due skill che considero il vero motivo per installarlo sono test-driven-development e verification-before-completion. La prima impone il ciclo RED-GREEN-REFACTOR senza sconti: test che fallisce, codice minimo che lo fa passare, refactor, commit — e il codice scritto prima del test viene buttato. La seconda blocca il vizio peggiore degli agenti: dichiarare «fatto, tutto verde» senza aver rilanciato nulla. Prima di dire che un task è completo, l'agente deve eseguire i comandi di verifica e mostrare l'output — evidenze, non affermazioni.

C'è poi systematic-debugging, che davanti a un bug impone quattro fasi di diagnosi della causa radice prima di proporre qualunque fix. Sono esattamente i punti in cui il vibe coding «puro» degrada in codice fragile: Superpowers non rende il modello più intelligente, gli impedisce di prendere le scorciatoie che prenderebbe da solo. È il complemento naturale dei quality gate via hook di cui ho già scritto: lì il controllo è esterno e a fine sessione, qui è interno e a monte.

🏢 Perché è interessante, per sviluppatori e PMI

Per chi sviluppa, Superpowers è il modo più rapido di passare da «prompt artigianali» a un processo ripetibile: le skill sono Markdown leggibile, e anche solo studiarle è un corso accelerato di ingegneria agentica — come si scrive un piano eseguibile da un subagente, come si struttura una review in due fasi, come si impedisce a un modello di auto-assolversi. E siccome è tutto testo versionato, si può ispezionare, forkarne una parte o disattivare ciò che non convince.

Per una PMI che usa agenti di coding, il punto è la prevedibilità: due sviluppatori con lo stesso plugin producono lavoro con la stessa forma — design documentato, piano, test, review — invece di due stili di prompting incompatibili. Il metodo smette di essere conoscenza personale e diventa un asset del team, versionato come il codice. È lo stesso salto culturale che ho raccontato parlando del passaggio da vibe coding ad agentic engineering, qui impacchettato in un plugin che si installa in un minuto.

⚠️ Cosa sapere prima di adottarlo

Il rovescio della medaglia è il peso del processo: per un fix da una riga, passare da brainstorming, piano e worktree può sembrare burocrazia — il flusso rende al meglio su feature vere, meno sui micro-task, e all'inizio conviene imparare quando assecondarlo e quando dirgli esplicitamente di saltare i passaggi. C'è poi un costo in contesto e token: skill caricate e subagenti dispacciati non sono gratis, anche se il design «un subagente fresco per task» tiene le singole finestre di contesto pulite.

Due note di trasparenza che il progetto stesso mette in chiaro: il componente visuale opzionale del brainstorming carica un logo remoto che funge da telemetria minima (versione in uso, nessun dato del progetto), disattivabile con una variabile d'ambiente; e il team non accetta quasi mai skill nuove dall'esterno, perché ogni modifica deve funzionare su tutti gli harness supportati — chi vuole estendere il sistema scrive le proprie skill nel proprio spazio, seguendo la skill `writing-skills`.

• Overhead di processo: perfetto sulle feature, eccessivo sui micro-fix; si può sempre chiedere di saltare passaggi.
• Costo in token: brainstorming, piani e subagenti consumano contesto — il ritorno è meno rilavorazione.
• Telemetria opzionale: solo versione in uso, via logo remoto; si spegne con `SUPERPOWERS_DISABLE_TELEMETRY`.
• Contributi limitati: niente skill esterne nel core; le tue skill personalizzate vivono accanto, non dentro.

🗺️ Da dove partire

Il percorso che suggerisco: installa il plugin su Claude Code dal marketplace ufficiale, apri una feature vera — non un fix — e lascia che il brainstorming faccia il suo lavoro rispondendo sul serio alle domande. Poi leggi le skill che ti hanno guidato: sono nel repo, in chiaro, e capire perché sono scritte così vale quanto usarle. Dopo una settimana saprai quali tenere vincolanti e dove preferisci la mano libera.

Se il tema ti interessa, ne ho scritto da altre angolazioni: i workflow strutturati di claude-code-workflows (un approccio più leggero allo stesso problema), gli hook come quality gate e il maximalista ECC. Superpowers sta nel mezzo: più metodo di un config pack, meno invasivo di un «sistema operativo» — per me, oggi, il miglior rapporto disciplina/attrito.

Altri articoli del blog