Blueprint – Bauplan-Generator

Was macht Blueprint – Bauplan-Generator?

Verwandle eine einzeilige Zielvorgabe in einen detaillierten, Schritt-für-Schritt-Bauplan, den jeder Codierungsagent kalt ausführen kann.

Wann verwenden

• Aufteilen eines großen Features in mehrere PRs mit klarer Abhängigkeitsreihenfolge
• Planen einer Umstrukturierung oder Migration, die mehrere Sitzungen umfasst
• Koordinieren paralleler Arbeitsstränge über Unter-Agenten hinweg
• Jede Aufgabe, bei der Kontextverlust zwischen Sitzungen zu Nacharbeit führen würde

Nicht verwenden für Aufgaben, die in einem einzigen PR erledigt werden können, weniger als 3 Tool-Aufrufe erfordern oder wenn der Benutzer „Mach einfach“ sagt.

Wie es funktioniert

Blueprint führt eine 5-Phasen-Pipeline aus:

1. Research – Preflight-Checks (git, gh auth, Remote, Standard-Branch), dann liest es die Projektstruktur, vorhandene Pläne und Speicherdateien, um Kontext zu sammeln.
2. Design – Zerlegt das Ziel in PR-große Schritte (typischerweise 3–12). Weist Abhängigkeitskanten, parallele/serielle Anordnung, Modellstufe (stärkstes vs. Standard) und Rollback-Strategie pro Schritt zu.
3. Draft – Schreibt eine eigenständige Markdown-Plan-Datei nach plans/. Jeder Schritt enthält eine Kontextübersicht, Aufgabenliste, Verifikationsbefehle und Exit-Kriterien – damit ein frischer Agent jeden Schritt ausführen kann, ohne vorherige Schritte gelesen zu haben.
4. Review – Delegiert die gegnerische Überprüfung an einen starken Unter-Agenten (z. B. Opus) anhand einer Checkliste und eines Anti-Pattern-Katalogs. Behebt alle kritischen Befunde vor der Fertigstellung.
5. Register – Speichert den Plan, aktualisiert den Speicherindex und zeigt dem Benutzer die Schrittanzahl und eine Parallelitätsübersicht.

Blueprint erkennt die Verfügbarkeit von git/gh automatisch. Mit git + GitHub CLI erstellt es vollständige Branch/PR/CI-Workflow-Pläne. Ohne diese wechselt es in den Direktmodus (direktes Bearbeiten, keine Branches).

Beispiele

Einfache Nutzung

/blueprint myapp „Datenbank zu PostgreSQL migrieren“

Erzeugt plans/myapp-migrate-database-to-PostgreSQL.md mit Schritten wie:

• Schritt 1: PostgreSQL-Treiber und Verbindungskonfiguration hinzufügen
• Schritt 2: Migrationsskripte für jede Tabelle erstellen
• Schritt 3: Repository-Schicht aktualisieren, um neuen Treiber zu verwenden
• Schritt 4: Integrationstests gegen PostgreSQL hinzufügen
• Schritt 5: Alten Datenbankcode und Konfiguration entfernen

Multi-Agent-Projekt

/blueprint chatbot „LLM-Anbieter in ein Plugin-System auslagern“

Erstellt einen Plan mit parallelen Schritten, wo möglich (z. B. „Anthropic-Plugin implementieren“ und „OpenAI-Plugin implementieren“ laufen parallel nach dem Plugin-Schnittstellenschritt), Modellstufenzuweisungen (stärkstes Modell für den Schnittstellenentwurf, Standard für die Implementierung) und Invarianten, die nach jedem Schritt überprüft werden (z. B. „alle vorhandenen Tests bestehen“, „keine Anbieterimporte im Kern“).

Hauptfunktionen

• Kaltstart-Ausführung – Jeder Schritt enthält eine eigenständige Kontextübersicht. Kein vorheriger Kontext erforderlich.
• Gegnerische Prüfungsschranke – Jeder Plan wird von einem starken Unter-Agenten anhand einer Checkliste auf Vollständigkeit, korrekte Abhängigkeiten und Anti-Pattern-Erkennung überprüft.
• Branch/PR/CI-Workflow – In jeden Schritt integriert. Sanftes Herabstufen in den Direktmodus, wenn git/gh nicht vorhanden ist.
• Erkennung paralleler Schritte – Der Abhängigkeitsgraph identifiziert Schritte ohne gemeinsame Dateien oder Ausgabeabhängigkeiten.
• Plan-Mutationsprotokoll – Schritte können mit formalen Protokollen und Prüfprotokoll geteilt, eingefügt, übersprungen, neu angeordnet oder aufgegeben werden.
• Null-Laufzeitrisiko – Reiner Markdown-Skill. Das gesamte Repository enthält nur .md-Dateien – keine Hooks, keine Shell-Skripte, kein ausführbarer Code, keine package.json, kein Build-Schritt. Nichts wird bei der Installation oder dem Aufruf ausgeführt, außer dem nativen Markdown-Skill-Lader von Claude Code.

Installation

Dieser Skill wird mit Everything Claude Code ausgeliefert. Wenn ECC installiert ist, ist keine separate Installation erforderlich.

Vollständige ECC-Installation

Wenn Sie aus dem ECC-Repository-Checkout arbeiten, überprüfen Sie, ob der Skill vorhanden ist mit:

test -f skills/blueprint/SKILL.md

Zum späteren Aktualisieren überprüfen Sie den ECC-Diff vor dem Update:

cd /pfad/zu/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main       # neue Commits vor dem Update überprüfen
git checkout <überprüfter-voll-sha>          # auf einen bestimmten überprüften Commit festlegen

Eigenständige vendored Installation

Wenn Sie nur diesen Skill außerhalb der vollständigen ECC-Installation vendoren, kopieren Sie die überprüfte Datei aus dem ECC-Repository nach ~/.claude/skills/blueprint/SKILL.md. Vendored-Kopien haben kein git-Remote. Aktualisieren Sie sie daher, indem Sie die Datei aus einem überprüften ECC-Commit erneut kopieren, anstatt git pull auszuführen.

Anforderungen

• Claude Code (für den /blueprint-Slash-Befehl)
• Git + GitHub CLI (optional – ermöglicht den vollständigen Branch/PR/CI-Workflow; Blueprint erkennt das Fehlen und wechselt automatisch in den Direktmodus)

Quelle

Inspiriert von antbotlab/blueprint – übergeordnetes Projekt und Referenzdesign.