Design & Planungs-Tools (Stream D)

Stream D Tools verwandeln genehmigte Specs in umsetzbare Implementierungsartefakte — Schemas, UI-Verträge, Architekturentscheidungen, Ausführungspläne, Event-Verträge und mehr.

Schnellreferenz

Tool	Beschreibung	Verfügbarkeit
`generate_adr`	Einen Architecture Decision Record für eine bedeutende technische Entscheidung generieren	Enthalten
`log_decision`	Architektonische und Prozessentscheidungen registrieren, auflisten, suchen oder ablösen	Enthalten
`design_schema`	Datenbankschemas für die Anwendung entwerfen und validieren	Enthalten
`define_ui_contract`	UI-Komponentenverträge für Design-zu-Code-Workflows definieren und verwalten	Enthalten
`event_contracts`	Ereignisgesteuerte Architekturverträge definieren und verwalten	Enthalten
`generate_execution_plan`	Einen schrittweisen Ausführungsplan für die Implementierung einer Spec erstellen	Enthalten
`generate_orchestration_script`	Ein Skript für die Multi-Agenten-Ausführungsorchestrierung generieren	Enthalten
`recommend_model`	Den besten KI-Modell-Tier für eine gegebene Aufgabe empfehlen	Enthalten
`plan_team_distribution`	Planen, wie genehmigte Specs auf ein Team von Claude Code Agenten verteilt werden	Enthalten
`generate_spec_from_design`	Eine Planu-Spec aus einer UI/UX-Design-Beschreibung generieren	Enthalten
`contribute_context`	Zusätzlichen Kontext zu einer Spec aus externen Quellen beitragen	Enthalten
`request_context`	Zusätzlichen Kontext oder Expertise aus der Wissensbasis anfordern	Enthalten
`generate_proposal`	Einen eigenständigen HTML-Projektvorschlag mit KPI-Raster und Gantt-Diagramm generieren	Enthalten
`generate_docs_site`	Eine statische HTML-Dokumentationsseite aus Projekt-Specs generieren	Enthalten
`data_governance`	Daten-Governance-Richtlinien und Datenklassifizierungsregeln einrichten	Enthalten
`legal_compliance_report`	Einen Compliance-Bericht für gesetzliche und regulatorische Anforderungen generieren	Enthalten
`federate_specs`	Eine Spec im aktuellen Projekt mit einer Spec in einem anderen lokalen Repository verknüpfen	Enthalten
`federation_status`	Alle Cross-Repo-Spec-Föderierungslinks und deren Gesundheit anzeigen	Enthalten
`discover_registry`	Ein `.well-known/planu.json`-Manifest von einem lokalen Dateipfad lesen und validieren	Enthalten
`publish_registry`	Ein `.well-known/planu.json`-Manifest aus den Projekt-Specs generieren	Enthalten
`registry_publish`	Eine Spec im Planu-Registry veröffentlichen	Enthalten
`registry_login`	Mit dem Planu-Spec-Registry mit einem API-Token authentifizieren	Enthalten
`registry_logout`	Gespeicherte Registry-Anmeldedaten entfernen	Enthalten
`registry_whoami`	Den aktuell authentifizierten Registry-Benutzer anzeigen	Enthalten
`a2a_register`	Planu als A2A-fähigen (Agent-to-Agent) Agenten registrieren	Enthalten
`a2a_delegate`	Eine Spec-bezogene Aufgabe an einen anderen A2A-Agenten-Endpunkt delegieren	Enthalten

Architekturentscheidungen

`generate_adr`

Einen Architecture Decision Record (ADR) für eine bedeutende technische Entscheidung 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:

markdown

# 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

`log_decision`

Architektonische und Prozessentscheidungen im Projektentscheidungslog registrieren, auflisten, suchen oder ablösen.

Verfügbare Aktionen: log, list, search, supersede

Wann verwenden: Um einen durchsuchbaren Datensatz der während des Projekts getroffenen Entscheidungen zu pflegen — wer was entschieden hat, warum und wann. Eine frühere Entscheidung ablösen, wenn das Team die Richtung ändert.

