Superpowers

Inštalácia

/plugin install superpowers@claude-plugins-official

Implementačný flow

Nápad → realizácia. (Skilly si agent volá sám.)

brainstorming — hard gate pred akýmkoľvek kódom. Najprv nahlas zaklasifikuje, koľko procesu tvoja požiadavka potrebuje: spike (otázka, ktorej výstupom je odpoveď, nie kód), bounded (ohraničená zmena v toku, ktorý už v repe existuje) alebo architectural (nový projekt, nový subsystém, zmena rozhraní). Pri pochybnosti berie ťažšiu cestu a cesta ide len nahor — skrytá zložitosť nájdená v polovici úlohu povýši, nikdy nezníži.

Pýta sa po jednej otázke, nie v dávkach. Pri architectural ceste potom navrhne 2–3 prístupy aj s odporúčaním, prezentuje design po sekciách a po každej si vypýta „sedí to?". Až na konci uloží spec do docs/superpowers/specs/ a commitne ho.

Aj „príliš jednoduché na design" má schvaľovací krok. So zložitosťou úlohy sa škáluje dĺžka výstupu, nie to, či ťa niekto pustí ďalej.
using-git-worktrees — izolovaný workspace na novej vetve, ešte pred prvou zmenou. Najprv zisťuje, či už v izolácii nie si, potom skúša natívne nástroje harnessu a až nakoniec siahne po git worktree. Pustí setup projektu a overí, že testy sú na začiatku zelené — inak nevieš, čo si rozbil ty a čo bolo rozbité predtým.
writing-plans — zo špecifikácie spraví plán do docs/superpowers/plans/. Píše sa pre nadšeného juniora bez kontextu, so slabým vkusom a s odporom k testom: presné cesty k súborom, hotový kód, ako to overiť. Kroky sú na 2–5 minút („napíš padajúci test", „pusti ho a pozri, že padá", „naimplementuj minimum", „pusti testy", „commitni").
subagent-driven-development — na každý task čerstvý subagent, po každom review, na konci široký review celej vetvy. Subagent nededí tvoju session, dostane presne poskladaný kontext. Detaily a alternatívy sú nižšie.
test-driven-development — RED-GREEN-REFACTOR, bez výnimiek. Napíš test, pozri sa, ako padá, napíš minimum, pozri sa, ako prejde, commitni. Ak si test nevidel spadnúť, nevieš, či testuje správnu vec. Kód, ktorý vznikol pred testom, sa zahadzuje.
requesting-code-review — recenzenta robí subagent, ktorému sa kontext skladá naschvál, aby si názor nezašpinil históriou session. Nálezy chodia po závažnosti: Critical blokuje hneď, Important sa opraví pred ďalším krokom, Minor ostáva ako poznámka. Ak sa recenzent mýli, patrí sa mu oponovať kódom a testami, nie ho poslušne poslúchnuť.
finishing-a-development-branch — až keď celá suita beží zelená. Ponúkne tri možnosti: merge do base vetvy lokálne, push a Pull Request, alebo nechať vetvu tak. Base vetvu si nechá potvrdiť (merge do zlej sa ťažko vracia) a po zvolenej ceste upratuje worktree.

Nič z toho nespúšťaš príkazom. Superpowers nemá slash príkazy — má bootstrap, ktorý agentovi hovorí, že ak je čo i len 1 % šanca, že sa skill hodí, musí ho použiť, a to skôr, než čokoľvek odpovie alebo sa začne prehrabávať v repe. Ak ho chceš navigovať, skill jednoducho pomenuj: použi brainstorming skill. A keď ho chceš obísť, povedz to výslovne — tvoje inštrukcie (aj CLAUDE.md) majú prednosť pred skillami.

Vykonávanie plánu

Keď writing-plans nechá v repe plán, sú tri spôsoby, ako ho dostať do kódu. Líšia sa tým, koľko z toho odsedíš pri klávesnici a či to celé beží v jednom okne.

subagent-driven-development

Default, keď má harness subagentov. Na každý task ide čerstvý implementér, po ňom review na dve veci naraz — plní to spec? a je to dobrý kód? — a na záver široký review celej vetvy. Tvoje okno ostáva čisté, lebo v ňom koordinuješ, neimplementuješ.

Beží bez zastavovania. Nejasnosti, konflikty a chyby v pláne rozhoduje sám a zapisuje ich do ledgeru ako Ruling: čo som rozhodol — prečo — čo to stojí, ak sa mýlim. Zle rozhodnuté stojí prerobenie, ktoré vidíš v diffe; session zaparkovaná na otázke stojí celý deň.

Zastavia ho presne štyri veci: nezvratná alebo deštruktívna operácia, bezpečnostne citlivá akcia, vedľajší efekt mimo worktree (merge, push do zdieľanej vetvy, publish) a plán tak rozbitý, že každá ďalšia cesta je hádanie. Opravné kolá na jeden task sú limitované na päť, potom otvorené nálezy rozsúdi a ide ďalej.

executing-plans

To isté, ale v samostatnej session a v dávkach s ľudskými checkpointmi. Siahni po tom, keď harness subagentov nemá, alebo keď chceš medzi dávkami reálne pozerať na diffy. Pomalšie, zato každý kus prejde cez teba.

dispatching-parallel-agents

Pre 2+ úloh, ktoré nezdieľajú stav ani na sebe nezávisia — tri padajúce testy v troch subsystémoch, tri nesúvisiace bugy. Jeden agent na jednu problémovú doménu, bežia naraz a hotové je to za čas najdlhšej vetvy, nie za súčet.

Praktické použitie

Nový feature

chcem pridať export objednávok do CSV
→ brainstorming: „toto je architectural, idem celým procesom"
→ otázky po jednej, potom 2–3 prístupy s odporúčaním
→ design po sekciách, schválenie, spec do docs/superpowers/specs/
→ worktree, plán do docs/superpowers/plans/
poď na to
→ subagentom task po tasku, review po každom, na konci celá vetva

Do konca nemusíš napísať ani jeden príkaz. Tvoja práca je odpovedať na otázky a povedať áno alebo nie na design — od writing-plans ďalej to ide samo až po menu s merge / PR / nechať tak.

Malá zmena

pridaj filter podľa dátumu do zoznamu objednávok
→ brainstorming: „toto je bounded"
→ pár otázok, krátky design rovno v chate, žiadny spec ani plán
áno, choď
→ implementácia normálnym workflowom, TDD platí aj tu

Bounded znamená, že tok, ktorý meníš, je už v repe a dá sa prečítať — nie že sa v tej doméne cítiš doma. Nový projekt bounded nikdy nie je.

Bug

upload padá na súboroch nad 10 MB
→ systematic-debugging: žiadne fixy pred root cause
→ prečítať chybu celú, spraviť spoľahlivé repro, pozrieť posledné zmeny
→ pri viacerých komponentoch: logy na každej hranici, kým nie je jasné kde
→ až potom fix, cez TDD — test najprv padá na tom istom repro

Železné pravidlo skillu je žiadny fix bez vyšetrenia príčiny, a platí tým viac, čím väčší je tlak — práve pri „len to rýchlo spravme" sa najviac háda. Na koniec sedí verification-before-completion: hotovo sa nehovorí, kým v tej istej správe nebeží overovací príkaz s výstupom.

Všetky skilly

Sada má 14 skillov. Väčšinu z nich neuvidíš spustiť sa vedome — volajú sa navzájom podľa toho, čo práve robíš. Hlavný tok vyššie je len jedna z piatich skupín.

01 · Bootstrap

Vloží sa na štarte každej session. Nastavuje pravidlo, na ktorom stojí celý zvyšok.

using-superpowers — káže agentovi nájsť a použiť skill skôr, než čokoľvek odpovie alebo spraví, vrátane doplňujúcich otázok.

02 · Hlavný tok

Chrbtica nápad → zelená vetva, v poradí. To je tok, ktorý rozoberá zvyšok tejto stránky.

brainstorming — vypýta z nápadu design, po jednej otázke, a nepustí ťa do kódu bez schválenia.
using-git-worktrees — postaví izolovaný workspace so zeleným baselinom.
writing-plans — premení spec na plán z krokov na 2–5 minút.
subagent-driven-development — odpracuje plán čerstvým subagentom na každý task.
test-driven-development — drží red-green-refactor slučku a maže kód napísaný pred testom.
requesting-code-review — pošle prácu recenzentovi, ktorý nevidel, ako vznikala.
finishing-a-development-branch — overí testy a nechá ťa vybrať merge, PR alebo nechať tak.

03 · Iné spôsoby vykonávania

Tá istá práca, iné rozdelenie medzi teba, session a subagentov.

executing-plans — odbehne plán v samostatnej session, v dávkach s checkpointmi.
dispatching-parallel-agents — rozdá nezávislé úlohy agentom, ktorí bežia naraz.

04 · Keď to nejde podľa plánu

Skilly na to, keď niečo padá, keď si nie si istý, či je hotovo, alebo keď ti príde review.

systematic-debugging — štyri fázy od root cause; bez nej sa fix ani nenavrhuje.
verification-before-completion — dôkaz pred tvrdením: bez čerstvého výstupu žiadne „hotovo".
receiving-code-review — spracuje feedback technicky, nie poslušne; overí, potom mení.

05 · Meta

Vrstva na písanie samotných skillov.

writing-skills — píše a testuje nové skilly ako TDD: najprv sa pozri, ako agent bez skillu zlyhá.

Verzia 6.3.0, MIT, od Jesseho Vincenta a Prime Radiant. Plugin ťahá logo vo vizuálnom companione brainstormingu z ich webu — je to jediná telemetria, posiela len verziu a vypína sa cez SUPERPOWERS_DISABLE_TELEMETRY (rešpektuje aj DISABLE_TELEMETRY Claude Code).

Resources

github.com/obra/superpowers — repo, MIT, inštalačné príkazy pre všetky harnessy.
blog.fsck.com — pôvodné oznámenie, kde autor vysvetľuje, prečo to celé takto stojí.
Discord — komunita okolo sady, otázky a čo z toho komu vylezie.