Spec-Lebenszyklus-Tools (Stream B)
Stream B enthält alle Tools, die den vollständigen Spec-Lebenszyklus verwalten — von der ersten Klärungsfrage bis zur Übergabe einer produktionsreifen Spec an einen KI-Agenten.
Schnellreferenz
| Tool | Beschreibung | Verfügbarkeit |
|---|---|---|
facilitate | Einstiegspunkt ohne Vorkenntnisse — beschreibe, was du bauen möchtest | Enthalten |
clarify_requirements | Anforderungen interaktiv klären, bevor eine Spec erstellt wird | Enthalten |
elicit_requirements | Erweiterte interaktive Anforderungserhebung | Enthalten |
create_spec | Eine vollständige SDD-Spec aus einer Beschreibung erstellen | Enthalten |
list_specs | Alle Specs in einem Projekt auflisten, nach Status filtern | Enthalten |
update_status | Eine Spec durch ihre Lebenszyklusstadien führen | Enthalten |
summarize_spec | Eine kurze, lesbare Zusammenfassung einer Spec generieren | Enthalten |
spec_history | Den Änderungsverlauf einer Spec anzeigen | Enthalten |
reconcile_spec | Eine Spec an das tatsächlich Gebaute anpassen | Enthalten |
branch_spec | Einen Spec-Branch für Experimente erstellen | Enthalten |
merge_spec_branch | Einen experimentellen Spec-Branch zurück in die Haupt-Spec zusammenführen | Enthalten |
version_spec | Einen getaggten Versions-Snapshot einer Spec erstellen | Enthalten |
spec_diff | Zwei Spec-Versionen vergleichen und Unterschiede anzeigen | Enthalten |
export_spec | Eine Spec in ein externes Format (spec-kit) exportieren | Enthalten |
check_readiness | Prüfen, ob eine Spec genug Detail hat, um mit dem Bauen zu beginnen | Enthalten |
challenge_spec | Eine Spec durch Simulation von Ausfällen und Randfällen belasten | Enthalten |
red_team | Gegnerische Überprüfung — argumentiert von Grund auf gegen die Spec | Enthalten |
detect_contradictions | Widersprüche und Inkonsistenzen innerhalb oder zwischen Specs erkennen | Enthalten |
manage_scope | Scope verwalten und kontrollieren, um Scope-Creep zu verhindern | Enthalten |
package_handoff | Eine Spec und ihre Abhängigkeiten für die Übergabe an Agenten oder Teams paketieren | Enthalten |
decompose_spec | Eine Spec automatisch in unabhängige Agenten-Tasks zerlegen | Enthalten |
analyze_spec_dependencies | Abhängigkeitsgraph analysieren: kritischer Pfad, zirkuläre Abhängigkeiten, Wellen | Enthalten |
generate_checklist | Eine Implementierungscheckliste aus einer Spec generieren | Enthalten |
check_spec_accuracy | Eine Spec gegen die tatsächliche Codebasis-Implementierung validieren | Enthalten |
spec_coverage | Einen Abdeckungsbericht generieren, der Specs vs. Implementierung zeigt | Enthalten |
spec_usage_report | Bericht, der zeigt, welche Specs Agenten aktiv nutzen | Enthalten |
semantic_search | Specs und Projektwissen nach Bedeutung durchsuchen | Enthalten |
list_templates | Den integrierten und benutzerdefinierten Spec-Template-Katalog durchsuchen | Enthalten |
apply_template | Spec-Dateien aus einem Spec-Template erstellen | Enthalten |
capture_idea | Eine leichtgewichtige Idee erfassen, ohne eine vollständige Spec zu erstellen | Enthalten |
list_backlog | Alle erfassten Ideen im Projekt-Backlog auflisten | Enthalten |
promote_idea | Eine Backlog-Idee zu einer vollständigen Spec aufwerten | Enthalten |
discard_idea | Eine Backlog-Idee als verworfen markieren | Enthalten |
session_checkpoint | Einen Sitzungs-Checkpoint mit aktuellem Kontext speichern | Enthalten |
planu_status | Einen kompakten Weltschnappschuss des aktuellen Projektstatus erhalten | Enthalten |
log_lesson | Eine gelernte Lektion aus einer Spec oder Projekterfahrung protokollieren | Enthalten |
list_lessons | Gelernte Lektionen für ein Projekt auflisten | Enthalten |
delete_spec | Eine oder mehrere Specs aus einem Projekt löschen | Enthalten |
delete_project | Alle Daten für ein Projekt löschen | Enthalten |
delete_pattern | Ein oder mehrere erlernte Muster löschen | Enthalten |
delete_decision | Eine oder mehrere Entscheidungen/ADRs löschen | Enthalten |
manage_trash | Den Papierkorb verwalten: auflisten, wiederherstellen oder endgültig leeren | Enthalten |
generate_spec_dashboard | Das planu/index.html-Dashboard neu generieren | Enthalten |
Kern-Workflow
facilitate
Einstiegspunkt ohne Vorkenntnisse — beschreibe, was du bauen möchtest, und Planu ermittelt die nächsten Schritte.
Wann verwenden: Wenn du nicht weißt, wo du anfangen sollst. Beschreibe einfach deine Idee oder dein Ziel in normaler Sprache, und facilitate entscheidet, ob Anforderungen geklärt, eine Spec erstellt oder die nächste Aktion vorgeschlagen werden soll.
Prompt: "I want to add Stripe payments to my app"
Prompt: "Help me plan a multi-tenant permission system"TIP
facilitate ist der beste Einstiegspunkt für neue Benutzer. Es entfernt die Notwendigkeit, Tool-Namen zu kennen — beschreibe einfach, was du bauen möchtest.
clarify_requirements
Gezielte Klärungsfragen generieren, bevor eine Spec erstellt wird.
Wann verwenden: Vor create_spec, wenn Anforderungen unklar sind, aus einem schnellen mündlichen Gespräch stammen oder mehrere Systeme berühren.
Was es erzeugt: Eine priorisierte Liste von Fragen zu Umfangsgrenzen, Randfällen, nicht-funktionalen Anforderungen, Fehlerbehandlung und externen Abhängigkeiten.
Prompt: "Use planu to clarify requirements for adding Stripe payments to project proj_abc123"TIP
Das Ausführen von clarify_requirements zuerst führt zu deutlich vollständigeren Abnahmekriterien und weniger Spec-Überarbeitungen. Es ist eine 30-Sekunden-Investition, die Stunden spart.
elicit_requirements Pro
Erweiterte interaktive Anforderungserhebung — ein strukturierter Interview-Modus, der tiefer geht als clarify_requirements.
Wann verwenden: Für komplexe Features, Plattform-Migrationen oder Integrationen mit mehreren Stakeholdern. Das Tool führt das Gespräch mit Follow-up-Fragen basierend auf deinen Antworten, anstatt eine flache Liste zu präsentieren.
Prompt: "Elicit requirements for the new reporting module in project proj_abc123"create_spec
Eine vollständige SDD-Spec mit automatisch generierten Abschnitten erstellen.
Was generiert wird:
| Abschnitt | Beschreibung |
|---|---|
| User Story | Wer, was, warum im Standardformat |
| Abnahmekriterien | Testbare, eindeutige Kriterien, nummeriert für Rückverfolgbarkeit |
| DoR-Checkliste | Definition of Ready-Gates |
| Datenbankschema-Hinweise | Tabellen, Spalten, Beziehungen, Indizes |
| UI-Verträge | Komponentenverträge, Datenfluss, Zustandsverwaltung |
| ADR-Hinweise | Architecture Decision Records |
| PLAN.md | Schrittweiser RED/GREEN/VERIFY-Ausführungsplan |
KI-native Extras (wenn KI-Architektur erkannt wird):
- Latenzbudgets und Fallback-Ketten
- Prompt-Versionierungskriterien
- LLM-Observability-Anforderungen
Frontend-Extras (wenn Performance-Setup erkannt wird):
- Core Web Vitals-Kriterien
- SSR-Hydrations-Anforderungen
- MFE-Grenzendefinitionen
Prompt: "Create a spec for adding Google OAuth authentication to my project proj_abc123"list_specs
Alle Specs für ein Projekt auflisten, optional nach Status gefiltert.
Wann verwenden: Um zu sehen, was im Backlog ist, was in Bearbeitung ist oder was überprüft werden muss.
Prompt: "List all specs for project proj_abc123"
Prompt: "Show me specs in progress for project proj_abc123"
Prompt: "What specs are blocked in project proj_abc123?"update_status
Eine Spec mit DoR/DoD-Validierung bei jedem Schritt durch ihren Lebenszyklus führen.
Status-Ablauf: draft → ready → in_progress → review → done
Jeder Übergang validiert die entsprechende Checkliste. Du kannst eine Spec nicht als done markieren, ohne ihre DoD-Kriterien zu erfüllen.
Prompt: "Update status of spec SPEC-003 to in_progress in project proj_abc123"
Prompt: "Mark spec SPEC-007 as done in project proj_abc123"summarize_spec
Eine prägnante Zusammenfassung einer Spec generieren — nützlich für Team-Updates, PR-Beschreibungen oder Stand-up-Notizen.
Prompt: "Summarize spec SPEC-005 for project proj_abc123"Spec-Lebenszyklus-Verwaltung
spec_history Pro
Den Änderungsverlauf einer Spec anzeigen — wer hat was geändert, wann und warum.
Wann verwenden: Wenn untersucht wird, warum eine Spec geändert wurde, bei Audits oder beim Lösen von Spec-Streitigkeiten.
Prompt: "Show history for spec SPEC-003 in project proj_abc123"reconcile_spec Pro
Eine Spec mit Implementierungsänderungen abgleichen, mit Einzelgenehmigung und Verfassungs-Compliance-Prüfung.
Wann verwenden: Wenn die Implementierung absichtlich von der Spec abgewichen ist und du die Spec aktualisieren musst, um der Realität zu entsprechen.
Das Tool präsentiert jede Änderung zur Genehmigung — du entscheidest, was die neue Spec-Wahrheit wird.
Prompt: "Reconcile spec SPEC-004 with the implementation changes in project proj_abc123"branch_spec Pro
Einen Spec-Branch für Experimente erstellen — ermöglicht es, eine größere Spec-Änderung zu erkunden, ohne die Haupt-Spec zu berühren.
Wann verwenden: Wenn du einen alternativen Ansatz für eine Spec (andere Architektur, anderen Umfang) prototypisieren möchtest, bevor du dich dafür entscheidest.
Prompt: "Create a branch of spec SPEC-012 called 'microservices-approach' in project proj_abc123"merge_spec_branch Pro
Einen experimentellen Spec-Branch nach der Validierung wieder in die Haupt-Spec zusammenführen.
Prompt: "Merge the 'microservices-approach' branch of spec SPEC-012 into main in project proj_abc123"version_spec Pro
Einen getaggten Versions-Snapshot einer Spec erstellen — nützlich für Meilenstein-Tracking und externe Übergaben.
Wann verwenden: Vor einer größeren Veröffentlichung, vor der Übergabe an ein externes Team oder um eine Baseline vor einem großen Refactoring festzulegen.
Prompt: "Create version v1.0 snapshot of spec SPEC-008 in project proj_abc123"spec_diff Pro
Zwei Spec-Versionen vergleichen und einen strukturierten Diff der Änderungen anzeigen.
Prompt: "Show the diff between v1.0 and v2.0 of spec SPEC-008 in project proj_abc123"export_spec Pro
Eine Spec in ein externes Format (spec-kit) zum Teilen außerhalb von Planu exportieren.
Prompt: "Export spec SPEC-010 to spec-kit format for project proj_abc123"Qualitätsgates
check_readiness Pro
Bewerten, ob eine Spec für die Implementierung bereit ist — Vollständigkeit, Kriterienqualität und Abhängigkeitsstatus.
Durchgeführte Prüfungen:
- Sind alle Abnahmekriterien testbar und eindeutig?
- Sind alle blockierenden Abhängigkeiten gelöst?
- Ist die DoR-Checkliste vollständig?
- Besteht die Spec die Verfassungs-Compliance-Prüfung?
Prompt: "Check if spec SPEC-006 is ready for implementation in project proj_abc123"challenge_spec Pro
Eine Spec durch Simulation von Ausfällen, hohem Datenverkehr, Randfällen und gegnerischen Bedingungen belasten.
Wann verwenden: Vor der Genehmigung einer Spec für ein kritisches System oder nach einer größeren Spec-Überarbeitung.
Prompt: "Challenge spec SPEC-009 in project proj_abc123"red_team Pro
Gegnerische Überprüfung — argumentiert von Grund auf gegen die Spec vor der Genehmigung.
Wann verwenden: Für hochriskante Specs (Abrechnung, Authentifizierung, Datenmigration), bei denen du eine Advocatus-Diaboli-Überprüfung möchtest, bevor das Design festgelegt wird.
Prompt: "Red team spec SPEC-011 in project proj_abc123"detect_contradictions Pro
Alle Specs in einem Projekt auf semantische Widersprüche analysieren.
Wann verwenden: Vor einem Sprint-Start, nach einem größeren Produkt-Pivot oder wenn Specs unabhängig von verschiedenen Teammitgliedern aktualisiert wurden.
Prompt: "Detect contradictions in the specs for project proj_abc123"Beispielausgabe: "SPEC-002 sagt, Benutzer können Konten löschen. SPEC-008 sagt, Kontodaten sind für Prüfzwecke unveränderlich."
Scope & Paketierung
manage_scope Pro
Den Projektscope und Backlog verwalten — Elemente hinzufügen, entfernen, neu priorisieren oder als strukturiertes Backlog exportieren.
Prompt: "Add 'dark mode support' to the backlog for project proj_abc123 with priority high"
Prompt: "Show the current backlog for project proj_abc123"package_handoff Pro
Ein strukturiertes Übergabepaket für einen KI-Agenten zur Implementierung einer Spec generieren.
Was es erzeugt:
- Implementierungsziel
- Nummerierte Abnahmekriterien
- Dateiliste mit Eigentümerschaft
- Einschränkungen und Leitplanken
- Einfügefertiger Prompt für Claude oder jeden KI-Agenten
Wann verwenden: Beim Delegieren der Implementierung an eine autonome KI-Agenten-Sitzung oder ein Teammitglied, das nicht an der Spec-Erstellung beteiligt war.
Prompt: "Package spec SPEC-009 for handoff in project proj_abc123"decompose_spec Pro
Eine Spec automatisch in unabhängige Agenten-Tasks mit nicht überlappender Dateieigentümerschaft zerlegen — bereit zur parallelen Ausführung.
Wann verwenden: Für große Specs, die auf mehrere Agenten oder Teammitglieder aufgeteilt werden können. Das Tool erzwingt exklusive Dateieigentümerschaft pro Task, um Konflikte zu verhindern.
Prompt: "Decompose spec SPEC-015 into parallel agent tasks in project proj_abc123"analyze_spec_dependencies Pro
Den Spec-Abhängigkeitsgraphen analysieren: kritischen Pfad finden, zirkuläre Abhängigkeiten erkennen und Ausführungswellen berechnen.
Prompt: "Analyze spec dependencies for project proj_abc123"
Prompt: "What is the critical path to ship SPEC-020 in project proj_abc123?"Qualität & Abdeckung
generate_checklist Pro
Eine Qualitätscheckliste für eine Spec generieren — deckt Implementierungsbereitschaft, Testabdeckung, Dokumentation, Sicherheit und Performance ab.
Prompt: "Generate a quality checklist for spec SPEC-002 in project proj_abc123"check_spec_accuracy Pro
Die Genauigkeit einer Spec gegen die Implementierungsrealität überprüfen — prüft, ob Abnahmekriterien, Dateireferenzen und technische Details noch korrekt sind.
Wann verwenden: Nach bedeutenden Code-Änderungen, vor einer Veröffentlichung oder wenn eine Spec längere Zeit nicht überprüft wurde.
Prompt: "Check accuracy of spec SPEC-005 for project proj_abc123"spec_coverage Pro
Die Spec-Abdeckung im gesamten Projekt analysieren — identifiziert Bereiche der Codebasis ohne Specs und Specs ohne entsprechende Implementierung.
Wann verwenden: Bei der Sprint-Planung, bei vierteljährlichen Überprüfungen oder beim Onboarding, um Dokumentationslücken zu verstehen.
Prompt: "Show spec coverage for project proj_abc123"spec_usage_report Pro
Einen Spec-Observability-Bericht generieren, der zeigt, welche Specs Agenten aktiv nutzen, welche veraltet sind und welche am häufigsten referenziert werden.
Prompt: "Show spec usage report for project proj_abc123"semantic_search Pro
Projektwissen (Specs, Muster, Entscheidungen, erlerntes Wissen) nach Bedeutung durchsuchen — nicht nur Keyword-Matching.
Wann verwenden: Wenn du dich erinnerst, dass etwas entschieden wurde, es aber nicht per Keyword findest, oder wenn du in einem großen Projekt nach thematisch verwandten Specs suchst.
Prompt: "Search for anything related to rate limiting in project proj_abc123"
Prompt: "Find specs about user permissions in project proj_abc123"Templates
list_templates
Alle verfügbaren Spec-Templates mit Beschreibungen und Anwendungsfällen auflisten.
Prompt: "List available spec templates"apply_template Pro
Ein Spec-Template anwenden, um schnell Specs für gängige Muster (CRUD, Auth, Integration usw.) zu erstellen.
Wann verwenden: Wenn du eine Spec erstellst, die einem bekannten Muster folgt, und du mit vorab ausgefüllten Abschnitten einen Vorsprung haben möchtest.
Prompt: "Apply the CRUD template for a users resource in project proj_abc123"Backlog-Verwaltung
capture_idea
Eine leichtgewichtige Idee oder zukünftige Möglichkeit erfassen, ohne eine vollständige Spec zu erstellen. Ideen leben im Backlog, bis sie aufgewertet oder verworfen werden.
Prompt: "Capture idea: add offline mode support to project proj_abc123"list_backlog
Alle erfassten Ideen im Projekt-Backlog auflisten.
Prompt: "Show backlog for project proj_abc123"promote_idea
Eine Backlog-Idee zu einer vollständigen Spec aufwerten und den normalen Spec-Erstellungsfluss auslösen.
Prompt: "Promote idea IDEA-003 to a spec in project proj_abc123"discard_idea
Eine Backlog-Idee mit einem optionalen Grund als verworfen markieren.
Prompt: "Discard idea IDEA-005 in project proj_abc123 — not aligned with roadmap"Sitzungen & Lektionen
session_checkpoint
Einen Sitzungs-Checkpoint mit aktuellem Kontext, Fortschritt und offenen Fragen speichern — nützlich zum Wiederaufnehmen langer Sitzungen.
Prompt: "Save a session checkpoint for project proj_abc123"planu_status
Einen kompakten Weltschnappschuss des aktuellen Planu-Projektstatus erhalten — aktive Spec, Git-Status, Warteschlange und kürzliche Aktivität. Konzipiert für ~150 Tokens.
Prompt: "What's the current status of project proj_abc123?"log_lesson
Eine gelernte Lektion aus einer Spec oder Projekterfahrung protokollieren — als durchsuchbares Projektwissen gespeichert.
Prompt: "Log lesson: always run detect_contradictions before sprint planning in project proj_abc123"list_lessons
Alle gelernten Lektionen für ein Projekt auflisten.
Prompt: "Show lessons learned for project proj_abc123"Bereinigung
delete_spec
Eine oder mehrere Specs aus einem Projekt löschen. Gelöschte Specs werden in den Papierkorb verschoben und können wiederhergestellt werden.
Prompt: "Delete spec SPEC-017 from project proj_abc123"delete_project
Alle Daten für ein Projekt löschen. Diese Aktion verschiebt alle Daten vor der endgültigen Löschung in den Papierkorb.
Prompt: "Delete project proj_abc123"delete_pattern
Ein oder mehrere erlernte Muster aus einem Projekt löschen.
Prompt: "Delete pattern PAT-002 from project proj_abc123"delete_decision
Eine oder mehrere Entscheidungen/ADRs aus einem Projekt löschen.
Prompt: "Delete decision DEC-005 from project proj_abc123"manage_trash
Den Papierkorb verwalten: gelöschte Elemente auflisten, ein bestimmtes Element wiederherstellen oder den Papierkorb dauerhaft leeren.
Prompt: "List trash for project proj_abc123"
Prompt: "Restore spec SPEC-017 from trash in project proj_abc123"
Prompt: "Purge trash for project proj_abc123"generate_spec_dashboard
Das planu/index.html-Dashboard neu generieren — eine HTML-Übersicht aller Specs, ihrer Status und wichtiger Metriken für das Projekt.
Prompt: "Regenerate the spec dashboard for project proj_abc123"Siehe auch
- Analyse & Schätzungs-Tools (Stream C) — Schätzung, Musterkennung, Validierung, Modellempfehlung
- Design & Planungs-Tools (Stream D) — Architekturentscheidungen, Schemas, Ausführungspläne
- Plattform & Betriebs-Tools (Streams E–I) — Stack, Agenten, Git, Governance