Blueprint

Was ist Blueprint?

Blueprint ist ein Planungs-Copilot für Coding Agents. Er hilft einem Agenten, vor dem Schreiben von Code die richtigen Fragen zu stellen, und erzeugt dann einen Markdown-Plan, den der Agent in einem Durchgang ausführen kann.

Das Tool ist agentenunabhängig konzipiert und nutzt Q&A-gesteuerte Planung: Es durchsucht eine Codebase und stellt Multiple-Choice-Fragen, die leicht zu beantworten sind. Die Ausgabe soll Probleme und Entscheidungen aufzeigen, die man vielleicht übersehen hätte, strukturiert als wiederverwendbare Spezifikation/Plan.

Wichtige Funktionen

• Q&A-Planung vor dem Code: Blueprint bremst die Ausführung gerade genug, um Anforderungen zu klären, und generiert dann einen strukturierten Plan.
• Codebase-Erkundung: Es liest Ihre Workspace/Codebase und nutzt diesen Kontext, um die gestellten Fragen zu steuern.
• Multiple-Choice-Fragen: Die Fragen sind so formatiert, dass Sie schnell antworten können, während wichtige Unklarheiten abgedeckt werden.
• Markdown-Plan-Ausgabe: Das Ergebnis ist eine Markdown-Datei für die direkte Übergabe an Coding Agents.
• Agentenunabhängige Skills (kompatibel mit skills.sh): Blueprint ist als Skills verpackt, die mit mehreren Coding-Agenten-Harnesses kompatibel sind.
• Integrierte Vorlagen mit offenen-Fragen-Abschnitten: Enthält Standard-Planungsvorlagen mit Abschnitten wie Übersicht, erwartetes Verhalten, Implementierungsphasen, Teststrategie und offene Fragen.

So verwenden Sie Blueprint

1. Installieren Sie die Skill mit dem npx-Befehl aus dem Repository: npx skills add imbue-ai/blueprint.
2. Starten Sie eine Planungssitzung, indem Sie die Skill in Ihrem Coding Agent mit einer kurzen Aufgabenbeschreibung aufrufen (z. B. /blueprint Fügen Sie eine Caching-Schicht hinzu, um API-Aufrufe zu reduzieren).
3. Wählen Sie eine Vorlage, wenn Sie aufgefordert werden. Blueprint durchsucht Ihre Codebase und beginnt mit Fragen.
4. Beantworten Sie die Fragen, bis Blueprint feststellt, dass genug abgedeckt ist.
5. Generieren Sie den Plan mit /blueprint-generate. Der Plan wird unter blueprint/<slug>/plan-<slug>.md gespeichert.
6. Verfeinern Sie im Chat bei Bedarf und fragen Sie nach offenen Fragen (z. B. „Welche offenen Fragen gibt es?“), bevor Sie den Plan an Ihren Coding Agent übergeben.

Anwendungsfälle

• Greenfield-Projekte / neue Features: Planen Sie ein großes neues Feature, während Anforderungen, erwartetes Verhalten und Teststrategie explizit vor der Implementierung abgedeckt werden.
• Inkrementelle Änderungen mit Koordination: Wenn eine Änderung groß genug für eine sorgfältige Spezifikation ist (nicht nur eine schnelle Bearbeitung), hilft Blueprint, Entscheidungen und Phasen zu strukturieren.
• Forschung und Experimente: Für neue Modelle, Systeme oder Subsysteme kann der Q&A-Flow von Blueprint Annahmen und Unbekannte als Plan mit offenen Fragen erfassen.
• Arbeit an unbekannter Codebase: Blueprint durchsucht den Workspace und stellt klärende Fragen basierend auf seinen Funden, um Schlüsselbeschränkungen nicht zu übersehen.
• Reduzierung von Ausführungsfehlern in Agenten-Workflows: Wenn ein Agent sonst „zum Codieren eilt“, liefert Blueprint eine explizite Plan-Datei, die der Agent nach der Planungsphase ausführen kann.

FAQ

• Welche Coding-Agenten-Harnesses werden unterstützt?
  Das Repository gibt Kompatibilität mit Harnesses wie Claude Code, Codex CLI, Gemini CLI, Pi agent und anderen kompatiblen Harnesses an.

• Wo wird der generierte Plan gespeichert?
  Der Plan wird nach Ausführung von /blueprint-generate unter blueprint/<slug>/plan-<slug>.md geschrieben.

• Welche Vorlagen enthält Blueprint?
  Es liefert standardmäßig zwei integrierte Vorlagen: Default (Abschnitte wie Übersicht, erwartetes Verhalten, Implementierungsplan/Phasen, Teststrategie und offene Fragen) und Concise (Abschnitte wie Übersicht, erwartetes Verhalten und Änderungen).

• Kann ich die Planstruktur anpassen?
  Ja. Das Repository beschreibt, dass Sie bei Aufforderung eine benutzerdefinierte Vorlage inline angeben können und Vorlagen dauerhaft über templates.json hinzufügen/bearbeiten, damit die beiden Blueprint-Skills synchron bleiben.

• Ist Blueprint auf Frontend-Arbeit beschränkt?
  Die README-Hinweise deuten darauf hin, dass es weniger ideal für Frontends mit überwiegend visuellen Entscheidungen ist und besser für Greenfield-Projekte, große neue Features sowie Forschung oder Subsystem-Planung geeignet.

Alternativen

• Spezifikations- oder Dokumentengeneratoren (manuelle Überprüfung): Tools, die lange Spezifikationen nach den eigenen Entscheidungen des Agents erstellen, unterscheiden sich von Blueprint durch umgekehrten Workflow – Blueprint holt sich zuerst Ihre Eingabe per Q&A.
• „Planungsmodus“-Workflows von Coding-Agent-Tools: Einige Agent-Plattformen haben eigene Planungsmodi; Blueprint positioniert sich speziell als Planungs-Copilot, der einen agenten-ausführbaren Markdown-Plan generiert und kurze, anforderungsbezogene Fragen stellt.
• Generische Codebase-Review-Assistenten: Alternativen fassen Repositories zusammen oder analysieren sie, aber das markante Output von Blueprint ist ein strukturierter Markdown-Plan mit definierten Abschnitten und offenen Fragen zur Ausführung.
• VS-Code-Sidebar-Workflow mit Planungs-Extension: Wenn Sie editor-integrierte Tools bevorzugen, ist Blueprint auch als VS-Code-Extension verfügbar, die in VS Code, Cursor und Windsurf funktioniert – im Gegensatz zu rein chat-basierten Agent-Setups.