Prompt: "Log a decision: we will use PostgreSQL instead of MongoDB for project proj_abc123"
Prompt: "List all decisions for project proj_abc123"
Prompt: "Supersede decision DEC-003 with the new approach in project proj_abc123"

`design_schema`

Datenbankschemas für die Anwendung entwerfen und validieren.

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 für Design-zu-Code-Workflows definieren und verwalten.

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"

`event_contracts`

Ereignisgesteuerte Architekturverträge definieren und 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:

json

{
  "$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" }
  }
}

Ausführungsplanung

`generate_execution_plan`

Einen detaillierten, schrittweisen Ausführungsplan für die Implementierung einer Spec erstellen — RED/GREEN/VERIFY-Zyklus mit parallelisierbaren Schritten.

Was es erzeugt:

markdown

## 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 Skript für die Multi-Agenten-Ausführungsorchestrierung generieren — erstellt ein 3-Schicht-paralleles Automatisierungsskript mit Worktrees und claude -p.

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"

`recommend_model`

Den besten KI-Modell-Tier (haiku, sonnet oder opus) für eine gegebene Aufgabe empfehlen, basierend auf Komplexität, Kosten und Fähigkeitsanforderungen.

Was bewertet wird:

Aufgabenkomplexität (einfache Codegenerierung vs. Architekturentscheidungen)
Kosteneinschränkungen
Geschwindigkeitsanforderungen
Benötigte Argumentationstiefe

Wann verwenden: Bei der Wahl zwischen KI-Modellen für Implementierung, Code-Review oder Spec-Generierung.

Prompt: "Recommend a model for implementing spec SPEC-005 in project proj_abc123"

`plan_team_distribution`

Planen, wie genehmigte Specs auf ein Team von Claude Code Agenten verteilt werden — weist Specs basierend auf Abhängigkeiten, Dateieigentümerschaft und Parallelisierungseinschränkungen zu.

Was es erzeugt:

Agenten-Zuweisungstabelle (welcher Agent welche Specs übernimmt)
Abhängigkeitsgraph zur Bestimmung der Sequenzierung
Dateieigentümerschafts-Map zur Konfliktvermeidung
Einsatzbereite Agenten-Spawn-Prompts

Wann verwenden: Bei der Implementierung mehrerer Specs parallel mit einem Agenten-Team. Verhindert Dateikonflikte und verschwendete Arbeit.

TIP

Führe plan_team_distribution aus, bevor du ein Agenten-Team startest. Es erkennt Dateieigentümerschaftskonflikte, die sonst Merge-Albträume verursachen würden.

Prompt: "Plan team distribution for approved specs in project proj_abc123"

Design aus Eingabe

`generate_spec_from_design`

Eine Planu-Spec aus einer UI/UX-Design-Beschreibung generieren — konvertiert Wireframes, Mockup-Beschreibungen oder Design-Notizen in strukturierte Abnahmekriterien.

Wann verwenden: Wenn ein Designer eine Beschreibung oder ein Bild einer Benutzeroberfläche übergibt und du es in eine baubare Spec umwandeln musst, bevor du mit der Implementierung beginnst.

Prompt: "Generate a spec from this design: a dashboard with a sidebar nav, main content area, and a collapsing filters panel, for project proj_abc123"

`contribute_context`

Zusätzlichen Kontext zu einer Spec aus externen Quellen oder Domänen-Expertise beitragen — fügt strukturiertes Wissen an eine bestehende Spec an.

Wann verwenden: Wenn ein Fachexperte (Recht, Sicherheit, Compliance) Einschränkungen zu einer Spec hinzufügen muss, die der ursprüngliche Autor nicht hatte.

Prompt: "Contribute context to spec SPEC-003: GDPR requires data deletion within 30 days for project proj_abc123"

`request_context`

Zusätzlichen Kontext oder Expertise aus der Wissensbasis anfordern — fragt erlernte Muster, vergangene Entscheidungen und domänenrelevantes Wissen für eine Spec ab.

Wann verwenden: Vor dem Schreiben einer Spec in einem unbekannten Bereich, um relevante Einschränkungen und Muster aus vergangenen Projekten einzubeziehen.

