executing-plans

Überblick

Was das executing-plans Skill macht

Das executing-plans Skill ist für Situationen gedacht, in denen du bereits einen schriftlichen Implementierungsplan hast und ein Agent diesen planvoll und methodisch umsetzen soll. Der Fokus liegt auf:

• Laden eines konkreten, schrittweisen Plans aus deinem Projekt
• Kritischer Durchsicht des Plans, bevor irgendwelche Arbeiten starten
• Ausführung der Aufgaben nacheinander mit klaren Statuswechseln
• Durchführen von Verifikationen und Tests, wie im Plan beschrieben
• Übergabe an einen abschließenden Workflow, sobald die Entwicklung abgeschlossen ist

Zu Beginn einer Session sollte der Agent ankündigen:

"I'm using the executing-plans skill to implement this plan."

Damit ist klar, dass der Agent sich im Modus der strukturierten Ausführung befindet – nicht im freien Brainstorming oder in der Planungsphase.

Für wen dieses Skill gedacht ist

Dieses Skill eignet sich besonders für:

• Entwickler, die gerne das Design vorab erledigen und dann einen Agenten einen detaillierten Plan ausführen lassen
• Teams, die GitHub nutzen und pro Feature oder Branch einen schriftlichen Implementierungsplan pflegen
• Agent-Operator, die in Umgebungen wie Claude Code oder Codex mit vorhersehbaren, wiederholbaren Ausführungs-Workflows arbeiten wollen
• Projekt-Maintainer, die eine konsequente Einhaltung eines Plans mit expliziten Checkpoints und Verifikationsschritten erwarten

Besonders hilfreich ist das Skill, wenn dein Plan bereits in kleine, gut abgrenzbare Schritte zerlegt ist und klare Verifikations- oder Testanforderungen enthält.

Welche Probleme executing-plans löst

Das executing-plans Skill hilft dir dabei:

• Ad-hoc- und abdriftende Implementierung zu vermeiden, indem die Arbeit klar an einem vorab genehmigten Plan ausgerichtet wird
• Probleme früh zu erkennen, indem der Plan kritisch geprüft wird, bevor Code geändert wird
• Fortschritt Task für Task zu verfolgen, indem Arbeit als in_progress und anschließend als completed markiert wird
• Sicherzustellen, dass die im Plan beschriebenen Verifikationen und Tests tatsächlich ausgeführt werden
• Die Arbeit sauber an ein Finishing-Skill zu übergeben, das finale Testverifikation und Entscheidungen übernimmt

Durch die Standardisierung der Plan-Ausführung reduziert das Skill Misskommunikation und erleichtert die planbare Zusammenarbeit zwischen Menschen und Agenten bei Entwicklungsarbeit.

Wann dieses Skill geeignet ist – und wann nicht

Nutze executing-plans, wenn:

• du bereits einen schriftlichen Implementierungsplan hast
• der Plan in Tasks oder Schritte sequenziert ist
• du möchtest, dass sich der Agent hauptsächlich auf die Ausführung konzentriert, nicht auf die Lösungsarchitektur
• du Checkpoints möchtest, an denen der Agent um Hilfe fragt, wenn etwas unklar ist oder Blocker auftreten

Greife besser zu einem anderen Skill oder Workflow, wenn:

• du Hilfe beim Erstellen eines Plans von Grund auf brauchst (dieses Skill setzt einen existierenden Plan voraus)
• der Plan extrem vage ist oder wichtige Details fehlen
• deine Plattform umfangreiche Subagent-Unterstützung bietet (z. B. Claude Code, Codex) und du eine anspruchsvollere Orchestrierung möchtest – in diesem Fall empfiehlt das Repository stattdessen superpowers:subagent-driven-development
• du dich noch nicht auf eine konkrete Implementierungsstrategie festlegen willst und weiterhin Optionen erkunden möchtest

Das Repository legt außerdem fest, dass du nach Ausführung aller Tasks zur benötigten Sub-Skill superpowers:finishing-a-development-branch wechseln solltest, um die Arbeit abzuschließen.

Verwendung

Installation und Setup

1. executing-plans Skill installieren

Installiere das Skill aus dem obra/superpowers Repository:

npx skills add https://github.com/obra/superpowers --skill executing-plans

Damit wird der executing-plans Workflow in deiner Agent-Umgebung verfügbar.

2. Deinen Implementierungsplan vorbereiten

Bevor du das Skill aufrufst, stelle sicher, dass in deinem Projekt ein schriftlicher Implementierungsplan vorhanden ist. Der Plan sollte idealerweise:

• in einer Datei liegen, die dein Agent lesen kann (z. B. in deinem Repo)
• in einzelne Tasks oder kleine Schritte aufgeteilt sein
• für jede Aufgabe die nötigen Verification- oder Testing-Anweisungen enthalten

Je höher die Qualität und Klarheit dieses Plans, desto zuverlässiger wird der executing-plans Workflow funktionieren.

