# Harnessy wieloagentowe i katalogi: Ruflo, wshobson/agents, SuperClaude, Task Master i CCPM

URL: https://developertoolkit.ai/pl/ecosystem/frameworks/multi-agent-harnesses/
Description: Zamień PRD w graf zadań, issues na GitHubie i równoległych agentów z CCPM, Task Master i wshobson/agents oraz sprawdź, gdzie pasują Ruflo i SuperClaude.

Harnessy wieloagentowe i katalogi dokładają do Claude Code, Codex i Cursora grafy zadań, wyspecjalizowane subagenty i śledzenie pracy w issues. CCPM i Task Master zamieniają PRD w zadania uporządkowane według zależności, wshobson/agents dostarcza subagenty i orkiestratory na sztuki, SuperClaude to menu komend tylko dla Claude Code, a Ruflo jest na poziomie eksperymentu badawczego: potężny, duży i trudny do audytu.

Masz dwustronicowe PRD strony profilu użytkownika, czterech agentów, których możesz puścić naraz, i tablicę sprintu, która ma pokazywać prawdziwy postęp. Ostatnim razem dwóch agentów przepisało ten sam komponent formularza, nikt nie umiał powiedzieć, który commit należy do którego zgłoszenia, a serwer MCP załadował 21 000 tokenów schematów narzędzi, zanim padł pierwszy prompt. Potrzebujesz równoległości bez bałaganu.

Ta strona jest dla programisty, który uruchamia agentów, i dla tech leada, który odpowiada za tablicę i bramkę merge'a. Najpierw przeprowadza jeden orkiestrator od początku do końca, potem składa pełny przepływ PRD → graf zadań → równoległe agenty → issues na GitHubie z narzędzi, które najlepiej robią każdy krok.

**Wersje i popularność na tej stronie**