Prompt: "Request context for a payments integration spec in project proj_abc123"

Export & Dokumentation

`generate_proposal`

Einen eigenständigen HTML-Projektvorschlag mit KPI-Raster, Gantt-Diagramm, Spec-Aufschlüsselungstabelle, Risikoanalyse, Budgetübersicht und Architekturübersicht generieren.

Was es erzeugt: Eine einzelne portable HTML-Datei, bereit zum Teilen mit Kunden oder Stakeholdern — kein Server erforderlich.

Wann verwenden: Bei der Präsentation eines Projektplans für nicht-technische Stakeholder oder potenzielle Kunden.

Prompt: "Generate a project proposal for project proj_abc123"

`generate_docs_site`

Eine statische HTML-Dokumentationsseite aus Projekt-Specs, Tools-Katalog, Architekturdiagrammen und Metriken generieren.

Was es erzeugt:

Eine durchsuchbare HTML-Seite, die alle Specs, ihren Status und Abnahmekriterien abdeckt
Architekturdiagramme, die aus dem Spec-Graph abgeleitet wurden
Durchsuchbarer Tools-Katalog
Exportierbar für das Hosting auf einem beliebigen statischen Server

Wann verwenden: Wenn ein Projekt lebende Dokumentation benötigt, die mit Specs synchron bleibt.

Prompt: "Generate a documentation site for project proj_abc123"

Governance & Compliance

`data_governance`

Daten-Governance-Richtlinien und Datenklassifizierungsregeln für das Projekt einrichten.

Was es erzeugt:

Datenklassifizierungstaxonomie (öffentlich, intern, vertraulich, eingeschränkt)
Governance-Richtlinien pro Datenklasse
Spec-Level-Tagging für Datenverarbeitungsanforderungen
Verstoßerkennung in zukünftigen Specs und Code

Wann verwenden: Für Projekte, die sensible Daten verarbeiten — Gesundheitswesen, Finanzen, Recht oder jede regulierte Branche.

Prompt: "Set up data governance for project proj_abc123 under HIPAA"

`legal_compliance_report`

Einen Compliance-Bericht für gesetzliche und regulatorische Anforderungen generieren — ordnet Specs und Implementierung bestimmten Regulierungsklauseln zu.

Was es erzeugt:

Abdeckungsbericht pro Regulierung (DSGVO, HIPAA, SOC 2, PCI DSS usw.)
Offene Lücken, die behoben werden müssen
Belege-Links zu Specs und Audit-Trail-Ereignissen
Exportierbar für juristische Überprüfung

Wann verwenden: Vor einem Compliance-Audit oder bei der Vorbereitung von Nachweispaketen für die Zertifizierung.

Prompt: "Generate a GDPR compliance report for project proj_abc123"

Föderierung & Registry

Föderierung ermöglicht die Verknüpfung von Specs über Repositories hinweg. Das Registry ermöglicht das Veröffentlichen und Entdecken von Specs zur Wiederverwendung über Teams und Organisationen hinweg.

`federate_specs`

Eine Spec im aktuellen Projekt mit einer Spec in einem anderen lokalen Repository verknüpfen — erstellt einen Cross-Repo-Abhängigkeitslink.

Wann verwenden: In Monorepo- oder Multi-Repo-Setups, wo die Spec eines Projekts von der Spec eines anderen Projekts abhängt.

Prompt: "Federate spec SPEC-005 in project proj_abc123 to spec SPEC-012 in project proj_xyz789"

`federation_status`

Alle Cross-Repo-Spec-Föderierungslinks und deren Gesundheit anzeigen — prüft, ob verknüpfte Specs noch existieren und synchron sind.

Prompt: "Show federation status for project proj_abc123"

`discover_registry`

Ein .well-known/planu.json-Manifest von einem lokalen Dateipfad lesen und validieren — zeigt, welche Specs ein Projekt zur Wiederverwendung exponiert.

Prompt: "Discover registry manifest at /workspace/shared-lib"

`publish_registry`

Ein .well-known/planu.json-Manifest aus den Projekt-Specs generieren — macht deine Specs für andere Projekte auffindbar.

