Heim

Skill

Produktivität und Workflow

blueprint

affaan-m/ECC

Erstellen Sie aus einer einzeiligen Zielsetzung einen schrittweisen Konstruktionsplan mit Abhängigkeitsdiagrammen, Erkennung paralleler Schritte und adversarialer Überprüfung für Engineering-Projekte mit mehreren Sitzungen.

...Alle erweitern

Zeit aktualisiert 30. September 2026

# markdown # git # planning # multi agent # project management # dependency graph # github cli

Blueprint — Generator für Konstruktionspläne

Verwandeln Sie ein einzeiliges Ziel in einen schrittweisen Konstruktionsplan, den jeder Programmierer ohne Vorkenntnisse ausführen kann.

Wann sollte man ihn verwenden?

Aufteilung einer umfangreichen Funktion in mehrere PRs mit klarer Abhängigkeitsreihenfolge
Planung einer Refaktorisierung oder Migration, die sich über mehrere Sitzungen erstreckt
Koordination paralleler Arbeitsströme zwischen Unteragenten
Jede Aufgabe, bei der ein Kontextverlust zwischen den 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 bei denen der Nutzer sagt: „Mach es einfach.“

So funktioniert es

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

Recherche – Vorabprüfungen (Git, GH-Authentifizierung, Remote, Standardzweig), anschließend werden Projektstruktur, vorhandene Pläne und Speicherdateien gelesen, um Kontextinformationen zu sammeln.
Entwurf – Unterteilt das Ziel in Schritte, die in einen PR passen (typischerweise 3–12). Weist jedem Schritt Abhängigkeitsbeziehungen, parallele/serielle Reihenfolge, Modellstufe (stärkste vs. Standard) und Rollback-Strategie zu.
Entwurf – Erstellt eine in sich geschlossene Markdown-Planungsdatei unter plans/. Jeder Schritt enthält eine Kontextzusammenfassung, eine Aufgabenliste, Verifizierungsbefehle und Abbruchkriterien – so kann ein neuer Agent jeden Schritt ausführen, ohne vorherige Schritte lesen zu müssen.
Überprüfung – Delegiert die kritische Überprüfung an einen Subagenten mit dem stärksten Modell (z. B. Opus) anhand einer Checkliste und eines Anti-Pattern-Katalogs. Behebt alle kritischen Befunde vor der Fertigstellung.
Registrieren – Speichert den Plan, aktualisiert den Speicherindex und zeigt dem Benutzer die Schrittanzahl sowie eine Zusammenfassung der Parallelität an.

Blueprint Erkennt die Verfügbarkeit von Git/GitHub automatisch. Mit Git + GitHub CLI generiert es vollständige Workflow-Pläne für Zweige, Pull-Anfragen und CI. Ohne diese wechselt es in den Direktmodus (Bearbeitung vor Ort, keine Zweige).

Beispiele

Grundlegende Verwendung

/blueprint myapp "migrate database to PostgreSQL"

Erzeugt plans/myapp-migrate-database-to-postgresql.md mit folgenden Schritten:

Schritt 1: PostgreSQL-Treiber und Verbindungskonfiguration hinzufügen
Schritt 2: Erstellen Sie Migrationsskripte für jede Tabelle
Schritt 3: Repository-Ebene aktualisieren, um den neuen Treiber zu verwenden
Schritt 4: Hinzufügen von Integrationstests für PostgreSQL
Schritt 5: Den alten Datenbankcode und die alte Konfiguration entfernen

Multi-Agenten-Projekt

/blueprint chatbot "extract LLM providers into a plugin system"

Erstellt einen Plan mit parallelen Schritten, wo dies möglich ist (z. B. laufen „Implementierung des Anthropic-Plugins“ und „Implementierung des OpenAI-Plugins“ parallel, nachdem der Schritt zur Plugin-Schnittstelle abgeschlossen ist), Zuweisungen auf Modellebene (am stärksten für den Schritt zum Schnittstellendesign, standardmäßig für die Implementierung) sowie nach jedem Schritt überprüfte Invarianten (z. B. „alle bestehenden Tests bestehen“, „keine Provider-Importe im Kern“).

Wichtigste Funktionen

Cold-Start-Ausführung – Jeder Schritt enthält eine in sich geschlossene Kontextbeschreibung. Es ist kein vorheriger Kontext erforderlich.
Adversarische Prüfinstanz – Jeder Plan wird von einem Subagenten mit dem stärksten Modell anhand einer Checkliste überprüft, die Vollständigkeit, Korrektheit der Abhängigkeiten und die Erkennung von Anti-Patterns abdeckt.
Branch-/PR-/CI-Workflow – In jeden Schritt integriert. Wechselt nahtlos in den Direktmodus, wenn git/gh fehlt.
Erkennung paralleler Schritte – Der Abhängigkeitsgraph identifiziert Schritte ohne gemeinsame Dateien oder Ausgabeabhängigkeiten.
Protokoll zur Planänderung — Schritte können nach formalen Protokollen und mit Prüfpfad geteilt, eingefügt, übersprungen, neu angeordnet oder verworfen werden.
Kein Laufzeitrisiko – Reine Markdown-Fähigkeit. Das gesamte Repository enthält nur .md Dateien – keine Hooks, keine Shell-Skripte, keinen ausführbaren Code, keinen package.json, keine Build-Schritte. Bei der Installation oder beim Aufruf wird nichts ausgeführt außer dem nativen Markdown-Skill-Loader von Claude Code.

