====== Superpowers – Skills framework pro coding agenty ======

Superpowers je open-source balíček dovedností (skills) pro AI coding agenty. Nejde o standalone nástroj — jde o vrstvu nad agenty jako Claude Code, OpenCode, Cursor nebo Gemini CLI, která jim dává strukturovaný workflow místo ad-hoc přístupu. https://github.com/obra/superpowers

===== Co to je a proč mě to zaujalo =====

Myšlenka je jednoduchá: agent dostane sadu skills, které ho vedou strukturovanými fázemi vývoje — od upřesňování požadavků přes plánování, implementaci až po review a dokončení větve. Bez toho si agent sám vymýšlí, jak postupovat. Se Superpowers agenti pracují disciplinovaně:

  * Před kódováním se ptají na požadavky a upřesňují zadání.
  * Dekomponují práci na úlohy o délce 2–5 minut.
  * Spouštějí subagenty per úloha s dvoustupňovým review.
  * Vynucují RED-GREEN-REFACTOR cyklus u testů.
  * Ověřují výsledky před tvrzením „hotovo".

===== Podporované platformy =====

  * **Claude Code** – instalace z oficiálního marketplace nebo vlastního marketplace
  * **Cursor** – plugin marketplace
  * **OpenCode** – manuální instalace přes instrukci agentovi
  * **Codex** – manuální instalace přes instrukci agentovi
  * **Gemini CLI** – přes ''gemini extensions install''

===== Instalace =====

==== Claude Code (oficiální marketplace) ====

<code>
/plugin install superpowers@claude-plugins-official
</code>

==== Claude Code (alternativní marketplace) ====

<code>
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
</code>

==== OpenCode ====

Stačí agentovi zadat instrukci:

<code>
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
</code>

==== Gemini CLI ====

<code>
gemini extensions install https://github.com/obra/superpowers
gemini extensions update superpowers
</code>

==== Codex ====

<code>
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md
</code>

===== Přehled dostupných skills =====

==== Testování a kvalita ====

  * **Test-driven development** – RED-GREEN-REFACTOR metodologie; agent píše testy před implementací

==== Debugging ====

  * **Systematic debugging** – 4fázová analýza kořenové příčiny
  * **Verification before completion** – agent ověří výsledky před tvrzením „hotovo"

==== Plánování a spolupráce ====

  * **Brainstorming** – sokratovské upřesňování požadavků před implementací
  * **Writing plans / Executing plans** – dekompozice práce na malé úlohy a jejich řízené plnění
  * **Dispatching parallel agents** – rozesílání nezávislých úloh na subagenty paralelně
  * **Code review (requesting / receiving)** – strukturované review workflow

==== Git a větvení ====

  * **Git worktrees** – izolované pracovní větve s ověřenými výchozími stavy
  * **Branch finishing** – rozhodování o mergování, PR a cleanup po dokončení práce
  * **Subagent-driven development** – orchestrace subagentů při plnění implementačního plánu

==== Rozšiřitelnost ====

  * **Writing skills** – tvorba vlastních skills podle standardů frameworku

===== Filosofie =====

Superpowers staví na principech: testy se píší vždy jako první, systematický postup je nadřazený ad-hoc přístupu, jednoduchost je primárním designovým cílem a výsledky se ověřují důkazy, ne tvrzeními. Cílem je, aby agent mohl pracovat autonomně hodiny najednou bez odchylky od plánu.