# Superpowers: zdyscyplinowany proces tworzenia oprogramowania z agentami

URL: https://developertoolkit.ai/pl/ecosystem/frameworks/superpowers/
Description: Superpowers 6.4.2 w Claude Code, Codex i Cursorze: brainstorming, plan, TDD z subagentami, review i zweryfikowane zakończenie oraz koszty i pułapki.

Superpowers (obra/superpowers, licencja MIT, wersja 6.4.2) to wtyczka z 15 skillami i bootstrapem ładowanym na starcie sesji, która każe agentowi uzgodnić projekt, odizolować pracę w worktree, napisać przejrzany plan, implementować w ścisłym TDD, przejrzeć każde zadanie i pokazać wynik testów przed ogłoszeniem sukcesu. Steruje modelem; egzekwują CI i ludzkie review.

Prosisz agenta o „klucze API na poziomie organizacji z rotacją”, a po 20 minutach agent zmienił 14 plików, wymyślił model uprawnień, o który nikt nie prosił, i twierdzi, że „wszystkie testy przechodzą”, nie pokazując ani jednego uruchomienia. Ta strona jest dla programistów i tech leadów, którzy chcą, żeby agent najpierw pytał, planował jawnie i udowadniał swoje twierdzenia — i którzy muszą wiedzieć, ile ta dyscyplina kosztuje.

## Co dostajesz z tego przewodnika po Superpowers

- Polecenia instalacji dla Claude Code, Codex i Cursora oraz 30-sekundowy test, czy bootstrap zadziałał.
- Którą wersję serwuje każdy marketplace i co różnica 6.4.1 vs 6.4.2 zmienia w planach.
- Ośmioetapowy workflow i artefakt, który zostawia każdy etap — przeglądasz projekt i plan zamiast każdego diffa.
- Cztery prompty do skopiowania, koszt w tokenach na wywołanie i tabelę awarii z krokami naprawy.

## Superpowers w skrócie (wrzesień 2026)