Installation

Dieser Skill ist im Lieferumfang von „Everything Claude Code“ enthalten. Bei einer Installation von ECC ist keine separate Installation erforderlich.

Vollständige ECC-Installation

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

test -f skills/blueprint/SKILL.md

Um später ein Update durchzuführen, überprüfen Sie vor dem Update den ECC-Diff:

cd /path/to/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main       # review new commits before updating
git checkout           # pin to a specific reviewed commit

Vendored-Einzelinstallation

Wenn Sie nur diese Funktion außerhalb der vollständigen ECC-Installation als Vendor-Komponente nutzen, kopieren Sie die geprüfte Datei aus dem ECC-Repository in ~/.claude/skills/blueprint/SKILL.md. Vendored-Kopien verfügen über kein Git-Remote; aktualisieren Sie sie daher, indem Sie die Datei erneut aus einem geprüften ECC-Commit kopieren, anstatt git pull.

Voraussetzungen

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

Quelle

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

Auf GitHub ansehen

---
name: blueprint
description: Generate a step-by-step construction plan from a one-line objective, with dependency graphs, parallel step detection, and adversarial review for multi-session engineering projects.
---

# Blueprint — Construction Plan Generator

Turn a one-line objective into a step-by-step construction plan that any coding agent can execute cold.

## When to Use

- Breaking a large feature into multiple PRs with clear dependency order
- Planning a refactor or migration that spans multiple sessions
- Coordinating parallel workstreams across sub-agents
- Any task where context loss between sessions would cause rework

**Do not use** for tasks completable in a single PR, fewer than 3 tool calls, or when the user says "just do it."

## How It Works

Blueprint runs a 5-phase pipeline:

1. **Research** — Pre-flight checks (git, gh auth, remote, default branch), then reads project structure, existing plans, and memory files to gather context.
2. **Design** — Breaks the objective into one-PR-sized steps (3–12 typical). Assigns dependency edges, parallel/serial ordering, model tier (strongest vs default), and rollback strategy per step.
3. **Draft** — Writes a self-contained Markdown plan file to `plans/`. Every step includes a context brief, task list, verification commands, and exit criteria — so a fresh agent can execute any step without reading prior steps.
4. **Review** — Delegates adversarial review to a strongest-model sub-agent (e.g., Opus) against a checklist and anti-pattern catalog. Fixes all critical findings before finalizing.
5. **Register** — Saves the plan, updates memory index, and presents the step count and parallelism summary to the user.

Blueprint detects git/gh availability automatically. With git + GitHub CLI, it generates full branch/PR/CI workflow plans. Without them, it switches to direct mode (edit-in-place, no branches).

## Examples

### Basic usage

```
/blueprint myapp "migrate database to PostgreSQL"
```

Produces `plans/myapp-migrate-database-to-postgresql.md` with steps like:
- Step 1: Add PostgreSQL driver and connection config
- Step 2: Create migration scripts for each table
- Step 3: Update repository layer to use new driver
- Step 4: Add integration tests against PostgreSQL
- Step 5: Remove old database code and config

### Multi-agent project

```
/blueprint chatbot "extract LLM providers into a plugin system"
```

Produces a plan with parallel steps where possible (e.g., "implement Anthropic plugin" and "implement OpenAI plugin" run in parallel after the plugin interface step is done), model tier assignments (strongest for the interface design step, default for implementation), and invariants verified after every step (e.g., "all existing tests pass", "no provider imports in core").

## Key Features

- **Cold-start execution** — Every step includes a self-contained context brief. No prior context needed.
- **Adversarial review gate** — Every plan is reviewed by a strongest-model sub-agent against a checklist covering completeness, dependency correctness, and anti-pattern detection.
- **Branch/PR/CI workflow** — Built into every step. Degrades gracefully to direct mode when git/gh is absent.
- **Parallel step detection** — Dependency graph identifies steps with no shared files or output dependencies.
- **Plan mutation protocol** — Steps can be split, inserted, skipped, reordered, or abandoned with formal protocols and audit trail.
- **Zero runtime risk** — Pure Markdown skill. The entire repository contains only `.md` files — no hooks, no shell scripts, no executable code, no `package.json`, no build step. Nothing runs on install or invocation beyond Claude Code's native Markdown skill loader.

## Installation

This skill ships with Everything Claude Code. No separate installation is needed when ECC is installed.

### Full ECC install

If you are working from the ECC repository checkout, verify the skill is present with:

```bash
test -f skills/blueprint/SKILL.md
```

To update later, review the ECC diff before updating:

```bash
cd /path/to/everything-claude-code
git fetch origin main
git log --oneline HEAD..origin/main       # review new commits before updating
git checkout <reviewed-full-sha>          # pin to a specific reviewed commit
```

### Vendored standalone install

If you are vendoring only this skill outside the full ECC install, copy the reviewed file from the ECC repository into `~/.claude/skills/blueprint/SKILL.md`. Vendored copies do not have a git remote, so update them by re-copying the file from a reviewed ECC commit rather than running `git pull`.

## Requirements

- Claude Code (for `/blueprint` slash command)
- Git + GitHub CLI (optional — enables full branch/PR/CI workflow; Blueprint detects absence and auto-switches to direct mode)

## Source

Inspired by antbotlab/blueprint — upstream project and reference design.