Design- & Planungs-Tools (Stream D)

Stream D enthält 7 Tools zum Umwandeln von Specs in umsetzbare Implementierungsartefakte — Schemas, UI-Verträge, Architekturentscheidungen, Ausführungspläne und Event-Verträge.

generate_adr

Architecture Decision Records für eine Spec generieren.

Was es erzeugt: Strukturierte ADR-Dokumente, die den Entscheidungskontext, betrachtete Optionen, die getroffene Entscheidung und die Konsequenzen abdecken. Das Format folgt MADR (Markdown Architectural Decision Records).

Wann verwenden: Wenn eine Spec eine bedeutende Technologiewahl, ein Architekturmuster oder einen Trade-off beinhaltet, den zukünftige Entwickler verstehen müssen.

Prompt: "Generate ADRs for spec SPEC-004 in project proj_abc123"

Beispielausgabe:

# ADR-001: Use Redis for session storage

## Status: Accepted

## Context
The authentication spec requires session persistence across multiple server instances...

## Decision
Use Redis as the session store...

## Consequences
- Positive: Horizontal scaling without sticky sessions
- Negative: Adds Redis as a required infrastructure dependency

---

design_schema

Datenbankschema aus Spec-Anforderungen entwerfen.

Was es erzeugt:

• Tabellendefinitionen mit Spalten, Typen und Einschränkungen
• Primär- und Fremdschlüssel-Beziehungen
• Index-Vorschläge für Query-Performance
• Migrations-Hinweise
• Schema in mehreren Dialekten (SQL, Prisma, SQLAlchemy, GORM usw.)

Wann verwenden: Wenn eine Spec Datenpersistenz beinhaltet und du einen konkreten Ausgangspunkt für die Datenbankschicht benötigst.

Prompt: "Design the database schema for spec SPEC-002 in project proj_abc123"

---

define_ui_contract

UI-Komponentenverträge, Datenfluss und Zustandsverwaltung definieren.

Was es erzeugt:

• Komponentenschnittstellen-Definitionen (Props, Events, Slots)
• Datenfluss-Diagramm (welche Komponenten welchen Zustand besitzen)
• Zustandsverwaltungsansatz (lokal, Kontext, Store)
• API-Vertrag zwischen Frontend und Backend
• Barrierefreiheits-Anforderungen

Wann verwenden: Für jede Spec, die eine Frontend-Komponente, ein Formular oder eine Benutzerinteraktion enthält.

Prompt: "Define the UI contract for the login flow in spec SPEC-001 for project proj_abc123"

---

challenge_spec

Eine Spec auf Ausfälle, Parallelität, Skalierung und Randfälle hin belasten.

Was geprüft wird:

• Parallelitätsprobleme (Race Conditions, Deadlocks)
• Skalierungsbruchpunkte (was passiert bei 10x, 100x Last?)
• Ausfallmodi (was wenn die Datenbank nicht verfügbar ist?)
• Randfälle, die nicht von den Abnahmekriterien abgedeckt sind
• Sicherheitsangriffsfläche

Wann verwenden: Für jede Spec, die in der Produktion mit echten Benutzern läuft. Besonders wertvoll für Specs, die Zahlungen, Authentifizierung oder Echtzeit-Funktionen berühren.

Prompt: "Challenge spec SPEC-003 for project proj_abc123"

---

generate_execution_plan

Einen schrittweisen PLAN.md für die Implementierung einer Spec generieren — RED/GREEN/VERIFY-Zyklus mit parallelisierbaren Schritten.

Was es erzeugt:

## Phase 1: Foundation (parallel)
- [ ] Step 1a: Create database migration
- [ ] Step 1b: Define TypeScript interfaces
- [ ] Step 1c: Write failing tests (RED)

## Phase 2: Implementation (sequential)
- [ ] Step 2a: Implement repository layer (GREEN)
- [ ] Step 2b: Implement service layer

## Phase 3: Verification
- [ ] Step 3a: Run full test suite (VERIFY)
- [ ] Step 3b: Update spec status to review

Wann verwenden: Vor Beginn der Implementierung. Der PLAN.md wird zum Implementierungsvertrag für den KI-Agenten oder Entwickler.

Prompt: "Generate an execution plan for spec SPEC-005 in project proj_abc123"

---

generate_orchestration_script

Ein 3-Schicht-paralleles Automatisierungsskript (Worktrees + claude -p) für die gleichzeitige Ausführung mehrerer Specs generieren.

Was es erzeugt: Ein Shell-Skript, das:

• Isolierte Git-Worktrees pro Spec erstellt
• claude -p-Worker parallel startet
• Ressourcenzuweisung basierend auf verfügbarer CPU und RAM verwaltet
• Worker-Gesundheit überwacht und Ausfälle behandelt

Wann verwenden: Wenn mehrere unabhängige Specs gleichzeitig implementiert werden sollen und maximale Parallelität gewünscht wird.

Prompt: "Generate an orchestration script for specs SPEC-010, SPEC-011, SPEC-012 in project proj_abc123"

---

event_contracts

Ereignisgesteuerte Architekturverträge verwalten — JSON-Schema-Event-Verträge für Produzenten-/Konsumenten-Validierung generieren.

Was es erzeugt:

• JSON-Schema-Definitionen für jeden Event-Typ
• Produzenten-Vertrag (was der Emitter garantiert)
• Konsumenten-Vertrag (was der Subscriber erwartet)
• Versionierungsstrategie
• Rückwärtskompatibilitäts-Notizen

Wann verwenden: Für jede Spec, die Message Queues, Event Buses (Kafka, RabbitMQ, AWS SQS/SNS, NATS) oder Webhook-Integrationen beinhaltet.

Prompt: "Define event contracts for the order processing flow in spec SPEC-008 for project proj_abc123"

Beispielausgabe:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "OrderPlaced",
  "version": "1.0.0",
  "type": "object",
  "required": ["orderId", "customerId", "items", "total", "placedAt"],
  "properties": {
    "orderId": { "type": "string", "format": "uuid" },
    "customerId": { "type": "string", "format": "uuid" },
    "items": { "type": "array", "items": { "$ref": "#/definitions/OrderItem" } },
    "total": { "type": "number", "minimum": 0 },
    "placedAt": { "type": "string", "format": "date-time" }
  }
}