| Fakt | Wartość (odczyt 2026-09-26, chyba że zaznaczono) | Źródło |
|---|---|---|
| Wersja upstream | **6.4.2**, wydana 2026-09-25 | [`plugin.json`](https://github.com/obra/superpowers/blob/main/.claude-plugin/plugin.json), [release notes](https://github.com/obra/superpowers/blob/main/RELEASE-NOTES.md) |
| `claude-plugins-official` Anthropic | przypięty commit to **6.4.1** | [manifest marketplace’u](https://github.com/anthropics/claude-plugins-official/blob/main/.claude-plugin/marketplace.json) |
| `superpowers-marketplace` autora | **6.4.2** | `claude plugin install` w Claude Code 2.1.283, 2026-09-26 |
| Codex `openai-curated` (`openai-api-curated` z kluczem API) | manifest podaje **6.3.0** | [openai/plugins](https://github.com/openai/plugins/blob/main/plugins/superpowers/.codex-plugin/plugin.json) |
| Skille | 15 oraz hook `SessionStart`, który wstrzykuje `using-superpowers` | `claude plugin details` |
| Stały koszt kontekstu | ~838 tokenów na sesję | `claude plugin details`, Claude Code 2.1.283, 2026-09-26 |
| Popularność | **1 009 371 instalacji** w katalogu wtyczek Claude; **291,7 tys.** gwiazdek na GitHubie | [claude.com/plugins/superpowers](https://claude.com/plugins/superpowers); [GitHub](https://github.com/obra/superpowers), odczyt 2026-09-26 |

Liczba instalacji obejmuje tylko instalacje Claude Code z katalogu Anthropic, a gwiazdki mierzą zainteresowanie repozytorium, nie realne użycie. Żadna z tych liczb nie mówi, że workflow poprawia twój kod — to zmierzy twój własny pilotaż.

## Jak działa Superpowers: skille, bootstrap i adaptery harnessów

Superpowers ma trzy warstwy, a różnica między nimi tłumaczy większość problemów z instalacją.

1. **Skille.** Piętnaście procedur `SKILL.md`: `brainstorming`, `using-git-worktrees`, `writing-plans`, `subagent-driven-development`, `executing-plans`, `dispatching-parallel-agents`, `test-driven-development`, `systematic-debugging`, `requesting-code-review`, `receiving-code-review`, `verification-before-completion`, `finishing-a-development-branch`, `writing-skills`, `using-superpowers` i `diagnosing-superpowers`.
2. **Bootstrap.** `using-superpowers` każe agentowi sprawdzić, czy pasuje jakiś skill, zanim odpowie, zada pytanie albo dotknie repozytorium. Wtyczka wstrzykuje go na starcie sesji; bez niego skille leżą na dysku i odpalają się tylko wtedy, gdy model akurat po nie sięgnie.
3. **Adaptery harnessów.** Manifesty i mapowania narzędzi dla każdego hosta. Claude Code i Cursor używają hooka startu sesji; Codex nie deklaruje żadnych hooków i polega na natywnym wykrywaniu skilli.

Kolejność jest jawna: twoje instrukcje — bezpośrednie polecenia i `CLAUDE.md` / `AGENTS.md` — mają pierwszeństwo przed skillami Superpowers, a te przed domyślnym zachowaniem agenta. Jeśli chcesz najpierw poznać skille i wtyczki ogólnie, zacznij od [przeglądu ekosystemu](/pl/ecosystem/) i [sekcji o wtyczkach](/pl/ecosystem/plugins/).

**Mocne sformułowania to nie egzekwowanie**

Zwroty w rodzaju „Iron Law” czy „You MUST” sterują modelem probabilistycznym. Agent nadal potrafi pominąć test albo źle odczytać regułę, zwłaszcza po aktualizacji modelu lub harnessu. Prawdziwymi bramkami pozostają ochrona gałęzi, CI i wymagane review.

## Instalacja Superpowers w Claude Code, Codex i Cursorze

Zainstaluj natywną wtyczkę dla każdego agenta, którego używasz. README mówi wprost, że każdy harness wymaga osobnej instalacji.

**Claude Code**

W sesji wybierz jeden marketplace:

```text
/plugin install superpowers@claude-plugins-official
```

Dostajesz wtedy commit przypięty przez Anthropic (6.4.1 na 2026-09-26). Żeby śledzić upstream (6.4.2):

```text
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
```

Odpowiedniki w terminalu to `claude plugin marketplace add obra/superpowers-marketplace` i `claude plugin install superpowers@superpowers-marketplace` (sprawdzone w Claude Code 2.1.283, 2026-09-26). Skille mają przestrzeń nazw: etap wymusisz przez `/superpowers:brainstorming`.

**Codex**

W Codex CLI otwórz przeglądarkę wtyczek, wyszukaj `superpowers` i wybierz **Install Plugin**:

```text
/plugins
```

W aplikacji Codex otwórz **Plugins** na pasku bocznym i wybierz **+** obok Superpowers. Wtyczka pochodzi z wbudowanego marketplace’u `openai-curated`, którego manifest był za upstreamem (6.3.0), więc sprawdź, co dostałeś, zanim zaczniesz diagnozować zachowanie.

Z terminala `codex plugin list` pokazuje, co oferują skonfigurowane marketplace’y, a `codex plugin add` instaluje wtyczkę w formacie `PLUGIN@MARKETPLACE` (Codex 0.157.1):

```bash
codex plugin list
codex plugin add superpowers@openai-curated
```

Skopiuj dokładny identyfikator z `codex plugin list`: po zalogowaniu kontem ChatGPT to `superpowers@openai-curated`, z kluczem API `superpowers@openai-api-curated` (Codex 0.157.1).

**Cursor**

W czacie Cursor Agent:

```text
/add-plugin superpowers
```

Możesz też wyszukać „superpowers” w marketplace wtyczek. To polecenie pochodzi z README Superpowers; cursor.com był niedostępny podczas weryfikacji tej strony, więc potwierdź zainstalowaną wersję w widoku wtyczek Cursora.

README upstreamu opisuje też Antigravity, Devin CLI, Factory Droid, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Qwen Code, Hermes Agent i Muse — kopiuj te polecenia z [sekcji instalacji](https://github.com/obra/superpowers#installation), a nie ze starszych artykułów. O agentach Google pisz „Antigravity CLI (konta prywatne) / Gemini CLI (enterprise, klucz API)”: od 2026-06-18 Gemini CLI nie obsługuje już użytkowników darmowych ani planów Google AI Pro i Ultra, którzy przeszli na Antigravity CLI. Superpowers usunęło Gemini CLI w 6.1.0 i przywróciło w 6.2.0, więc `gemini extensions install https://github.com/obra/superpowers` znów działa — dla użytkowników Code Assist Standard lub Enterprise, Google Cloud i płatnych kluczy API.

### Sprawdź, czy bootstrap zadziałał

Otwórz nową sesję i wyślij smoke test z README:

```text
Let's make a react todo list
```

Działająca instalacja uruchamia `brainstorming`: agent pyta, po co ci ta aplikacja i co ma robić, zanim napisze jakikolwiek kod. Jeśli zaczyna generować szkielet projektu, bootstrap nie jest załadowany. W Claude Code `claude plugin list` pokazuje zainstalowane wtyczki, a `claude plugin details superpowers` — 15 skilli, hook `SessionStart` i stały koszt w tokenach.

**Pułapki przy instalacji Superpowers**

- **`npx skills add obra/superpowers` to nie wtyczka.** Przenośna kopia nie ma bootstrapu startu sesji, więc metoda sama się nie uruchamia. Używaj jej tylko do pojedynczych skilli, np. `npx skills add obra/superpowers --skill verification-before-completion`.
- **Jedna kopia na agenta.** Oficjalny marketplace i marketplace autora zawierają `superpowers`; instalacja z obu albo wtyczka plus `npx skills add` daje zduplikowane skille.
- **„Oficjalny” nie znaczy „najnowszy”.** 2026-09-26 `superpowers@claude-plugins-official` instalował 6.4.1, a upstream był na 6.4.2.
- **Pakiet npm `superpowers` to niezwiązany projekt z 2022 roku**, a repozytorium `anthropics/superpowers` nie istnieje.
- **Dawne komendy slash i nazwany agent `code-reviewer`** zniknęły w 5.1.0. Poradnik, który je wymienia, opisuje starą wersję.

## Którą wersję Superpowers masz i dlaczego to ważne

Trzy marketplace’y serwowały w tym samym tygodniu trzy wersje. Różnice dotyczą zachowania, nie kosmetyki:

| Masz | Co zmienia się w praktyce |
|---|---|
| **6.3.0** (Codex `openai-curated`) | Brak `diagnosing-superpowers`. `executing-plans` to stara wersja, która co kilka zadań zatrzymuje się, żeby dopytać. Brainstorming już skaluje ceremonię (spike, bounded, architectural). Paczka dostarcza dołączone skrypty bez bitu wykonywalności, więc helpery SDD kończą się `Permission denied` (naprawione upstream w 6.4.1). |
| **6.4.1** (oficjalny Claude) | `diagnosing-superpowers`; `executing-plans` przebudowany jako wykonanie **Native** z jednym review całej gałęzi; musisz przejrzeć zapisany plan, zanim cokolwiek ruszy; plany mają sekcję **Review Focus**; TDD uruchamia cały zestaw testów projektu. Plany nadal rozpisują pełny kod. |
| **6.4.2** (upstream, marketplace autora) | `writing-plans` zapisuje decyzje — sygnatury, nazwy i asercje testów, wartości ze specyfikacji, polecenie weryfikacji — zamiast pełnego kodu. Zmianę wywołało to, że część modeli frontierowych zaczęła implementować projekt w trakcie „planowania”. Opiekunowie raportują plany w około jednej czwartej czasu i jednej trzeciej tokenów w swoim odtworzeniu (release notes, 2026-09-25). |

Jeśli zespół łączy Claude Code i Codex, ten sam prompt może dać plan pełen kodu w jednym narzędziu i plan na poziomie decyzji w drugim. Zapisuj wersję w notatkach z pilotażu, a jeśli chcesz 6.4.2 już teraz, instaluj w Claude Code z marketplace’u autora.

## Workflow Superpowers krok po kroku

Każdy etap zostawia artefakt, który przeglądasz zamiast diffa. Etapy są takie same w Claude Code, Codeksie i Cursorze; różni się wersja serwowana przez każdy marketplace (patrz wyżej) oraz zagnieżdżony kontroler dostępny tylko w Claude Code.

1. **Brainstorming i klasyfikacja.** `brainstorming` pyta, po co ci zmiana, a potem klasyfikuje ją jako spike, zmianę ograniczoną (bounded) lub pracę architektoniczną. Zmiana ograniczona dostaje krótki projekt w czacie; praca architektoniczna — spisaną specyfikację w `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md`. Każda ścieżka zatrzymuje się na twoją akceptację.
2. **Izolacja.** `using-git-worktrees` wykrywa istniejące izolowane środowisko albo tworzy worktree na nowej gałęzi, instaluje zależności i uruchamia testy bazowe. Czerwona baza zatrzymuje pracę i agent pyta, co robić.
3. **Plan.** `writing-plans` zapisuje `docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md`: pliki per zadanie, interfejsy, asercje testów, polecenie weryfikacji z oczekiwanym wynikiem i listę Review Focus z wejściami, które specyfikacja zakłada, a żaden test jeszcze nie pokrywa. Przeglądasz plan przed wykonaniem.
4. **Wybór trybu wykonania.** Po zapisaniu planu skill proponuje dwa tryby wykonania i poleca jeden z nich. **Subagent-driven** uruchamia świeżego implementera na każde zadanie, a po każdym zadaniu — review (zgodność ze specyfikacją plus jakość kodu). **Native** (`executing-plans`) implementuje wszystkie zadania w bieżącej sesji i dostaje jedno review całej gałęzi na końcu — to najtańszy tryb.
5. **Implementacja w TDD.** `test-driven-development` wymaga testu, który pada z właściwego powodu, najmniejszej zmiany, która go przechodzi, i refaktoryzacji. Zielony wynik oznacza przejście całego zestawu testów projektu, a nie tylko nowego pliku testowego.
6. **Review.** Review zadania przechodzi do pięciu rund poprawek, zanim kontroler rozstrzygnie. Końcowy recenzent czyta zintegrowaną gałąź.
7. **Weryfikacja.** `verification-before-completion` wymaga faktycznego wyniku testów, builda, type-checka lub lintera przed każdym „gotowe”, „naprawione” czy „przechodzi”.
8. **Zakończenie.** `finishing-a-development-branch` ponownie uruchamia testy i proponuje lokalny merge, push z otwarciem PR albo zachowanie gałęzi. Porzucenie pracy następuje tylko na twoje wyraźne żądanie, z wpisanym potwierdzeniem.

### Przykład: klucze API organizacji od mglistej prośby do PR

Prośba brzmi: *Add organization-level API keys with rotation and audit history.* Zdrowy przebieg wygląda tak:

| Etap | Artefakt, który powinieneś zobaczyć | Twój punkt kontrolny |
|---|---|---|
| Brainstorming | Pytania o własność, widoczność kluczy, unieważnianie, uprawnienia, retencję i migrację; dwa lub trzy projekty z kompromisami; klasyfikacja: architektoniczna | Zatwierdź zachowanie i model zagrożeń |
| Specyfikacja | `docs/superpowers/specs/2026-09-26-organization-api-keys-design.md`, zacommitowana | Przeczytaj ją: jest krótsza niż kod |
| Izolacja | Worktree z przechodzącą bazą | Zdecyduj o ewentualnym istniejącym błędzie |
| Plan | Zadania: schemat, API, UI, migracja i testy; Review Focus wymienia „unieważniony klucz użyty w trakcie rotacji” i „wpis audytu przy nieudanej rotacji” | Zatwierdź zakres; dopisz brakujące przypadki brzegowe |
| Wykonanie | Na zadanie: padający test, minimalny kod, przechodzący zestaw, commit, werdykt recenzenta | Odpowiadasz tylko na pytania produktowe |
| Review końcowe | Uwagi do całej gałęzi, poprawione i ponownie przejrzane | Zdecyduj, czy gałąź jest gotowa |
| Weryfikacja | Świeży wynik migracji, testów, type-checka, lintera i builda | Porównaj z kryteriami akceptacji |
| Zakończenie | Otwarty PR | Zwykłe review PR i CI |

Wartość nie polega na tym, że agent „zrobił plan”: projekt, plan, dowody z testów i uwagi z review pozostają do wglądu po kompakcji kontekstu czy przekazaniu pracy.

## Prompty do skopiowania dla Superpowers

**Prompt do skopiowania: start funkcji z jawnymi bramkami**

```text
Add organization-level API keys with rotation and audit history.
Use the Superpowers workflow. Treat this as architectural: write the design
spec and a plan, and stop for my approval after each. Constraints: keys are
shown once and stored hashed; rotation keeps the old key valid for 24 hours;
every create, rotate and revoke writes an audit row. Our test command is
`npm test` and the type check is `npm run typecheck`. Do not change the
auth middleware without asking.
```

**Prompt do skopiowania: przegląd planu przed wykonaniem**

```text
Before we execute, review the saved plan against the design spec. List:
1) every requirement in the spec with the task and test that covers it,
2) any requirement with no test,
3) any task that changes a file the spec does not mention,
4) the Review Focus items and the test that pins each one.
Do not start implementation. Recommend Subagent-driven or Native execution
for this plan and give the reason in one sentence.
```

**Prompt do skopiowania: dowody przed pull requestem**

```text
Before you open the PR, use verification-before-completion. Run the full
test suite, the type check, lint and the build from a clean state. Paste the
command and the last 20 lines of output for each. Then map each acceptance
criterion in the spec to the test name that proves it. If any criterion has
no test, say so and stop instead of opening the PR.
```

**Prompt do skopiowania: dlaczego sesja poszła źle**

```text
Figure out what went wrong with superpowers in this session. I expected
brainstorming to stop for approval before any code, but files were created
before I approved the design. Report what happened with path:line evidence
from the transcript and tell me which skill did or did not fire.
```

Ostatni prompt wymaga wersji 6.4.1 lub nowszej, w której istnieje `diagnosing-superpowers`.

## Jak zweryfikować wynik Superpowers bez czytania każdej linii

Superpowers przenosi twój wysiłek recenzencki z diffa na trzy krótkie dokumenty i zestaw bramek maszynowych:

- **Przed kodem:** zatwierdzasz specyfikację (zachowanie, model zagrożeń, czego nie robimy) i plan (lista zadań, asercje testów, Review Focus). Tu człowiek łapie „zbudowaliśmy nie to, co trzeba”.
- **W trakcie wykonania:** każdy commit zadania musi następować po padającym teście, a każde zadanie ma werdykt recenzenta. Sprawdź wyrywkowo dwa lub trzy zadania: test powinien padać na commicie nadrzędnym i przechodzić na commicie zadania.
- **Przed merge’em:** wynik weryfikacji, CI na PR i wymagane review w repozytorium. Dodaj bramki, których Superpowers nie zapewnia — progi pokrycia lub testów mutacyjnych i wymagane status checki — żeby pominięty krok TDD kończył się głośną porażką, a nie cichym przejściem. Zobacz [pakiet dowodów, który powinien nieść PR](/pl/workflows/ship/evidence-bundle/) i [jak przeglądać pull requesty agentów](/pl/workflows/ship/agent-pr-review/).
- **Akceptacja:** programista prowadzący sesję odpowiada za zatwierdzenie specyfikacji i planu; recenzent PR (przy pracy architektonicznej — tech lead) akceptuje dowody, a nie czytanie linia po linii.

## Ile kosztuje Superpowers na sesję i na wywołanie

Projekcja samego Claude Code (`claude plugin details`, 2.1.283, 2026-09-26):

| Koszt | Tokeny |
|---|---|
| Stały, w każdej sesji (lista skilli + bootstrap) | ~838 |
| `brainstorming`, przy każdym uruchomieniu | ~6,3 tys. |
| `subagent-driven-development`, przy każdym uruchomieniu | ~11,8 tys. plus świeży kontekst dla każdego implementera i recenzenta |

Stały koszt jest niski na tle podobnych frameworków — w tym samym pomiarze Compound Engineering to ~2989, a Everything Claude Code ~41 515. Główny koszt generuje wykonanie planu. Żeby go ograniczyć:

- Wybieraj wykonanie **Native** dla planów z małymi, jednorodnymi zadaniami; zużywa jeden kontekst plus jedno review końcowe.
- W Claude Code poproś, żeby kontroler SDD działał jako zagnieżdżony subagent na modelu średniej klasy; release notes 6.4.1 (2026-09-18) raportują mniej więcej połowę kosztu i czasu, według pomiarów opiekunów. To opcja na żądanie.
- Pozwól brainstormingowi klasyfikować drobną pracę jako ograniczoną, zamiast wymuszać pełną ścieżkę ze specyfikacją.

## Kiedy używać Superpowers, a kiedy odpuścić

Używaj pełnego workflow, gdy wymagania są niejasne, zmiana obejmuje kilka warstw, zachowanie da się przetestować albo praca przejdzie między sesjami lub ludźmi.

Odpuść albo użyj pojedynczych skilli przy poprawkach jednolinijkowych lub mechanicznych, jednorazowych spike’ach, repozytoriach bez test runnera (TDD i weryfikacja dają wtedy ceremonię bez sygnału) albo gdy twój proces ma już mocniejsze bramki. `systematic-debugging` i `verification-before-completion` są warte instalacji także osobno; [strona o skillach do testowania i debugowania](/pl/ecosystem/skills/testing-debugging-skills/) omawia je bez frameworka.

Jeśli potrzebujesz trwałej, żywej specyfikacji zamiast dokumentu projektowego na funkcję, porównaj [frameworki spec-driven](/pl/ecosystem/frameworks/spec-driven-frameworks/), takie jak Spec Kit i OpenSpec. Pełny przegląd znajdziesz w [porównaniu frameworków](/pl/ecosystem/frameworks/).

## Co psuje się w Superpowers i jak to naprawić

| Objaw | Przyczyna | Naprawa |
|---|---|---|
| Agent od razu pisze kod | Bootstrap niezaładowany: przenośna kopia z `npx skills add` albo zablokowany hook | Zainstaluj natywną wtyczkę; uruchom smoke test; sprawdź hook `SessionStart` w `claude plugin details superpowers` |
| Skille pojawiają się dwa razy | Instalacja z dwóch marketplace’ów albo wtyczka plus `npx skills add` | Usuń jedną kopię na agenta |
| W jednym narzędziu plany to strony kodu, w drugim są krótkie | Rozjazd wersji: 6.4.1 lub 6.3.0 vs 6.4.2 | Wyrównaj wersje; w Claude Code instaluj z `superpowers-marketplace` |
| Wykonanie co kilka zadań staje i dopytuje | `executing-plans` z Codex 6.3.0 | Spodziewaj się tego, dopóki `openai-curated` się nie zaktualizuje, albo wybierz Subagent-driven |
| Codex: skrypty skilli kończą się `Permission denied` | Paczka `openai-curated` 6.3.0 gubi bity wykonywalności (naprawione w 6.4.1) | Wywołaj skrypt przez interpreter (`bash scripts/<nazwa>.sh`) albo poczekaj, aż `openai-curated` wyda 6.4.1+ |
| Codex prosi o zaufanie hookowi SessionStart | Pakiet sprzed 6.1.1 | Zaktualizuj wtyczkę; wersje dla Codex od 6.1.1 nie deklarują hooków |
| Windows: bootstrap po cichu się nie ładuje | Cytowanie powłoki w hooku przed 6.2.0 | Zaktualizuj do 6.2.0+, użyj Claude Code 2.1.81 lub nowszego i zainstaluj Git for Windows |
| Dwa plany w jednym checkoucie nadpisują sobie stan | Wspólny `.superpowers/sdd/` przed 6.2.0 (ta sama nazwa pliku przed 6.4.1) | Zaktualizuj; i tak dawaj każdej równoległej sesji osobny worktree |
| „Testy przechodzą” bez wyniku | Pominięta weryfikacja | Wklej prompt o dowodach z tej strony; uznaj przebieg za nieudany, dopóki nie pojawi się wynik |
| Pominięte TDD | Model nie zastosował się do skilla | Uznaj przebieg za nieudany; dodaj bramkę w CI lub review zamiast mocniejszych sformułowań |
| Usunięcie worktree zgubiłoby pliki | Niezacommitowana praca w worktree | 6.3.0+ zatrzymuje się i wymienia pliki; zacommituj lub schowaj zmiany, nigdy `--force` |
| Skill odpalił się lub milczał nieoczekiwanie | Niedopasowany wyzwalacz | Uruchom prompt diagnostyczny z tej strony (6.4.1+) i zgłoś oczyszczony pakiet upstream |

## Kontrole bezpieczeństwa przed wdrożeniem Superpowers

Skille to instrukcje, według których działa agent z dostępem do powłoki i sieci, więc przeglądaj je jak kod. Postępuj według [bezpieczeństwa łańcucha dostaw skilli](/pl/ecosystem/skills/skill-security/), a potem sprawdź szczegóły:

- Adaptery Claude Code, Cursora i kilku innych hostów uruchamiają hook `SessionStart`; przeczytaj `hooks/` przed instalacją i ponownie przy aktualizacjach.
- Opcjonalny **Visual Companion** z brainstormingu to lokalny serwer Node domyślnie nasłuchujący na `127.0.0.1`. Uruchomienie go na `0.0.0.0` (nasłuch na wszystkich interfejsach) poszerza granicę zaufania.
- Companion ładuje logo Prime Radiant z adresu zawierającego wersję Superpowers. Ustaw `SUPERPOWERS_DISABLE_TELEMETRY=true`, żeby to wyłączyć; respektowane są też `DISABLE_TELEMETRY` i `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`.
- Zgłoszenie z 2026-09-10 (#2277) opisuje, że `systematic-debugging` dostarcza fixtures testów presji napisane jako rozkazujące scenariusze, które trafiają do katalogów uruchomieniowych. Sprawdź, czy twoja wersja wciąż je zawiera.
- `receiving-code-review` traktuje komentarze z review jako twierdzenia do sprawdzenia. Zewnętrzne komentarze w PR nadal są niezaufanym wejściem: żaden nie może uruchomić dostępu do sekretów ani niezwiązanych poleceń.

## Co mówią dowody o Superpowers

Opiekunowie prowadzą [superpowers-evals](https://github.com/prime-radiant-inc/superpowers-evals), laboratorium, które przepuszcza prawdziwe CLI agentów przez scenariusze wyzwalania skilli, TDD, review i weryfikacji. Mierzy ono **zgodność z workflow**; nieliczne porównania bez wtyczki dotyczą pojedynczych skilli (w 6.4.1 stary stub `executing-plans` nie wypadł lepiej niż brak wtyczki), a nie całego pakietu, więc nie pokazuje, że pakiet wygrywa z agentem bez niego. Na 2026-09-26 nie było dostępnego niezależnego, kontrolowanego porównania całego frameworka, więc przeprowadź własne.

## Wdrożenie Superpowers w zespole

1. **Wybierz jeden pilotaż.** Średnia funkcja z jasnymi kryteriami akceptacji — nie zabawka i nie najbardziej ryzykowna migracja.
2. **Zapisz punkt odniesienia** na porównywalnej pracy bez wtyczki: akceptacja za pierwszym podejściem, ręczne poprawki, defekty z review, czas i tokeny.
3. **Przypnij i zapisz** wersję Superpowers, marketplace, wersję agenta i model u każdego uczestnika, żeby rozjazd wersji nie wyglądał jak wynik.
4. **Ustal zasady w `CLAUDE.md` / `AGENTS.md`:** kto zatwierdza specyfikacje i plany, kiedy wolno odstąpić od TDD (praca wizualna, pliki generowane) i które polecenia zawsze wymagają potwierdzenia.
5. **Każdą równoległą sesję uruchamiaj w osobnym worktree**, bez sekretów produkcyjnych w środowisku. Zobacz [Git worktrees dla równoległych agentów](/pl/developer-scorecard-guide/git-worktrees/).
6. **Mierz z wtyczką i bez niej.** W Claude Code `claude plugin eval` uruchamia przypadki ewaluacyjne na wtyczce i raportuje różnicę wyniku względem wariantu bez wtyczki. Umieść przypadki (`case.yaml` albo `prompt.md` z `graders/*.md`) w katalogu wewnątrz wtyczki — jako cel wystarczy lokalny klon — i wskaż jego nazwę przez `--eval-dir`; wariant bazowy bez wtyczki (`--ablation with-without`) jest włączony domyślnie (Claude Code 2.1.285, sprawdzone 2026-09-26).
7. **Zachowaj, przytnij lub usuń skille** po pilotażu i powtarzaj go po każdej dużej aktualizacji modelu, agenta lub wtyczki.

## Dokąd dalej po Superpowers

- [Porównanie frameworków pracy z agentami](/pl/ecosystem/frameworks/) — Gdzie Superpowers stoi obok Spec Kit, BMAD, OpenSpec, GSD i Compound Engineering.
- [Frameworki spec-driven](/pl/ecosystem/frameworks/spec-driven-frameworks/) — Kiedy żywa specyfikacja wygrywa z dokumentem projektowym na funkcję.
- [Compound Engineering](/pl/ecosystem/frameworks/compound-engineering/) — Pętla plan–praca–review–utrwalenie, która wprowadza wnioski z powrotem do repozytorium.
- [Test-driven development z agentami](/pl/method/principles/test-driven-development/) — RED–GREEN–REFACTOR z agentami, szerzej niż skill Superpowers.
- [Najlepsze wtyczki](/pl/ecosystem/plugins/top-plugins/) — Inne wtyczki warte instalacji, ze zmierzonym kosztem kontekstu.
- [Grill Me](/pl/ecosystem/skills/grill-me/) — Głębszy wywiad o wymaganiach przed brainstormingiem Superpowers.
