| name | executing-plans |
| description | Fuehrt einen bestehenden Implementierungsplan Schritt fuer Schritt aus. Jeder Schritt wird einzeln implementiert, gebaut und getestet. Trigger: "execute plan", "plan ausfuehren", "implement plan", "plan umsetzen", "schritte ausfuehren", "plan abarbeiten"
|
| version | 0.1.0 |
Executing Plans — Plaene ausfuehren
Fuehrt einen bestehenden Implementierungsplan (REQUIREMENTS/PLAN/plan-*.md) Schritt fuer
Schritt aus. Jeder Schritt wird einzeln implementiert, gebaut und getestet bevor zum
naechsten gewechselt wird.
1. Vorbereitung
- Lies den referenzierten Plan vollstaendig
- Lies das zugehoerige Design-Dokument (falls referenziert)
- Lies
CLAUDE.md fuer Projekt-Konventionen
- Pruefe die Voraussetzungen aus dem Plan
- Erstelle eine TaskList mit allen Schritten aus dem Plan
2. Ausfuehrungs-Regeln
2.1 Ein Schritt nach dem anderen
- Arbeite jeden Schritt einzeln ab
- Markiere den aktuellen Schritt als
in_progress in der TaskList
- Wechsle erst zum naechsten Schritt wenn der aktuelle vollstaendig verifiziert ist
- Markiere abgeschlossene Schritte als
completed
2.2 Verifikation nach jedem Schritt
Nach jedem Schritt ausfuehren (im jeweiligen Package-Verzeichnis):
cd xhubioTable/<package>
npm run build
npm run test
Wenn der Build fehlschlaegt:
- Fehler analysieren (TypeScript-Fehler, Lint-Fehler, Format-Fehler)
- Fehler beheben
- Erneut bauen
- Erst nach erfolgreichem Build zum naechsten Schritt
Wenn Tests fehlschlagen:
- Test-Output analysieren
- Ist es ein echter Bug oder ein Test-Problem?
- Bug fixen oder Test anpassen
- Erneut testen
- Erst nach gruenen Tests zum naechsten Schritt
2.3 Abweichungen vom Plan
Wenn waehrend der Ausfuehrung klar wird, dass der Plan angepasst werden muss:
- Kleine Anpassung: Notiere die Abweichung und mache weiter
- Grosse Abweichung: Stoppe und besprich mit dem User
- Neuer Schritt noetig: Fuege ihn in die TaskList ein
- Schritt unnoetig: Markiere als
deleted mit Begruendung
2.4 Parallelisierung
Wenn der Plan parallele Schritte vorsieht:
- Nutze Sub-Agents (Task Tool) fuer parallele Ausfuehrung
- Maximal 6 Sub-Agents gleichzeitig
- Jeder Sub-Agent bearbeitet genau einen Schritt
- Warte auf Abschluss aller parallelen Schritte bevor abhaengige Schritte starten
- Siehe
dispatching-parallel-agents Skill fuer Details
3. TDD-Integration
Wenn der Plan Tests vorsieht, folge dem TDD-Zyklus:
- Red: Test schreiben der fehlschlaegt
- Green: Minimale Implementation die den Test bestehen laesst
- Refactor: Code aufraeumen ohne Verhalten zu aendern
Siehe test-driven-development Skill fuer Details.
4. Nach Abschluss aller Schritte
4.1 Gesamt-Verifikation
Fuehre die Gesamt-Verifikation aus dem Plan aus:
cd xhubioTable/<package-1> && npm run test
cd xhubioTable/<package-2> && npm run test
4.2 Plan-Status aktualisieren
Aktualisiere den Status im Plan-Dokument:
## Status auf ABGESCHLOSSEN setzen- Datum hinzufuegen
- Etwaige Abweichungen dokumentieren
4.3 Abschluss-Pruefung
Fuehre den verification-before-completion Skill aus:
- Alle Builds gruen?
- Alle Tests gruen?
- Keine unbeabsichtigten Aenderungen?
5. Fehlerbehandlung
| Situation | Vorgehen |
|---|
| Build-Fehler | Fehler fixen, erneut bauen |
| Test-Fehler | Analysieren: Bug oder Test-Problem? Fixen. |
| Dependency-Fehler | npm install ausfuehren, ggf. Package-Version pruefen |
| Type-Fehler in abhaengigem Package | Zuerst das Basis-Package fixen, dann npm run build, dann abhaengiges Package |
| Plan-Schritt unklar | User fragen, nicht raten |
| Unerwartete Seiteneffekte | Stoppen, analysieren, mit User besprechen |
6. Regeln
- Kein Schritt ueberspringen: Auch wenn ein Schritt trivial erscheint
- Immer verifizieren: Build + Test nach jedem Schritt
- Monorepo-Kontext: Commands im jeweiligen Package-Verzeichnis ausfuehren
- Keine eigenmaechtigen Erweiterungen: Nur das implementieren was im Plan steht
- Bei Zweifeln fragen: Lieber einmal zu viel fragen als falsch implementieren