Kern-Workflow: vom Plan zur Ausführung

Schritt 1: Plan laden und prüfen

Wenn du eine Session mit executing-plans startest, sollte der Agent:

1. die Plan-Datei aus deinem Projekt lesen
2. den Plan kritisch prüfen und dabei achten auf:
   • fehlende Informationen oder unklare Anweisungen
   • Konflikte oder Widersprüche zwischen den Schritten
   • unrealistische Annahmen oder Voraussetzungen, die möglicherweise nicht erfüllt sind
3. Wenn der Agent Bedenken feststellt, sollte er diese vor Beginn der Ausführung mit dir klären
4. Wenn keine Bedenken bestehen, sollte der Agent seine interne To-do-Struktur (z. B. TodoWrite) anlegen und sich auf die Ausführung vorbereiten

Dieser Review-Schritt ist entscheidend. Er verhindert, dass der Agent einem fehlerhaften Plan blind folgt, und fördert frühzeitige Klärung.

Schritt 2: Tasks mit Status-Tracking ausführen

Für jede Aufgabe im Plan erwartet das executing-plans Skill folgendes Muster:

1. Die Aufgabe als in_progress markieren, damit laufende Arbeiten nachvollziehbar sind
2. Jeden Schritt exakt so befolgen, wie er im Plan steht
   • Der Plan wird als Sammlung kleiner, konkreter Schritte vorausgesetzt
   • Der Agent sollte nur dann improvisieren, wenn der Plan eindeutig unzureichend ist
3. Verifikationen wie angegeben ausführen
   • Dazu können Tests, Linter oder manuelle Checks gehören, die im Plan beschrieben sind
4. Die Aufgabe als completed markieren, sobald alle Arbeiten und Verifikationen für den Task abgeschlossen sind

Diese Struktur erleichtert es Menschen, den Fortschritt zu beobachten, und hilft dem Agenten, keine Validierungsschritte zu überspringen.

Schritt 3: Entwicklung mit einem Finishing-Skill abschließen

Sobald alle Aufgaben im Plan ausgeführt und verifiziert sind:

• sollte der Agent ankündigen:

  "I'm using the finishing-a-development-branch skill to complete this work."

• anschließend die erforderliche Sub-Skill verwenden: superpowers:finishing-a-development-branch

• diesem Finishing-Skill folgen, um:

  • Tests bei Bedarf erneut auszuführen oder zu verifizieren
  • Optionen oder finale Ergebnisse zu präsentieren (z. B. Branch-Status oder nächste Schritte)
  • die gewählten Abschlussaktionen umzusetzen

Executing-plans ist damit vor allem als mittlerer Abschnitt deiner Entwicklungspipeline zu verstehen: Es führt von einem schriftlichen Plan zu implementierten Änderungen und übergibt dann an einen dedizierten Finishing-Workflow.

Umgang mit Blockern und Unsicherheit

Wann stoppen und um Hilfe bitten

Gemäß Skill-Definition muss der Agent die Ausführung sofort stoppen und um Unterstützung bitten, wenn:

• er auf einen Blocker stößt, etwa:
  • fehlende Dependencies oder Tools
  • Tests, die auf unerwartete Weise fehlschlagen
  • Anweisungen, die mit dem verfügbaren Kontext nicht umsetzbar sind
• der Plan kritische Lücken hat, die verhindern, dass die Arbeit beginnen oder fortgesetzt werden kann
• der Agent Teile des Plans nicht gut genug versteht, um sicher fortzufahren

In diesen Fällen sollte die Session von der Ausführung in einen Klärungsmodus wechseln, in dem der Agent erklärt, was den Fortschritt blockiert und was er von dir benötigt.

Best Practices für die Nutzung von executing-plans

Um das Maximum aus dem executing-plans Skill herauszuholen:

• schreibe Pläne, die konkret und sequenziert sind, mit einem klaren Ergebnis pro Task
• füge für jede wesentliche Änderung Verification-Anweisungen hinzu
• ermutige den Agenten, Bedenken aus dem Initial-Review zu bündeln und zu schildern, statt still zu raten
• nutze das finishing-a-development-branch Skill konsequent nach der Ausführung, damit dein Gesamt-Workflow vorhersehbar bleibt

FAQ

Was ist das executing-plans Skill in einfachen Worten?

Das executing-plans Skill ist ein strukturierter Workflow, mit dem Agenten einen vorab geschriebenen Implementierungsplan laden, prüfen und ausführen. Es führt Aufgaben Schritt für Schritt durch, startet definierte Verifikationen und übergibt anschließend an ein Finishing-Skill, sobald die Entwicklung abgeschlossen ist.

Wie installiere ich das executing-plans Skill?

Du kannst es aus dem obra/superpowers Repository installieren mit:

npx skills add https://github.com/obra/superpowers --skill executing-plans

