Blueprint – Bauplan-Generator

Was macht Blueprint – Bauplan-Generator?

Verwandle eine einzeilige Aufgabenbeschreibung in einen detaillierten, schrittweisen Bauplan, den jeder Coding-Agent ohne Vorwissen ausführen kann.

Wann verwenden

• Aufteilung einer großen Funktion in mehrere PRs mit klarer Abhängigkeitsreihenfolge
• Planung einer Refaktorisierung oder Migration über mehrere Sitzungen hinweg
• Koordinierung paralleler Arbeitsströme über Unteragenten 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 benötigen, oder wenn der Benutzer „einfach machen“ sagt.

Funktionsweise

Blueprint durchläuft eine fünfteilige Pipeline:

1. Research – Vorabprüfung (git, gh auth, remote, default branch), dann Auslesen der Projektstruktur, vorhandener Pläne und Gedächtnisdateien zur Kontextgewinnung.
2. Design – Zerlegung der Aufgabe in PR-große Schritte (typisch 3–12). Zuweisung von Abhängigkeitskanten, paralleler/serieller Reihenfolge, Modellstufe (stärkstes vs. Standard) und Rollback-Strategie pro Schritt.
3. Draft – Erstellen einer eigenständigen Markdown-Plan-Datei in plans/. Jeder Schritt enthält eine Kontext-Zusammenfassung, Aufgabenliste, Verifikationsbefehle und Abbruchkriterien – so kann ein frischer Agent jeden Schritt ausführen, ohne frühere Schritte lesen zu müssen.
4. Review – Delegieren einer adversarialen Überprüfung an einen Unteragenten mit dem stärksten Modell (z. B. Opus) anhand einer Checkliste und eines Anti-Pattern-Katalogs. Behebung aller kritischen Befunde vor der Fertigstellung.
5. Register – Speichern des Plans, Aktualisieren des Gedächtnisindex und Präsentieren der Schrittzahl und Parallelitätsübersicht für den Benutzer.

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

Beispiele

Einfache Nutzung

/blueprint myapp "Datenbank auf 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 den neuen Treiber zu verwenden
• Schritt 4: Integrationstests gegen PostgreSQL hinzufügen
• Schritt 5: Alten Datenbank-Code und Konfiguration entfernen

Multi-Agenten-Projekt

/blueprint chatbot "LLM-Provider in ein Plugin-System auslagern"

Erzeugt einen Plan mit parallelen Schritten, sofern möglich (z. B. „Anthropic-Plugin implementieren“ und „OpenAI-Plugin implementieren“ laufen parallel, nachdem der Schritt für die Plugin-Schnittstelle abgeschlossen ist), 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 Provider-Imports im Kern“).

Hauptmerkmale

• Kaltstart-Ausführung – Jeder Schritt enthält eine eigenständige Kontext-Zusammenfassung. Kein vorheriger Kontext erforderlich.
• Adversariales Review-Gate – Jeder Plan wird von einem Unteragenten mit dem stärksten Modell anhand einer Checkliste zu Vollständigkeit, Korrektheit der Abhängigkeiten und Anti-Pattern-Erkennung überprüft.
• Branch/PR/CI-Workflow – In jeden Schritt integriert. Fällt bei Fehlen von git/gh elegant in den Direktmodus zurück.
• Parallel-Schritt-Erkennung – Der Abhängigkeitsgraph identifiziert Schritte ohne gemeinsame Dateien oder Ausgabeabhängigkeiten.
• Plan-Mutationsprotokoll – Schritte können mit formalen Protokollen und Prüfpfad geteilt, eingefügt, übersprungen, neu angeordnet oder aufgegeben werden.
• Null-Risiko zur Laufzeit – Reine 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. Bei Installation oder Aufruf wird nichts ausgeführt, außer dem nativen Markdown-Skill-Loader von Claude Code.

Installation

Diese Skill ist Teil von Everything Claude Code. Keine separate Installation erforderlich, wenn ECC installiert ist.

Vollständige ECC-Installation

Wenn Sie aus dem ECC-Repository-Checkout arbeiten, überprüfen Sie die Anwesenheit der Skill mit:

test -f skills/blueprint/SKILL.md

Zum späteren Aktualisieren prü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 prüfen
git checkout <geprüfter-vollständiger-sha> # auf einen bestimmten geprüften Commit festlegen

Eigenständige Installation (Vendoring)

Wenn Sie nur diese Skill außerhalb der vollständigen ECC-Installation vendoren, kopieren Sie die geprüfte Datei aus dem ECC-Repository in ~/.claude/skills/blueprint/SKILL.md. Vendorfte Kopien haben kein git-Remote; aktualisieren Sie sie daher durch erneutes Kopieren der Datei aus einem geprüften ECC-Commit anstatt git pull auszuführen.

Voraussetzungen

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

Quelle

Inspiriert von antbotlab/blueprint – Upstream-Projekt und Referenzdesign.