Markdown-Ausgabe

AI-translated from English; not yet reviewed by a fluent editor.

# Mit Superpowers in Claude Code eine Codeänderung planen, testen und prüfen

> Eine dokumentationsbasierte Anleitung, die eine erlaubte Codeänderung durch genehmigten Superpowers-Entwurf und Plan, beobachtete Rot-Grün-Tests, Aufgaben- und Branch-Prüfung bis zur Entscheidung des Verantwortlichen führt.

By BIG CHANGE Editorial

Published: 2026-10-20T10:39:38.153Z
Updated: 2026-10-20T10:39:38.153Z
Canonical: https://bigchange.ai/blog/superpowers-claude-code-plan-test-review-change-guide

![Conceptual charcoal illustration of a long, unlettered code-diff proof sheet emerging from a printer across an inspection table, with a short orange passage.](https://bigchange.ai/api/media/file/superpowers-whole-branch-proof-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Superpowers kann Claude Code Nutzer durch eine größere Änderung in einem eigenen Git-Repository führen: den Entwurf vereinbaren, einen Aufgabenplan genehmigen, mit Tests umsetzen, jede Aufgabe prüfen und den fertigen Branch untersuchen. Diese Anleitung folgt den offiziellen Handbüchern von Superpowers 7.0.0, geprüft am 20. Oktober 2026. BIG CHANGE hat die Dokumentation geprüft; wir haben weder das Plugin installiert noch ein Projekt damit durchgeführt.

## Die große Veränderung

- **Was sich geändert hat:** Ein genehmigter Entwurf und Umsetzungsplan geben den Coding-Agenten eine konkrete Aufgabe und Grenzen, bevor sie das Repository bearbeiten.
- **Warum es wichtig ist:** Der dokumentierte Aufgabenablauf verbindet beobachtete fehlgeschlagene und bestandene Tests mit getrennten Urteilen desselben Prüfers zu Spezifikation und Qualität, gefolgt von einer umfassenderen Prüfung des gesamten Branches.
- **Worauf zu achten ist:** Der Verantwortliche prüft weiterhin den vollständigen Diff und neue Abnahmeergebnisse und entscheidet über den Branch. Ein abgeschlossener Agentenablauf kann offengelegte Befunde behalten.

## Vor dem Beginn

Wählen Sie eine erlaubte mehrstufige Codeänderung in einem eigenen oder zur Bearbeitung freigegebenen Repository. Sie sollte sich in prüfbare Aufgaben aufteilen lassen und testbares Verhalten haben. Notieren Sie gewünschtes Verhalten, betroffenen Bereich, Ausschlüsse, ursprünglichen Abnahmebefehl und Ausgangs-Commit. Führen Sie diesen Befehl und die relevanten vorhandenen Prüfungen vor Arbeitsbeginn aus. Schlägt bereits der Ausgangszustand fehl, klären Sie diesen Fehler jetzt: Ein späteres grünes oder rotes Ergebnis braucht einen bekannten Ausgangspunkt.

Sie benötigen Git, eine authentifizierte Claude Code Installation, die Erlaubnis zur Plugin-Installation und zur Erstellung eines Branches oder Worktrees sowie genug Tarif- oder API-Kapazität für Claude Code und seine Subagenten. Prüfen Sie die Organisationsregeln für Quellcodezugriff und Plugins. Untersuchen Sie Plugin-Inhalt, wirksame Berechtigungen, Datenbedingungen des Anbieters und Ausgabenkontrollen vor der Aktivierung. Anthropic warnt, dass Plugin-Hooks und Serverprozesse mit Ihren Benutzerrechten außerhalb der Sandbox für Werkzeugaufrufe laufen können; gewöhnliche Werkzeugfreigaben decken nicht all diesen Code ab. Halten Sie Geheimnisse, Abhängigkeiten, externe Schreibvorgänge, Pushes und Releases innerhalb Ihrer tatsächlichen Befugnisse. [Die Sicherheitsdokumentation für Claude Code Plugins](https://code.claude.com/docs/en/plugins/security) erklärt diese Grenze.

Der folgende Weg verwendet die Superpowers-Fähigkeit `subagent-driven-development` für eine Änderung mit mehreren Aufgaben. Die Handbücher beschreiben außerdem einen direkten `executing-plans` Weg und erlauben einfachere Entwurfsvereinbarungen für kleine Arbeiten. Wählen Sie den Weg vor der Umsetzung gemeinsam mit dem Verantwortlichen, statt jedem Projekt die gesamte Abfolge vorzuschreiben.

## 1. Plugin installieren und aktive Version prüfen

Geben Sie in einer interaktiven Claude Code Sitzung den [Befehl des offiziellen Marktplatzes](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/README.md) ein:

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

Claude Code öffnet vor der Installation ein Plugin-Detailfenster. Prüfen Sie den Inhalt und wählen Sie einen erlaubten Geltungsbereich. Der lokale Bereich aktiviert es für Sie in diesem Repository; der Projektbereich beeinflusst Repository-Einstellungen von Mitarbeitenden. Lesen Sie Installationsübersicht und Registerkarte Errors. Befolgen Sie die Aktivierungsanweisungen der Sitzung oder starten Sie neu. Prüfen Sie dann Installed und führen Sie `claude plugin list` in einer Shell aus. Notieren Sie die angezeigten Werte Version, Scope und Status und bestätigen Sie, dass die Superpowers-Fähigkeiten in der aktiven Sitzung verfügbar sind. Der Marktplatzbefehl fixiert nicht den Recherche-Commit dieser Anleitung. Weichen installierte Version oder Fähigkeitstext von 7.0.0 ab, gleichen Sie die Vorgehensweise vor dem Fortfahren mit dieser Version ab. Eine fehlgeschlagene oder deaktivierte Installation verlangt einen Stopp und beweist keinen geladenen Ablauf. [Die Installationsanleitung von Claude Code](https://code.claude.com/docs/en/discover-plugins) dokumentiert diese Prüfungen.

## 2. Zuerst den Entwurf, dann den Plan genehmigen

Teilen Sie Claude Code die echte Änderung, Abnahmekriterien, das Ausgangsergebnis und verbotene Bearbeitungen mit. Nutzen Sie den Superpowers-Prozess `brainstorming`, um Absicht, Entwurfsentscheidungen und Grenzen zu klären. Prüfen Sie für diese mehrstufige Änderung den schriftlichen Entwurf und die Befunde des Builder-Checks, klären Sie Eigentümerentscheidungen und genehmigen Sie die vollständige Beschreibung. Die Genehmigung soll das zu bauende Verhalten beschreiben; dass der Agent weiterredet, ist keine Zustimmung. Das [Entwurfshandbuch](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/brainstorming/SKILL.md) erlaubt für kleine Arbeiten eine leichtere Vereinbarung oder einen ausdrücklichen Verzicht. Der vollständige Weg ist hier eine bewusste Wahl für eine umfangreichere Aufgabe.

Bitten Sie anschließend den Prozess `writing-plans`, den Entwurf in Aufgaben zu überführen. Prüfen Sie Dateigrenzen, Schnittstellen, globale Vorgaben, Testbefehle und Review Focus des Plans. Jede Aufgabe muss überschaubar sein und ihr Test das vereinbarte Verhalten messen. Genehmigen Sie Plan und Subagenten-Ausführung, bevor Code geändert wird. [Das Planungshandbuch](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/writing-plans/SKILL.md) definiert die Übergabe. Ein plausibler Plan ist keine Erlaubnis für neue Abhängigkeiten oder Änderungen an unbeteiligten Dateien.

Bei der Ausführung prüft `using-git-worktrees`, ob ein geeigneter Arbeitsbereich existiert, oder erstellt mit erforderlicher Zustimmung einen isolierten. Notieren Sie tatsächlichen Branch, Basis-Commit und sauberen Ausgangszustand. Nutzen Sie, sofern verfügbar, die native Worktree-Unterstützung von Claude Code. Enthält der Arbeitsbereich fremde Änderungen, klären Sie deren Zuständigkeit vor dem Fortfahren. [Das Worktree-Handbuch](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/using-git-worktrees/SKILL.md) beschreibt Prüfung und Erstellung.

## 3. Jeden Test und jede Aufgabenprüfung beobachten

Verwenden Sie mit dem genehmigten Plan `subagent-driven-development` für unabhängig prüfbare Aufgaben. Das aktuelle Handbuch weist einer Aufgabe einen Umsetzer zu und reicht dann Umsetzung und Diff an **einen einzigen Aufgabenprüfer** weiter. Dieser liefert zwei Urteile: Entspricht die Aufgabe der Spezifikation und ist die Umsetzungsqualität akzeptabel? Das sind zwei Urteile einer Prüfung, keine zwei aufeinanderfolgenden Prüfer-Agenten. Kleine gleichartige Aufgaben dürfen nach den Handbuchregeln gebündelt werden. [Der Aufgabenablauf](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/subagent-driven-development/SKILL.md) und der [Prüfer-Prompt](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/subagent-driven-development/task-reviewer-prompt.md) legen diese Abfolge fest.

Verlangen Sie für jedes geeignete Verhalten einen beobachtbaren Rot-Grün-Zyklus: Verhaltenstest hinzufügen, ausführen und den erwarteten Fehler sehen; die kleinste Umsetzung erstellen, erneut testen und Bestehen beobachten; anschließend bei weiterhin grünen Prüfungen refaktorieren. Ein Importfehler oder defektes Testgerüst ist nicht das erwartete rote Ergebnis. Bewahren Sie Befehl, Ausgabe und relevanten Commit oder Diff jeder Aufgabe auf. Das [Handbuch für testgetriebene Entwicklung](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/test-driven-development/SKILL.md) beschreibt Ausnahmen, die menschliche Zustimmung brauchen. Diese Anleitung setzt eine Aufgabe voraus, die zum üblichen testorientierten Weg passt.

Lesen Sie beide Prüfurteile und den echten Diff. Klären Sie jeden Punkt „aus dem Diff nicht prüfbar“ anhand von Plan und Repository vor der Annahme. Untersuchen Sie Korrekturen und deren begrenzte Nachprüfung; eine neue Erfolgsaussage ist kein frisches Testergebnis. Der Ablauf 7.0.0 begrenzt die Reparaturschleife und kann Befunde mit schriftlichen Entscheidungen zurückstellen. Bewahren Sie diese für die spätere Prüfung auf. Eine als erledigt markierte Aufgabe hat nicht zwangsläufig eine mängelfreie Prüfung.

Wenn die Aufgaben erledigt sind, untersuchen Sie die **gesonderte Prüfung des gesamten Branches**. Sie kann Wechselwirkungen zwischen Aufgaben erkennen und zurückgestellte Befunde erneut prüfen, die anhand eines einzelnen Diffs nicht entscheidbar waren. Fordern Sie Nachweise und Entscheidungen zu jedem offenen Punkt. Sichern Sie Entwurf, Plan, Testausgaben, Prüfberichte und vollständigen Diff vor dem Aufräumen des temporären Plugin-Arbeitsbereichs. Wurde eine erwartete Fähigkeit nicht ausgelöst, prüfen Sie Plugin-Status, Version und dokumentierten Diagnoseweg; eine Installation beweist keinen erzwungenen Ablauf.

## 4. Branch prüfen und über seinen Verbleib entscheiden

Führen Sie den ursprünglichen Abnahmebefehl auf dem endgültigen Code erneut aus, zusammen mit der vollständigen Testsuite des Projekts. Prüfen Sie neue Ausgaben, den gesamten Branch-Diff und alle offenen Befunde. [Das Verifikationshandbuch von Superpowers](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/verification-before-completion/SKILL.md) verlangt Belege aus dem aktuellen Zustand vor einer Fertigmeldung. Schlägt die Suite fehl, bestimmen Sie den genauen Fehler und beheben ihn oder lassen den Branch zur Prüfung liegen. Mit fehlschlagender Suite wird das dokumentierte Abschlussmenü nicht erreicht.

Auf einem benannten Branch bietet `finishing-a-development-branch` lokales Zusammenführen, Push mit Erstellung einer Pull Request oder unverändertes Behalten des Branches an. Ein abgelöster HEAD bietet Pull Request und Behalten. Verwerfen wird nur nach ausdrücklichem Auftrag des Verantwortlichen und eingetippter Bestätigung bearbeitet; es ist keine gewöhnliche vierte Option. [Das Handbuch zum Branch-Abschluss](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/finishing-a-development-branch/SKILL.md) erläutert diese Möglichkeiten. Zeigen Sie dem Verantwortlichen Prüfungen, Diff und verbleibende Befunde vor seiner Entscheidung. Merge, Push, Löschung oder Release brauchen jeweils die passende Befugnis.

Das nützliche Ergebnis ist ein prüfbarer Branch zum ursprünglichen Bedarf: genehmigter Entwurf und Plan, beobachtete Testergebnisse, beide Aufgabenurteile, Prüfung des gesamten Branches, vollständiger Diff und frisches Abnahmeergebnis. Stoppen Installation, Zugriff, Budget oder eine Prüfung die Ausführung, bewahren Sie verifizierte Artefakte und nennen Sie den letzten abgeschlossenen Schritt. Die Dokumentation beschreibt einen Prozess; sie beweist nicht, dass die nicht ausgeführte Änderung dieser Anleitung schneller, günstiger oder fehlerärmer war.

## Quellen und weiterführende Lektüre

- [Superpowers 7.0.0: README und Installation](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/README.md): offizieller Projektweg und Beschreibung des Ablaufs. Belegt weder installierte Version noch Ergebnisse eines Lesers.
- [Superpowers-Handbuch zur Aufgabenausführung](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/subagent-driven-development/SKILL.md): Aufgabenprüfer, zwei Urteile, Reparaturentscheidungen und abschließende Branch-Prüfung. Zusammen mit der tatsächlich installierten Version lesen.
- [Claude Code Plugin-Installation](https://code.claude.com/docs/en/discover-plugins) und [Sicherheit](https://code.claude.com/docs/en/plugins/security): Geltungsbereich, Aktivierung, Versionskontrolle und Ausführungsrechte. Organisationskontrollen können Verfügbarkeit ändern.

Für die Reparatur einer einzelnen Abnahmeprüfung siehe die [BIG CHANGE-Anleitung zur Verifikation einer fehlschlagenden Repository-Prüfung](https://bigchange.ai/blog/ai-goal-failing-repository-check-guide). Der hiesige Prozess beginnt früher, mit Entwurf und Plan einer mehrteiligen Änderung.

## Sources

- [Superpowers-README für Version 7.0.0](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/README.md) — Offizieller Marktplatzbefehl und allgemeiner Projektablauf. Eine feste Referenz, kein Beweis für die Installation exakt dieses Commits oder einen durchgeführten Ablauf.
- [Superpowers-Fähigkeit brainstorming](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/brainstorming/SKILL.md) — Dokumentiert Entwurfsfragen, Builder-Check und menschliche Freigabe; kleine Aufgaben dürfen einen leichteren Weg nehmen.
- [Superpowers-Fähigkeit writing-plans](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/writing-plans/SKILL.md) — Dokumentiert Planstruktur und Prüfungsübergabe. Bedeutet nicht, dass für ein nicht ausgeführtes Projekt bereits ein Plan genehmigt wurde.
- [Superpowers-Fähigkeit using-git-worktrees](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/using-git-worktrees/SKILL.md) — Dokumentiert Auswahl eines vorhandenen oder isolierten Arbeitsbereichs, Zustimmung und Ausgangsprüfungen. Für diesen Artikel wurde kein Worktree angelegt.
- [Superpowers-Fähigkeit subagent-driven-development und Aufgabenprüfer](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/subagent-driven-development/SKILL.md) — Legt einen Aufgabenprüfer mit Spezifikations- und Qualitätsurteilen, begrenzte Reparaturschleifen, zurückgestellte Befunde und eine gesonderte Gesamtprüfung des Branches fest. Abschluss kann entschiedene, aber ungelöste Punkte einschließen.
- [Superpowers-Fähigkeit test-driven-development](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/test-driven-development/SKILL.md) — Dokumentiert erwartetes Rot-Grün-Refaktorieren und menschlich vereinbarte Ausnahmen. Für diesen Artikel wurde kein Test ausgeführt.
- [Superpowers-Fähigkeit verification-before-completion](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/verification-before-completion/SKILL.md) — Verlangt frische tatsächliche Befehlsnachweise für Fertigmeldungen; kann die Ergebnisse dieser Anleitung nicht belegen.
- [Superpowers-Fähigkeit finishing-a-development-branch](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/finishing-a-development-branch/SKILL.md) — Dokumentiert Optionen für benannte und abgelöste Branches sowie gesondert angefordertes, eingetippt bestätigtes Verwerfen. Die Befugnis des Verantwortlichen bleibt nötig.
- [Plugins installieren und verwalten — Claude Code Docs](https://code.claude.com/docs/en/discover-plugins) — Aktuelles Installationsfenster, Geltungsbereiche, Aktivierung, Installed-Registerkarte und CLI-Prüfung von Version, Scope und Status. Lokale Richtlinien können die tatsächliche Verfügbarkeit ändern.
- [Plugin-Sicherheit — Claude Code Docs](https://code.claude.com/docs/en/plugins/security) — Erklärt, dass Plugin-Hooks und Serverprozesse mit Benutzerrechten außerhalb der Sandbox-Abfragen für Modell-Werkzeugaufrufe laufen können. Nutzer müssen den lokalen Zugriff prüfen.