Prompt: "Publish registry manifest for project proj_abc123"

`registry_publish`

Eine Spec im Planu-Registry veröffentlichen, damit andere Teams sie entdecken und wiederverwenden können.

Prompt: "Publish spec SPEC-007 to the Planu registry from project proj_abc123"

`registry_login`

Mit dem Planu-Spec-Registry mit einem API-Token authentifizieren.

Prompt: "Log in to the Planu registry with my API token"

`registry_logout`

Gespeicherte Registry-Anmeldedaten vom lokalen Rechner entfernen.

Prompt: "Log out of the Planu registry"

`registry_whoami`

Den aktuell authentifizierten Registry-Benutzer anzeigen.

Prompt: "Who am I logged in as in the Planu registry?"

Agent-to-Agent (A2A)

A2A ermöglicht es Planu, an Multi-Agenten-Ökosystemen teilzunehmen — sich als fähiger Agent zu registrieren und Aufgaben an andere spezialisierte Agenten zu delegieren.

`a2a_register`

Planu als A2A-fähigen (Agent-to-Agent) Agenten registrieren — veröffentlicht die Fähigkeiten von Planu an einem A2A-Endpunkt, damit andere Agenten ihn entdecken und delegieren können.

Wann verwenden: Bei der Integration von Planu in eine Multi-Agenten-Pipeline, wo andere Orchestratoren wissen müssen, was Planu kann.

Prompt: "Register Planu as an A2A agent for project proj_abc123"

`a2a_delegate`

Eine Spec-bezogene Aufgabe an einen anderen A2A-Agenten-Endpunkt delegieren — sendet eine strukturierte Aufgabenanfrage an einen externen Agenten und empfängt das Ergebnis.

Wann verwenden: Wenn ein anderer spezialisierter Agent (z.B. ein Code-Review-Agent, ein Deployment-Agent) einen Schritt im Planu-Workflow übernehmen soll.

Prompt: "Delegate the code review for spec SPEC-009 to the review agent at http://localhost:8080 in project proj_abc123"

Siehe auch

Spec-Lebenszyklus-Tools (Stream B) — Specs erstellen, aktualisieren und verwalten
Analyse & Schätzungs-Tools (Stream C) — Validieren, prüfen und aus der Codebasis lernen
Plattform & Betriebs-Tools (Streams E–I) — Stack, Agenten, Git, Governance

Design & Planungs-Tools (Stream D) ​

Schnellreferenz ​

Architekturentscheidungen ​

generate_adr ​

log_decision ​

design_schema ​

define_ui_contract ​

event_contracts ​

Ausführungsplanung ​

generate_execution_plan ​

generate_orchestration_script ​

recommend_model ​

plan_team_distribution ​

Design aus Eingabe ​

generate_spec_from_design ​

contribute_context ​

request_context ​

Export & Dokumentation ​

generate_proposal ​

generate_docs_site ​

Governance & Compliance ​

data_governance ​

legal_compliance_report ​

Föderierung & Registry ​

federate_specs ​

federation_status ​

discover_registry ​

publish_registry ​

registry_publish ​

registry_login ​

registry_logout ​

registry_whoami ​

Agent-to-Agent (A2A) ​

a2a_register ​

a2a_delegate ​

Siehe auch ​

Design & Planungs-Tools (Stream D)

Schnellreferenz

Architekturentscheidungen

`generate_adr`

`log_decision`

`design_schema`

`define_ui_contract`

`event_contracts`

Ausführungsplanung

`generate_execution_plan`

`generate_orchestration_script`

`recommend_model`

`plan_team_distribution`

Design aus Eingabe

`generate_spec_from_design`

`contribute_context`

`request_context`

Export & Dokumentation

`generate_proposal`

`generate_docs_site`

Governance & Compliance

`data_governance`

`legal_compliance_report`

Föderierung & Registry

`federate_specs`

`federation_status`

`discover_registry`

`publish_registry`

`registry_publish`

`registry_login`

`registry_logout`

`registry_whoami`

Agent-to-Agent (A2A)

`a2a_register`

`a2a_delegate`

Siehe auch