Sprawdzone 2026-09-26 w README każdego projektu na GitHubie, w rejestrach npm i PyPI oraz w zainstalowanych Claude Code 2.1.283 i codex-cli 0.157.1. Gwiazdki na GitHubie, odczyt z 2026-09-26 (mierzą zainteresowanie, nie użycie): [ruvnet/ruflo](https://github.com/ruvnet/ruflo) 73,3 tys. (npm `ruflo` 3.46.1, 2026-09-26), [wshobson/agents](https://github.com/wshobson/agents) 40,0 tys. (wtyczka `full-stack-orchestration` 1.3.1), [eyaltoledano/claude-task-master](https://github.com/eyaltoledano/claude-task-master) 28,1 tys. (npm `task-master-ai` 0.43.1, 2026-03-31), [SuperClaude-Org/SuperClaude_Framework](https://github.com/SuperClaude-Org/SuperClaude_Framework) 23,9 tys. (PyPI `superclaude` 4.3.0, 2026-03-22) oraz [automazeio/ccpm](https://github.com/automazeio/ccpm) 8,4 tys. Serwis `cursor.com` był niedostępny ze środowiska, w którym powstała strona, więc każdy krok dla Cursora poniżej pochodzi z README projektu, a nie z testu.

## Co zyskujesz dzięki harnessom wieloagentowym

- Tabelę decyzyjną dla pięciu narzędzi, z poprawnymi nazwami pakietów i kosztem kontekstu, oraz działające uruchomienie `/full-stack-orchestration:full-stack-feature` z dwoma punktami akceptacji i dziewięcioma numerowanymi plikami i `state.json`, które zostawia.
- Przepływ pracy dla zespołu od PRD przez graf zadań, issues na GitHubie i równoległe agenty po merge, z czterema promptami do skopiowania i listą pułapek zbudowaną z nazw pakietów, narzędzi i ścieżek, które poradniki podają źle.

## Który harness wieloagentowy rozwiązuje który problem?

Te pięć narzędzi robi co innego: dwa planują pracę, jedno dostarcza wykonawców, jedno jest menu promptów, a jedno całym środowiskiem uruchomieniowym. Koordynowanie kilku agentów nad jednym zadaniem to [orkiestracja agentów](/pl/glossary/agent-orchestration/).

| Narzędzie | Co dodaje | Skąd instalować | Claude Code / Codex / Cursor | Koszt kontekstu | Stan na 2026-09-26 | Wybierz, gdy |
| --- | --- | --- | --- | --- | --- | --- |
| **CCPM** | Jeden Agent Skill: PRD → epik → zadania → issues na GitHubie → równoległe agenty | `git clone` repozytorium `automazeio/ccpm`, potem link do `skill/ccpm/` | Tak / Tak / Tak (wszystkie trzy wymienia README) | Opis jednego skilla, dopóki nie zadziała | Aktywny; stare komendy `/pm:*` są tylko na gałęzi `v1` | Issues mają być źródłem prawdy, a każdy commit ma prowadzić do jednego z nich |
| **Task Master** | Serwer MCP i CLI: PRD → graf zadań z zależnościami, zadanie `next` | npm `task-master-ai` | Tak / Tak (dowolny klient MCP) / Tak | ~21 000 tokenów dla wszystkich 36 narzędzi, ~5000 w trybie `core` (README, dane producenta) | Ostatnie wydanie w npm 2026-03-31 | Chcesz grafu zadań, o który zapyta dowolny agent, bez GitHuba |
| **wshobson/agents** | Marketplace `claude-code-workflows`: 94 wtyczki, 202 agenty, 16 orkiestratorów | `/plugin marketplace add wshobson/agents` | Tak / Tak / Tak (README) | ~599 tokenów dla `full-stack-orchestration` (zmierzone) | Aktywny | Chcesz wyspecjalizowanych subagentów albo gotowego orkiestratora, po jednej wtyczce |
| **SuperClaude** | 30 komend `/sc:*` i persony | PyPI `superclaude` (nie npm) | Tak / Nie / Nie | Nie zmierzono (komendy, nie wtyczka) | Brak wydania od 2026-03-22 | Pracujesz w Claude Code i chcesz gotowego menu komend |
| **Ruflo** (dawniej claude-flow) | CLI, serwer MCP, hooki, demon, roje agentów, pamięć wektorowa, 39 wtyczek | npm `ruflo` albo `/plugin marketplace add ruvnet/ruflo` | Tak / Tak / Nie | ~579 tokenów dla `ruflo-core`, bez schematów narzędzi MCP (zmierzone) | Aktywny, poziom badawczy | Eksperymentujesz z rojami i pamięcią agentów w sandboksie |

„Zmierzone” oznacza `claude plugin details` w Claude Code 2.1.283, które raportuje stały koszt wtyczki: opisy skilli i agentów ładowane do każdej sesji. Hooki nie kosztują kontekstu modelu; schematy narzędzi MCP kosztują, a `details` ich nie liczy.

Zanim cokolwiek zainstalujesz, sprawdź, czy narzędzie, którego już używasz, nie pokrywa potrzeby. Claude Code ma subagenty, `/batch` (od 5 do 30 jednostek w worktree) i `--worktree`; Codex i Cursor mają subagenty i worktree. Harness zasługuje na miejsce, gdy dodaje coś, czego tam brakuje: trwały graf zadań, śledzenie pracy w issues albo przetestowany prompt specjalisty. Same wzorce opisuje strona [wzorce orkiestracji wielu agentów](/pl/workflows/automate/orchestration-patterns/).

## Jeden orkiestrator od początku do końca: full-stack-feature

`full-stack-orchestration` to wtyczka z wshobson/agents, która z jednego zdania robi dziewięciokrokowe wdrożenie funkcji z dwoma ludzkimi punktami akceptacji. To najszybszy sposób, żeby zobaczyć, co robi harness.

### Zainstaluj wtyczkę w Claude Code, Codex albo Cursorze

**Claude Code**

W sesji Claude Code:

```text
/plugin marketplace add wshobson/agents
/plugin install full-stack-orchestration@claude-code-workflows
```

Potem w terminalu sprawdź koszt przed pierwszym uruchomieniem:

```bash
claude plugin details full-stack-orchestration@claude-code-workflows
```

W wersji 2.1.283 raport pokazuje jeden skill (`full-stack-feature`), cztery agenty (`deployment-engineer`, `security-auditor`, `performance-engineer`, `test-automator`) i około 599 tokenów stałego kosztu.

**Codex**

W terminalu:

```bash
codex plugin marketplace add wshobson/agents
codex plugin add full-stack-orchestration@claude-code-workflows
```

W Codex marketplace również rejestruje się jako `claude-code-workflows`. README projektu pokazuje zamiast tego `npx codex-marketplace add wshobson/agents`; to zewnętrzny pakiet npm, a natywne `codex plugin marketplace add` działa bez niego.

Notatki wshobson o harnessach mówią, że Codex dostaje komendy slash jako skille i deleguje do agenta tylko wtedy, gdy prompt go nazwie. Codex ogranicza treść skilla do 8 KB; generator wshobson przenosi resztę komendy o objętości około 20 KB do `references/details.md`. Przed pierwszym uruchomieniem poproś Codex, żeby zacytował sekcję `PHASE CHECKPOINT 2` tego skilla; jeśli nie potrafi jej znaleźć, plik referencyjny się nie załadował i uruchomienie nie zatrzyma się tam, gdzie się spodziewasz.

**Cursor**

Według README wshobson/agents Cursor czyta marketplace z katalogu `.cursor-plugin/` w repozytorium: dodaj `wshobson/agents` jako marketplace wtyczek, a potem wpisz w czacie agenta:

```text
/plugin install full-stack-orchestration
```

Cursor respektuje tylko flagę `readonly:`, a nie listę dozwolonych narzędzi `tools:` dla agenta (macierz możliwości w README), więc agenty od bezpieczeństwa i wydajności działają z pełnym dostępem sesji do narzędzi. Uruchamiaj je w sesji, której uprawnienia już przejrzałeś.

### Uruchom orkiestrator

**Prompt do skopiowania: orkiestracja strony profilu użytkownika**

```text
/full-stack-orchestration:full-stack-feature user profile page with avatar upload, display name and bio editing, visible only to the signed-in owner --stack react/fastapi/postgres --api-style rest --complexity medium
```

Forma z przestrzenią nazw zawsze się rozwiązuje; gołe `/full-stack-feature` działa tylko wtedy, gdy nic innego nie używa tej nazwy. Trzy flagi pochodzą z podpowiedzi argumentów samej komendy; bez `--stack` stos technologiczny jest wykrywany z repozytorium.

### Co powinieneś zobaczyć

1. **Kontrola wstępna.** Komenda tworzy `.full-stack-feature/state.json`. Jeśli taki plik już istnieje ze statusem `"status": "in_progress"`, proponuje wznowienie albo start od nowa, więc przerwane uruchomienie nie przepada.

2. **Wymagania, po jednym pytaniu.** Pada sześć pytań, od problemu po zależności, a odpowiedzi trafiają do `01-requirements.md` z kryteriami akceptacji jako polami wyboru. Właśnie je będziesz potem weryfikować, więc na drugie pytanie odpowiadaj obserwowalnym zachowaniem („awatar 6 MB jest odrzucany z kodem 413 i komunikatem”), a nie intencją.

3. **Projekt, potem punkt akceptacji 1.** Dwa subagenty piszą `02-database-design.md` i `03-architecture.md`. Uruchomienie się zatrzymuje i proponuje **Approve**, **Request changes** albo **Pause**. Nie może pójść dalej, dopóki nie wybierzesz Approve.

4. **Implementacja.** Kroki od 4 do 6 wprowadzają zmiany w bazie danych, backendzie i frontendzie, każdy z podsumowaniem we własnym numerowanym pliku.

5. **Równoległa walidacja, potem punkt akceptacji 2.** Krok 7 uruchamia naraz trzy agenty: `test-automator`, `security-auditor` i `performance-engineer`. Ich ustalenia trafiają do `07-testing.md` z liczbą problemów krytycznych, wysokich i średnich; krytyczne i wysokie są poprawiane przed drugim punktem akceptacji.

6. **Dostarczenie.** `deployment-engineer` w kroku 8 pisze zmiany w CI, kroki migracji, konfigurację feature flag, health checki, alerty i runbook z krokami wycofania. Krok 9 pisze dokumentację API, zapis decyzji architektonicznej (ADR) i podsumowanie przekazania. `state.json` kończy ze statusem `"complete"`.

Dziewięć numerowanych plików i `state.json` w `.full-stack-feature/` to ślad dowodowy uruchomienia. Zacommituj je razem z pull requestem albo świadomie usuń; nie pozwól, żeby przeszły do uruchomienia dla następnej funkcji.

**Prompt do skopiowania: przegląd punktu akceptacji przed zatwierdzeniem**

```text
Before I answer this checkpoint, act as an independent reviewer. Read .full-stack-feature/01-requirements.md and every later file in .full-stack-feature/. List, with file and section references: (1) each acceptance criterion that has no test planned or written for it, (2) each design or implementation choice that contradicts a stated constraint or the out-of-scope list, (3) each assumption no answer of mine confirmed. Do not edit anything. If all three lists are empty, say so in one line.
```

## Przepływ pracy zespołu: PRD, graf zadań, równoległe agenty i issues na GitHubie

Zespół potrzebuje planu, który przeżyje sesję, pracy widocznej na tablicy i commitów każdego agenta przypisanych do zgłoszenia. CCPM robi to przez issues na GitHubie, Task Master przez lokalny graf zadań. Poniższe kroki opierają się na CCPM i pokazują, gdzie wpinają się Task Master i agenty wshobson.

### Zainstaluj CCPM i Task Master

CCPM potrzebuje `git` i zalogowanego `gh` (`gh auth login`) w repozytorium z remote'em na GitHubie. Dla prawdziwych relacji rodzic–dziecko między issues zainstaluj rozszerzenie wskazane w README; bez niego CCPM wraca do list zadań.

```bash
# terminal, once per machine
git clone https://github.com/automazeio/ccpm.git ~/tools/ccpm
gh extension install yahsan2/gh-sub-issue
```

**Claude Code**

```bash
# terminal, in your project root
mkdir -p .claude/skills
ln -s ~/tools/ccpm/skill/ccpm .claude/skills/ccpm

# Task Master over MCP, in its 7-tool core mode
claude mcp add task-master-ai --scope user --env TASK_MASTER_TOOLS=core -- npx -y task-master-ai@0.43.1
```

**Codex**

README CCPM wymienia Codex wśród obsługiwanych hostów Agent Skills; wskaż mu `skill/ccpm/`. Codex czyta skille projektu z `.agents/skills/`:

```bash
# terminal, in your project root
mkdir -p .agents/skills
ln -s ~/tools/ccpm/skill/ccpm .agents/skills/ccpm

# Task Master over MCP, in its 7-tool core mode
codex mcp add task-master-ai --env TASK_MASTER_TOOLS=core -- npx -y task-master-ai@0.43.1
```

CCPM trzyma własne pliki w `.claude/prds/` i `.claude/epics/` niezależnie od tego, który agent go uruchamia.

**Cursor**

README CCPM wymienia Cursora wśród obsługiwanych hostów Agent Skills. Dokumentacja skilli Cursora (sprawdzone 2026-10-12) wymienia `.agents/skills/` i `.cursor/skills/` jako katalogi projektu, więc podlinkuj `~/tools/ccpm/skill/ccpm` do jednego z nich albo do katalogu, który pokazują ustawienia Skills w samym Cursorze, a nie do ścieżki z poradnika. Potem dodaj Task Master do `.cursor/mcp.json` (klucz to `mcpServers`, według README Task Master):

```json
{
  "mcpServers": {
    "task-master-ai": {
      "command": "npx",
      "args": ["-y", "task-master-ai@0.43.1"],
      "env": { "TASK_MASTER_TOOLS": "core" }
    }
  }
}
```

README Task Master każe po dodaniu włączyć serwer przełącznikiem w ustawieniach MCP Cursora.

Komendy przypinają `task-master-ai@0.43.1`, wersję aktualną na 2026-09-26, więc nowe wydanie trafi do zespołu dopiero po świadomym podbiciu. Task Master wywołuje własny model do parsowania PRD; skieruj go na Claude Code CLI, w którym jesteś zalogowany, pisząc w czacie „Change the main model to claude-code/sonnet” (przykład z README). Jeśli zamiast tego używasz klucza dostawcy, trzymaj go w pliku `.env` projektu, nigdy w linii komendy MCP.

### Przeprowadź przepływ pracy

1. **Napisz PRD, zaczynając od burzy mózgów.** CCPM uruchamia się na zwykły język. Pyta o problem, użytkowników, kryteria sukcesu, ograniczenia i zakres, zanim zapisze `.claude/prds/<name>.md`.

   **Prompt do skopiowania: start PRD w CCPM**

   ```text
   I want to build a user profile page: signed-in users can upload an avatar (PNG or JPEG, max 5 MB), edit a display name (3-40 characters) and a bio (max 280 characters). Only the owner sees the edit controls; everyone else sees a read-only card. Out of scope: public profile URLs, social links, account deletion. Where do we start? Ask me one question at a time, and write every acceptance criterion as an observable behaviour a test can check.
   ```

2. **Zamień PRD w graf zadań.** Napisz „parse the user-profile PRD”, żeby dostać `.claude/epics/user-profile/epic.md`, a potem „break down the user-profile epic”. Każdy plik zadania ma kryteria akceptacji, szacunek pracochłonności i trzy pola, które decydują, co może iść równolegle: `depends_on`, `parallel` i `conflicts_with`. CCPM domyślnie ogranicza epik do 10 zadań.

   Z Task Master umieść PRD w `.taskmaster/docs/prd.txt` i uruchom CLI albo poproś o to samo w czacie przez MCP:

   ```bash
   # terminal, after npm install -g task-master-ai
   task-master init
   task-master parse-prd .taskmaster/docs/prd.txt
   task-master list
   task-master next
   task-master show 1,3,5
   ```

3. **Przejrzyj graf, zanim cokolwiek trafi na GitHuba.** To najtańsze miejsce, żeby wyłapać dwóch agentów edytujących ten sam plik; tech lead zatwierdza tutaj.

   **Prompt do skopiowania: audyt grafu zadań przed synchronizacją**

   ```text
   Review every task file in .claude/epics/user-profile/ before we sync to GitHub. For each pair of tasks marked parallel: true, list the files or modules both are likely to touch, and flag any pair missing a conflicts_with entry. Flag any task whose acceptance criteria cannot be checked by an automated test, any task larger than one agent session, and any depends_on cycle. Propose the corrected frontmatter as a diff, but do not apply it.
   ```

4. **Zsynchronizuj z GitHubem.** Napisz „sync the user-profile epic to GitHub”. CCPM tworzy issue epiku i po jednym sub-issue na zadanie, zmienia nazwy lokalnych plików zadań na numery issues (`1235.md`), zapisuje plik mapowania i tworzy osobny worktree w `../epic-user-profile/`. Od tej chwili stan issues jest stanem projektu.

5. **Uruchom równoległe agenty.** Napisz „start working on issue 1235”. CCPM rozkłada issue na niezależne strumienie pracy, zapisuje `<N>-analysis.md`, uruchamia po jednym agencie na strumień z dostępem do własnych plików i każe każdemu commitować jako `Issue #N: description`. Tu przydają się specjaliści wshobson: z zainstalowanym `full-stack-orchestration` poproś po nazwie o agenta `test-automator` albo `security-auditor` dla strumieni, które ich potrzebują.

6. **Śledź postęp bez wydawania tokenów.** „standup”, „what's blocked” i „what's next” uruchamiają skrypty bash CCPM na `.claude/epics/`, więc raport jest deterministyczny i nie wymaga wywołania modelu.

7. **Merge za bramką.** Napisz „merge the user-profile epic” dopiero wtedy, gdy CI jest zielone, a przegląd z następnej sekcji przeszedł. CCPM uruchamia testy, robi merge i sprząta worktree; „close issue N” aktualizuje jednocześnie lokalny plik i GitHuba.

CCPM uruchamia wszystkie strumienie jednego issue w tym samym worktree i polega na `conflicts_with`, żeby sobie nie wchodziły w drogę. Gdy dwa strumienie muszą ruszać wspólny plik, rozdziel je na osobne issues albo uruchom w osobnych worktree przez `claude --worktree` lub `/worktree` w Codex; kompromisy opisuje strona [równoległe agenty](/pl/ecosystem/agent-tools/parallel-agents/).

## Jak udowodnić jakość pracy równoległych agentów bez czytania każdej linii?

Równoległa praca mnoży ilość kodu, więc ustaw te bramki przed pierwszą synchronizacją:

- **Kryteria akceptacji jako testy.** Kryteria z każdego pliku zadania mają co najmniej jeden test automatyczny, a prompt przeglądu z kroku 3 odrzuca kryteria, których nie da się tak sprawdzić. Zielony przebieg CI na tych testach jest głównym dowodem; „gotowe” od agenta to tylko deklaracja.
- **Wymagane kontrole CI w każdym pull requeście.** Sprawdzanie typów, lint i zestaw testów są wymaganymi statusami w ochronie gałęzi, więc ani agent, ani „merge” z CCPM nie wprowadzi czerwonego kodu.
- **Niezależny recenzent.** Uruchom agenta do przeglądu, który nie pisał kodu: `security-auditor` z wtyczki, `/code-review` w Claude Code albo `/review` w Codex. Ustalenia z kroku 7 w `07-testing.md` liczą się tylko wtedy, gdy krytycznych i wysokich jest zero.
- **Śledzenie pochodzenia.** Prefiksy commitów `Issue #N:`, jedno issue na zadanie i issue epiku w pull requeście dają audytorowi łańcuch PRD → epik → zadanie → issue → commit bez pisania żadnego raportu.
- **Chronione pliki.** Testy, konfiguracja CI i manifesty zależności zmienione przez agenta dostają przez `CODEOWNERS` wskazanego z nazwiska recenzenta; osłabiony test to najczęstszy sposób, w jaki praca równoległa robi się zielona, będąc błędną.
- **Zatwierdzenia z nazwiska.** Tech lead zatwierdza graf zadań (krok 3) i punkt akceptacji 1; właściciel funkcji zatwierdza punkt akceptacji 2 względem kryteriów akceptacji; CI i agent recenzent pilnują merge'a.

Pełny wzorzec pull requesta, który niesie własny dowód, opisuje strona [pakiet dowodów](/pl/workflows/ship/evidence-bundle/), a sam przegląd strona [przegląd pull requestów od agentów](/pl/workflows/ship/agent-pr-review/).

## Ruflo i SuperClaude: kiedy pasuje cięższa albo starsza opcja

Żadne z nich nie jest częścią przepływu zespołu opisanego wyżej: Ruflo zastępuje dużą część harnessu, a SuperClaude powstał przed erą wtyczek.

### Ruflo: meta-harness na poziomie badawczym

Ruflo, dawniej claude-flow (npm publikuje tę samą wersję pod obiema nazwami), nazywa siebie meta-harnessem agentów dla Claude Code i Codex. README opisuje dwie ścieżki instalacji o bardzo różnym zasięgu. Ścieżka wtyczek nie zapisuje w repozytorium żadnych plików; ścieżka CLI zapisuje `.claude/`, `.claude-flow/`, `CLAUDE.md`, skrypty pomocnicze i ustawienia.

| | Ścieżka wtyczek (lite) | Ścieżka CLI (`npx ruflo@latest init`) |
| --- | --- | --- |
| Co dostajesz | Komendy slash i definicje agentów z każdej wtyczki | Pełną pętlę: agenty, komendy, skille, serwer MCP, hooki, demona |
| Nazwy narzędzi MCP | `mcp__plugin_ruflo-core_ruflo__memory_store` | gołe nazwy, np. `memory_store`, `swarm_init` |

**Claude Code**

```text
/plugin marketplace add ruvnet/ruflo
/plugin install ruflo-core@ruflo
/plugin install ruflo-swarm@ruflo
```

**Codex**

```bash
codex plugin marketplace add ruvnet/ruflo
```
Marketplace pokazuje 39 wtyczek `ruflo-*`; instaluj potrzebne przez `codex plugin add <plugin>@ruflo`.

**Cursor**

Ruflo nie dokumentuje instalacji dla Cursora. Użyj ścieżki dla Claude Code albo Codex.

Przykład ścieżki CLI z przewodnika użytkownika projektu:

```bash
# terminal, in a throwaway repository inside a sandbox
npx ruflo@latest init
npx ruflo@latest agent spawn -t coder --name my-coder
npx ruflo@latest hive-mind spawn "Implement user authentication"
npx ruflo@latest agent list
```

Traktuj go jak projekt badawczy: README wspomina o 314 narzędziach MCP, a deklaracje o samouczeniu i przyspieszeniu pochodzą od producenta. Uruchamiaj go w jednorazowym sandboksie bez produkcyjnych poświadczeń (zobacz [uprawnienia i sandboksy](/pl/workflows/harness/permissions-and-sandboxing/)), zmierz sesję przez `/context` przed instalacją i po niej i nie dodawaj go do wspólnej konfiguracji zespołu, dopóki nie przypniesz wersji i nie przejrzysz, co zapisało `init`.

### SuperClaude: menu komend dla Claude Code

SuperClaude instaluje w Claude Code 30 komend `/sc:*` i zestaw person. Nie obsługuje Codex ani Cursora.

```bash
# terminal
pipx install superclaude
superclaude install          # writes the commands to ~/.claude/commands/sc/
superclaude install --list
superclaude doctor
```

W sesji łączysz komendy takie jak `/sc:brainstorm`, `/sc:design`, `/sc:implement` i `/sc:test`, każdą z wolnym tekstem; flagi poszczególnych komend opisuje plik `docs/user-guide/commands.md` projektu.

SuperClaude nie ma wydania w PyPI od wersji 4.3.0 z 2026-03-22, a `/plugin install superclaude` dla v5 jest w README oznaczone jako „not yet available”. To rozsądne gotowe menu dla jednego użytkownika Claude Code; dla zespołu bezpieczniejszym wyborem jest utrzymywana wtyczka z [pakietów dyscypliny](/pl/ecosystem/frameworks/discipline-packs/) albo opisany wyżej orkiestrator.

## Pułapki przy instalacji harnessów wieloagentowych

**Nazwy pakietów, narzędzi i ścieżki, które poradniki podają źle**

- **SuperClaude jest w PyPI, nie w npm.** Pakiet npm `superclaude` to inny projekt (narzędzia do commitów w Git), a `@bifrost_inc/superclaude`, na który wciąż wskazuje odznaka npm w README, zatrzymał się na 4.0.7. Instaluj przez `pipx install superclaude`.
- **Pakiet Task Master to `task-master-ai`.** Pakiet npm `task-master` to niezwiązany pomocnik Grunta, a `claude-task-master` to stara nazwa autora, ostatnio publikowana 2025-03-26. Plik binarny CLI nazywa się `task-master`.
- **`claude-flow` i `ruflo` to ten sam kod.** Stare poradniki z `npx claude-flow@alpha` nadal działają, ale ich nazwy narzędzi MCP (`swarm_init`) nie istnieją na ścieżce wtyczek (`mcp__plugin_ruflo-core_ruflo__swarm_init`). Wybierz jedną ścieżkę na projekt.
- **Komend `/pm:*` z CCPM nie ma już na `main`.** Przetrwały tylko na gałęzi `v1`; obecny skill steruje się prośbami w zwykłym języku.
- **Task Master domyślnie ładuje wszystkie narzędzia.** Bez `TASK_MASTER_TOOLS` ładuje się 36 narzędzi (około 21 000 tokenów według README). Ustaw jawnie `core` albo `standard`.

## Co się psuje, gdy uruchamiasz równoległe agenty z harnessu?

| Objaw | Przyczyna | Naprawa |
| --- | --- | --- |
| Commity dwóch agentów walczą o ten sam plik | Brak `conflicts_with` albo strumienie w jednym worktree | Zatrzymaj oba strumienie, zostaw lepszy commit, dodaj `conflicts_with` do obu zadań i uruchamiaj strumienie po kolei albo w osobnych worktree |
| Orkiestrator pominął punkt akceptacji 1 | W Codex nie załadował się `references/details.md` (limit skilla 8 KB) albo brakuje agentów wtyczki | Poproś agenta o zacytowanie sekcji punktu akceptacji; przeinstaluj wtyczkę; w Codex nazwij agenta w prompcie |
| `sync` utworzył issues, ale bez sub-issues | Brak rozszerzenia `gh-sub-issue` | `gh extension install yahsan2/gh-sub-issue`, potem ponowna synchronizacja; CCPM użył list zadań w treści epiku |
| `sync` kończy się błędem uwierzytelnienia | `gh` nie jest zalogowany albo token nie może tworzyć issues | Uruchom `gh auth status`; użyj fine-grained tokenu ograniczonego do tego repozytorium z uprawnieniem Issues write, a nie tokenu dla całej organizacji |
| Task Master pokazuje `0 tools enabled` | Edytor nie został zrestartowany albo dostawca nie jest skonfigurowany | Zrestartuj edytor; ustaw główny model na `claude-code/sonnet` albo dodaj klucz do `.env` |
| Kontekst jest prawie pełny przed pierwszym promptem | Task Master w trybie `all`, serwer MCP Ruflo albo kilka wtyczek naraz | `/context` w Claude Code; przełącz Task Master na `core`; odinstaluj wtyczki, których w tym tygodniu nie używasz |
| Niedokończone `full-stack-feature` wznawia niewłaściwą funkcję | W drzewie został stary `.full-stack-feature/state.json` | Wybierz **Start fresh**, co archiwizuje starą sesję; po każdej funkcji zacommituj albo usuń ten katalog |
| Komendy Ruflo z poradnika kończą się „unknown tool” | Poradnik napisano dla drugiej ścieżki instalacji | Dopasuj nazwy narzędzi do swojej ścieżki (tabela wyżej) albo zmień ścieżkę |

Gdy równoległe uruchomienie pójdzie źle, najpierw przeczytaj `git log --oneline` na gałęzi epiku. Commity są źródłem prawdy; standup i podsumowania agentów to tylko deklaracje.

## Co dalej z harnessami wieloagentowymi

- [Wzorce orkiestracji wielu agentów](/pl/workflows/automate/orchestration-patterns/) — Fan-out, potoki oraz planista, wykonawcy i sędzia: kiedy który się opłaca.
- [Równoległe agenty](/pl/ecosystem/agent-tools/parallel-agents/) — Menedżery worktree i multipleksery do pracy kilku agentów naraz.
- [Od issue do pull requesta](/pl/workflows/automate/issue-to-pr-pipeline/) — Potok, przez który przechodzi issue, gdy agent je podejmie.
- [Frameworki spec-driven: porównanie](/pl/ecosystem/frameworks/spec-driven-frameworks/) — Spec Kit, OpenSpec i BMAD, gdy samo PRD potrzebuje więcej struktury.
- [Pętle autonomiczne](/pl/ecosystem/frameworks/autonomous-loops/) — GSD Core, pętle Ralph i /goal dla pracy trwającej godzinami.
- [Frameworki pracy z agentami: porównanie](/pl/ecosystem/frameworks/) — Wszystkie frameworki w jednej tabeli, z narzutem procesu i kosztem kontekstu.