Nach der Installation solltest du deinen Agenten bzw. deine Umgebung so konfigurieren, dass er deine Plan-Datei lesen und executing-plans für passende Sessions aufrufen kann.

Brauche ich Subagents, um executing-plans zu nutzen?

Nein. Das executing-plans Skill ist so konzipiert, dass es auch ohne Subagent-Unterstützung funktioniert. Das Repository weist jedoch darauf hin, dass Superpowers mit Subagents noch besser arbeitet. Wenn deine Plattform Subagents unterstützt (z. B. Claude Code oder Codex), solltest du für eine umfangreichere Orchestrierung statt executing-plans eher superpowers:subagent-driven-development in Betracht ziehen.

Wann sollte ich executing-plans einem subagent-driven development vorziehen?

Nutze executing-plans, wenn:

• deine Umgebung nur eingeschränkte oder keine Subagent-Unterstützung hat
• du einen einfachen, linearen Ablauf zur Ausführung eines bestehenden Plans bevorzugst
• du Wert auf einen klaren Review → Execute → Finish-Flow ohne komplexe Agent-Orchestrierung legst

Wenn du Multi-Agent-Zusammenarbeit, dynamische Task-Zerlegung oder stärker autonome Entscheidungen benötigst, ist superpowers:subagent-driven-development die empfohlene Alternative.

Welche Art von Plan funktioniert am besten mit executing-plans?

Executing-plans funktioniert am besten mit Plänen, die:

• schriftlich in einer Datei vorliegen, auf die dein Agent zugreifen kann
• in kleine, geordnete Tasks aufgeteilt sind
• klare Erwartungen, Eingaben und Ausgaben formulieren
• explizite Verification- oder Testing-Schritte nach jeder Änderung enthalten

Sehr grobe oder vage Pläne führen eher zu häufigen Klärungsrunden und blockieren die Ausführung.

Wie geht executing-plans mit Tests und Verifikationen um?

Das Skill erwartet, dass im Plan beschrieben ist, welche Tests oder Verifikationen auszuführen sind. Für jeden Task sollte der Agent:

• die beschriebenen Code- oder Konfigurationsänderungen vornehmen
• die im Plan genannten Tests, Checks oder Commands ausführen
• die Aufgabe erst dann als completed markieren, wenn diese Verifikationen erfolgreich waren oder nach Rücksprache mit dir eingeordnet wurden

So wird das Ausführen von Tests integraler Bestandteil des Workflows – nicht ein nachgelagerter Schritt.

Was passiert, wenn alle Tasks erledigt sind?

Sobald alle Tasks ausgeführt und erfolgreich verifiziert wurden, übergibt executing-plans an den finishing-a-development-branch Workflow:

• der Agent kündigt an, dass er zum Finishing-Skill wechselt
• er verwendet superpowers:finishing-a-development-branch als erforderliche Sub-Skill
• dieses Skill übernimmt dann letzte Checks, präsentiert Optionen und führt deine gewählten Abschlussaktionen aus

Diese Trennung macht Ausführung und Finalisierung klarer und leichter nachvollziehbar.

Was passiert, wenn sich der Plan als falsch herausstellt?

Wenn der Agent feststellt, dass die Befolgung des Plans zu falschem Verhalten führen würde oder so, wie er geschrieben ist, nicht zum Erfolg kommen kann, sollte er:

1. die weitere Ausführung stoppen
2. transparent erläutern, was genau am Plan problematisch ist
3. dich fragen, ob der Plan aktualisiert, ein neuer Plan erstellt oder auf einen anderen Workflow gewechselt werden soll

Executing-plans behandelt den Plan als maßgebliche Quelle. Wenn diese Annahme nicht mehr trägt, ist menschliche Prüfung erforderlich.

Ist executing-plans nur für Code-Änderungen gedacht?

Das Skill ist in erster Linie auf Entwicklungsarbeit (Code und verwandte Aufgaben) ausgerichtet. Das Grundmuster – Plan laden, prüfen, Tasks ausführen, Verifikationen laufen lassen – lässt sich jedoch auch auf andere klar spezifizierte Projekt-Workflows übertragen. Am besten funktioniert es dort, wo sich klar definierte Tasks und objektive Erfolgskriterien formulieren lassen.

Wie kann ich beurteilen, ob executing-plans für mein Projekt gut funktioniert?

Achte auf folgende Anzeichen:

• Tasks aus deinem Plan werden konsequent mit den Stati in_progress und completed versehen und bleiben nachvollziehbar
• der Agent führt regelmäßig die von dir spezifizierten Verifikationen aus und berichtet deren Ergebnisse
• du wirst frühzeitig informiert, wenn der Plan unklar ist oder Blocker auftreten
• die Übergabe an finishing-a-development-branch läuft flüssig und vorhersehbar

Wenn diese Bedingungen erfüllt sind, ist executing-plans sehr wahrscheinlich eine gute Ergänzung für das Projektmanagement und die Workflow-Automatisierung in deinem Team.