Spec-Lebenszyklus-Tools (Stream B)

Stream B enthält 11 Tools, die den vollständigen Spec-Lebenszyklus verwalten — von der ersten Klärungsfrage bis zur Übergabe einer produktionsreifen Spec an einen KI-Agenten.

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 specforge 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.

---

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 übergehen.

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"

---

generate_checklist

Eine Qualitäts-Checkliste 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"

---

reconcile_spec

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"

---

manage_scope

Den Projektumfang 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"

---

detect_contradictions

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."

---

check_readiness

Prüfen, 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"

---

package_handoff

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"