red-proto 0.11.0 → 0.13.2

package/README.md

@@ -4,19 +4,9 @@ Ein KI-gestütztes Product Development Framework für [Claude Code](https://clau
 
 ---
 
-## Workflow
-
-![red·proto Workflow](docs/workflow.svg)
-
-> Maschinenlesbare BPMN 2.0 Datei: [workflow.bpmn](docs/workflow.bpmn) – öffenbar in [Camunda Modeler](https://camunda.com/download/modeler/) oder [bpmn.io](https://bpmn.io)
-
-**Faustregel:** Alles bis `/red:proto-flows` machst du einmal für dein Projekt. Ab `/red:proto-ux` wiederholst du den Loop für jedes Feature. `proto-dev` und `proto-qa` laufen in **getrennten Sessions** – `proto-dev` schreibt am Ende ein Handoff-File, das `proto-qa` in der neuen Session einliest.
-
----
-
 ## Was ist das?
 
-Eine Sammlung von Claude Code Commands und Agents, die eine vollständige Produktentwicklungs-Pipeline abbilden. Du arbeitest mit natürlicher Sprache – Claude führt die Pipeline aus, du triffst die Entscheidungen.
+Eine Sammlung von Claude Code Commands, die eine vollständige Produktentwicklungs-Pipeline abbilden. Du beschreibst deine Idee in natürlicher Sprache – Claude führt die Pipeline aus, du triffst die Entscheidungen.
 
 ```
 /red:proto-workflow     → Nach jeder Pause: zeigt exakt wo du stehst und was als nächstes zu tun ist
@@ -37,7 +27,51 @@ dann pro Feature (Build-Loop bis QA grün):
                           └── Bugs? → neue Session → /red:proto-dev → /red:proto-qa
 ```
 
-Jeder Command ist eigenständig – du kannst an jedem Punkt einsteigen oder aufhören. Die Commands bauen aber aufeinander auf: jeder liest den Output des vorherigen und ergänzt die gemeinsamen Artefakte.
+Jeder Command ist eigenständig – du kannst an jedem Punkt einsteigen oder aufhören. Die Commands bauen aufeinander auf: jeder liest den Output des vorherigen und ergänzt die gemeinsamen Artefakte.
+
+### Workflow
+
+```mermaid
+flowchart TD
+    A([Idee]) --> B
+
+    subgraph setup["📐 Einmalig pro Projekt"]
+        B["/red:proto-sparring\nIdee → PRD"]
+        B --> C["/red:proto-dev-setup\nTech-Stack + GitHub"]
+        C --> D{Research?}
+        D -->|optional| E["/red:proto-research\nPersonas + Problem Statement"]
+        D -->|überspringen| F
+        E --> F["/red:proto-requirements\nSpecs für alle Features"]
+        F --> G["/red:proto-flows\nScreen-Inventar + Transitions"]
+    end
+
+    subgraph feature["🔁 Pro Feature wiederholen"]
+        G --> H["/red:proto-ux\nUX-Entscheidungen"]
+        H --> I["/red:proto-architect\nTech-Design + Security + Tests"]
+        I --> J
+
+        subgraph session1["Session 1"]
+            J["/red:proto-dev\nImplementierung"]
+            J --> J2["Handoff schreiben\ncontext/FEAT-x-dev-handoff.md"]
+        end
+
+        subgraph session2["Session 2 (neu starten)"]
+            J2 --> K["/red:proto-qa\nTests + Bugs"]
+        end
+
+        K --> L{Bugs?}
+        L -->|Critical / High| J
+        L -->|Grün ✅| M([Production-Ready])
+    end
+
+    M --> N{Weitere Features?}
+    N -->|ja| H
+    N -->|nein| O([Release 🎉])
+
+    P(["/red:proto-workflow\nOrientierung jederzeit"]) -.->|wo stehe ich?| feature
+```
+
+**Faustregel:** Alles bis `/red:proto-flows` machst du einmal für dein Projekt. Ab `/red:proto-ux` wiederholst du den Loop für jedes Feature. `proto-dev` und `proto-qa` laufen in **getrennten Sessions** – `proto-dev` schreibt am Ende ein Handoff-File, das `proto-qa` in der neuen Session einliest.
 
 ---
 
@@ -65,8 +99,18 @@ Der Installer fragt interaktiv:
 - **Global** (`~/.claude/`) → Commands in allen Projekten verfügbar
 - **Lokal** (`./.claude/`) → nur im aktuellen Verzeichnis
 
+> **Hinweis:** Nicht global und lokal gleichzeitig installieren – Claude Code zeigt die Commands sonst doppelt an. Der Installer warnt dich, wenn eine andere Installation erkannt wird.
+
 > **Update:** Denselben Befehl erneut ausführen – der Installer erkennt bestehende Installationen.
 
+**Deinstallieren:**
+
+```bash
+npx red-proto --uninstall
+```
+
+Entfernt alle Commands und Agents – deine Projektdateien (`features/`, `research/`, `prd.md` usw.) bleiben unangetastet.
+
 **Option B – Manuell via Git (falls kein npx):**
 
 ```bash
@@ -105,17 +149,6 @@ Dann in Claude Code:
 
 ---
 
-### Kurzübersicht: Was macht was?
-
-| Befehl | Wann | Was passiert |
-|--------|------|--------------|
-| `npx red-proto@latest` | Einmalig pro Computer | Installiert Commands in `~/.claude/` (global) oder `./.claude/` (lokal) |
-| `/red:proto` | Einmalig pro Projekt | Legt Projektstruktur an, kopiert Design System |
-| `/red:proto-sparring` | Start jedes Projekts | Erste Anlaufstelle – Idee zu PRD |
-| `/red:proto-workflow` | Nach jeder Session-Pause | Zeigt wo du stehst, was als nächstes kommt |
-
----
-
 ## Was wird installiert?
 
 Nach dem Setup hat dein Projekt folgende Struktur:

package/bin/install.js

@@ -1,11 +1,10 @@
 #!/usr/bin/env node
 
 import { createInterface } from 'readline';
-import { cp, mkdir, access } from 'fs/promises';
+import { cp, mkdir, rm, access } from 'fs/promises';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { homedir } from 'os';
-import { createReadStream } from 'fs';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const PACKAGE_ROOT = join(__dirname, '..');
@@ -21,6 +20,27 @@ const c = {
   dim:    (s) => `\x1b[2m${s}\x1b[0m`,
 };
 
+const COMMAND_FILES = [
+  'red:proto.md',
+  'red:proto-workflow.md',
+  'red:proto-sparring.md',
+  'red:proto-dev-setup.md',
+  'red:proto-research.md',
+  'red:proto-requirements.md',
+  'red:proto-flows.md',
+  'red:proto-ux.md',
+  'red:proto-architect.md',
+  'red:proto-dev.md',
+  'red:proto-qa.md',
+];
+
+const AGENT_FILES = [
+  'frontend-developer.md',
+  'backend-developer.md',
+  'qa-engineer.md',
+  'ux-reviewer.md',
+];
+
 async function exists(path) {
   try { await access(path); return true; }
   catch { return false; }
@@ -46,9 +66,98 @@ function printHeader(version) {
   console.log('');
 }
 
-// ─── Main ────────────────────────────────────────────────────────────────────
+// ─── Uninstall ───────────────────────────────────────────────────────────────
+
+async function runUninstall() {
+  const { version } = JSON.parse(
+    await import('fs').then(fs => fs.promises.readFile(join(PACKAGE_ROOT, 'package.json'), 'utf8'))
+  );
+
+  printHeader(version);
+
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+
+  console.log(c.yellow('  Uninstall – where was red · proto installed?'));
+  console.log('');
+
+  const globalBase = join(homedir(), '.claude');
+  const localBase  = join(process.cwd(), '.claude');
+
+  const globalExists = await exists(join(globalBase, 'commands', 'red:proto.md'));
+  const localExists  = await exists(join(localBase,  'commands', 'red:proto.md'));
+
+  if (!globalExists && !localExists) {
+    console.log(c.dim('  red · proto is not installed in this location.'));
+    console.log('');
+    rl.close();
+    return;
+  }
+
+  const options = [];
+  if (globalExists) options.push({ label: `Global  ${c.dim('(~/.claude)')}`,       base: globalBase });
+  if (localExists)  options.push({ label: `Local   ${c.dim('(./.claude)')}`,        base: localBase  });
+
+  options.forEach((opt, i) => {
+    console.log(`  ${i + 1}) ${c.bold(opt.label)}`);
+  });
+  if (options.length > 1) {
+    console.log(`  ${options.length + 1}) ${c.bold('Both')}`);
+  }
+  console.log('');
+
+  const max = options.length > 1 ? options.length + 1 : options.length;
+  let choice = '';
+  while (!Array.from({ length: max }, (_, i) => String(i + 1)).includes(choice)) {
+    choice = (await ask(rl, c.dim('  Choice [1]: '))).trim() || '1';
+  }
+
+  const targets =
+    options.length > 1 && choice === String(options.length + 1)
+      ? options
+      : [options[parseInt(choice) - 1]];
+
+  console.log('');
+  console.log(c.yellow('  ⚠  This will remove all red:proto commands and agents.'));
+  console.log(c.dim('  Your project files (features/, research/, prd.md, …) are NOT touched.'));
+  console.log('');
+
+  const confirm = (await ask(rl, c.dim('  Type "yes" to confirm: '))).trim().toLowerCase();
+  rl.close();
+
+  if (confirm !== 'yes') {
+    console.log('');
+    console.log(c.dim('  Aborted. Nothing changed.'));
+    console.log('');
+    return;
+  }
+
+  let removed = 0;
+  for (const target of targets) {
+    for (const file of COMMAND_FILES) {
+      const path = join(target.base, 'commands', file);
+      if (await exists(path)) { await rm(path); removed++; }
+    }
+    for (const file of AGENT_FILES) {
+      const path = join(target.base, 'agents', file);
+      if (await exists(path)) { await rm(path); removed++; }
+    }
+  }
+
+  console.log('');
+  console.log(c.green(`  ✓ ${removed} file(s) removed`));
+  console.log(c.dim('  red · proto has been uninstalled.'));
+  console.log('');
+}
+
+// ─── Install ─────────────────────────────────────────────────────────────────
 
 async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.includes('--uninstall') || args.includes('-u')) {
+    return runUninstall();
+  }
+
   const { version } = JSON.parse(
     await import('fs').then(fs => fs.promises.readFile(join(PACKAGE_ROOT, 'package.json'), 'utf8'))
   );
@@ -76,6 +185,28 @@ async function main() {
   const claudeBase = isGlobal ? join(homedir(), '.claude') : join(process.cwd(), '.claude');
   const label = isGlobal ? `~/.claude` : `./.claude`;
 
+  // ── Duplicate detection ────────────────────────────────────────────────────
+  const globalBase = join(homedir(), '.claude');
+  const localBase  = join(process.cwd(), '.claude');
+  const otherBase  = isGlobal ? localBase : globalBase;
+  const otherLabel = isGlobal ? './.claude' : '~/.claude';
+
+  const otherInstalled = await exists(join(otherBase, 'commands', 'red:proto.md'));
+  if (otherInstalled) {
+    console.log('');
+    console.log(c.yellow(`  ⚠  red · proto is already installed in ${otherLabel}`));
+    console.log(c.dim(`  Installing in both locations will show every command twice in Claude Code.`));
+    console.log('');
+    const proceed = (await ask(rl, c.dim('  Continue anyway? [y/N]: '))).trim().toLowerCase();
+    if (proceed !== 'y') {
+      console.log('');
+      console.log(c.dim('  Aborted. Nothing changed.'));
+      console.log('');
+      rl.close();
+      return;
+    }
+  }
+
   console.log('');
 
   // ── Step 2: Confirm if already installed ──────────────────────────────────
@@ -144,53 +275,28 @@ async function installFiles(claudeBase, isGlobal, noClobber) {
   const agentsDir = join(claudeBase, 'agents');
   const projectRoot = process.cwd();
 
-  // Create dirs
   await mkdir(commandsDir, { recursive: true });
   await mkdir(agentsDir, { recursive: true });
 
   const copyOpts = { recursive: true, force: !noClobber, errorOnExist: false };
 
-  // Commands
   const srcCommands = join(PACKAGE_ROOT, 'commands');
-  const files = [
-    'red:proto.md',
-    'red:proto-workflow.md',
-    'red:proto-sparring.md',
-    'red:proto-dev-setup.md',
-    'red:proto-research.md',
-    'red:proto-requirements.md',
-    'red:proto-flows.md',
-    'red:proto-ux.md',
-    'red:proto-architect.md',
-    'red:proto-dev.md',
-    'red:proto-qa.md',
-  ];
-
   let copied = 0;
   let skipped = 0;
 
-  for (const file of files) {
+  for (const file of COMMAND_FILES) {
     const dest = join(commandsDir, file);
     const alreadyExists = await exists(dest);
-    if (noClobber && alreadyExists) {
-      skipped++;
-      continue;
-    }
+    if (noClobber && alreadyExists) { skipped++; continue; }
     await cp(join(srcCommands, file), dest);
     copied++;
   }
 
-  // Agents
   const srcAgents = join(PACKAGE_ROOT, 'agents');
-  const agents = ['frontend-developer.md', 'backend-developer.md', 'qa-engineer.md', 'ux-reviewer.md'];
-
-  for (const file of agents) {
+  for (const file of AGENT_FILES) {
     const dest = join(agentsDir, file);
     const alreadyExists = await exists(dest);
-    if (noClobber && alreadyExists) {
-      skipped++;
-      continue;
-    }
+    if (noClobber && alreadyExists) { skipped++; continue; }
     await cp(join(srcAgents, file), dest);
     copied++;
   }

package/commands/red:proto-architect.md

@@ -134,35 +134,18 @@ AskUserQuestion({ questions: [{ question: "Passt das technische Design?", header
 ], multiSelect: false }] })
 ```
 
-Nach Approval im Chat: FEAT-[X].md erweitern (Abschnitt `## 3. Technisches Design` schreiben), YAML-Frontmatter auf `status: draft` setzen.
-
-Dann dem User sagen:
-```
-📝 Draft gespeichert: features/FEAT-[X]-[name].md
-
-Öffne die Datei, prüfe das technische Design und bearbeite es direkt falls nötig.
-
-→ Schreib `weiter` wenn alles passt
-→ Oder sag mir direkt was geändert werden soll
-```
+Nach Approval: FEAT-[X].md um Abschnitt `## 3. Technisches Design` erweitern, YAML `status: draft` setzen. User per CONVENTIONS.md §Resume Pattern informieren.
 
 ## Phase 4b: Finalisieren
 
-Nach `weiter` oder Korrekturen im Chat:
-
-1. FEAT-[X].md einlesen, Korrekturen übernehmen
-2. YAML-Frontmatter auf `status: approved` setzen
-3. `## Fortschritt` → `Status: Approved`, `Aktueller Schritt: Tech` setzen
-4. STATUS.md aktualisieren (Tech-Spalte auf ✓ setzen)
-5. Commit-Zusammenfassung zeigen und committen:
+Nach `weiter` oder Korrekturen: FEAT-[X].md einlesen, Korrekturen übernehmen, `status: approved` + `## Fortschritt → Status: Approved, Aktueller Schritt: Tech` setzen. STATUS.md (Tech-Spalte ✓).
 
 ```bash
 echo "Ich committe jetzt:"
 echo "  → features/FEAT-[X]-[name].md – Tech Design finalisiert"
 echo "  → features/STATUS.md – Tech-Status aktualisiert"
 git add features/FEAT-[X]-*.md features/STATUS.md
-git commit -m "docs: FEAT-[X] tech design – [Feature Name]"
-git push
+git commit -q -m "docs: FEAT-[X] tech design – [Feature Name]" && git push -q
 ```
 
 ## Routing nach Approval

package/commands/red:proto-dev-setup.md

@@ -84,7 +84,7 @@ Leite aus PRD-Signalen und Recherche eine **konkrete Empfehlung** ab. Präsentie
 - Web-Technologie: **Electron** oder **Tauri** (leichtgewichtiger, Rust-basiert)
 
 **Datenbank-Empfehlung** (unabhängig vom Framework):
-- Standard (relational): **PostgreSQL via Neon** (serverless, kostenlos startbar)
+- Standard (relational): **PostgreSQL via Neon** (keine eigene Server-Verwaltung, kostenlos startbar)
 - Echtzeit + Auth integriert: **Supabase**
 - Dokument-basiert: **MongoDB**
 - Kein persistentes Backend nötig: localStorage / kein DB
@@ -428,7 +428,7 @@ Installiere nur was das PRD tatsächlich braucht – keine spekulativen Packages
 **Variante A – Nur Code versionieren:**
 ```bash
 cd [codedir]
-git init
+git init -q -b main
 cat > .gitignore << 'EOF'
 node_modules/
 .env
@@ -445,14 +445,13 @@ target/
 bin/
 obj/
 EOF
-git add .
-git commit -m "chore: initial scaffold ([Stack])"
+git add . && git commit -q -m "chore: initial scaffold ([Stack])"
 ```
 
 **Variante B – Alles versionieren (Code + Projektdokumentation):**
 ```bash
 # Im Projekt-Root:
-git init
+git init -q -b main
 cat > .gitignore << 'EOF'
 node_modules/
 .env
@@ -469,8 +468,7 @@ target/
 bin/
 obj/
 EOF
-git add .
-git commit -m "chore: project setup – PRD + [Stack] scaffold"
+git add . && git commit -q -m "chore: project setup – PRD + [Stack] scaffold"
 ```
 
 Danach in beiden Varianten: initialen Tag setzen:
@@ -495,8 +493,7 @@ gh repo create [repo-name] \
   --description "[Vision-Satz aus prd.md]"
 
 # Erst pushen, dann Tags:
-git push -u origin main
-git push origin --tags
+git push -q -u origin main && git push -q origin --tags
 ```
 
 Zeige dem User die Repository-URL.

package/commands/red:proto-dev.md

@@ -111,7 +111,7 @@ grep -r "[geänderte Funktion]" [Codeverzeichnis]/ --include="*.tsx" --include="
 
 Nach allen Fixes:
 ```bash
-git add . && git commit -m "fix: FEAT-[X] – [Zusammenfassung]" && git push
+git add . && git commit -q -m "fix: FEAT-[X] – [Zusammenfassung]" && git push -q
 ```
 
 ## Phase 4.5: Selbstcheck vor Review
@@ -159,8 +159,7 @@ Status auf "Dev" setzen. STATUS.md aktualisieren.
 
 ```bash
 git add . features/STATUS.md
-git commit -m "feat: implement FEAT-[X] – [Feature Name]"
-git push
+git commit -q -m "feat: implement FEAT-[X] – [Feature Name]" && git push -q
 ```
 
 ## Phase 7: Handoff schreiben
@@ -190,7 +189,7 @@ Schreibe `context/FEAT-[ID]-dev-handoff.md` (legt Kontext für `/red:proto-qa` i
 ```bash
 mkdir -p context
 git add context/FEAT-[ID]-dev-handoff.md
-git commit -m "docs: FEAT-[X] dev handoff" && git push
+git commit -q -m "docs: FEAT-[X] dev handoff" && git push -q
 ```
 
 Sage: "Implementierung abgeschlossen. Handoff geschrieben. **Starte eine neue Session** und führe dort `/red:proto-qa FEAT-[ID]` aus. Nach einer Pause: `/red:proto-workflow` zeigt dir exakt wo du stehst."

package/commands/red:proto-flows.md

@@ -114,7 +114,7 @@ AskUserQuestion({
       multiSelect: false
     },
     {
-      question: "Gibt es weitere Einstiegspunkte (z.B. nach Login, nach Onboarding, per Deep Link)?",
+      question: "Gibt es weitere Einstiegspunkte (z.B. nach Login, nach Onboarding, oder per direktem Link z.B. aus einer E-Mail)?",
       header: "Weitere Einstiege",
       options: [
         { label: "Nein, nur ein Einstieg", description: "" },
@@ -224,31 +224,17 @@ AskUserQuestion({
 })
 ```
 
-Nach Approval im Chat: flows/product-flows.md ist bereits als Draft gespeichert (Phase 5). Dem User sagen:
-
-```
-📝 Draft gespeichert: flows/product-flows.md
-
-Öffne die Datei, prüfe alle Screens und Transitions und bearbeite direkt falls nötig.
-
-→ Schreib `weiter` wenn alles passt
-→ Oder sag mir direkt was geändert werden soll
-```
+Nach Approval: `flows/product-flows.md` ist bereits als Draft gespeichert (Phase 5). User per CONVENTIONS.md §Resume Pattern informieren.
 
 ## Phase 6b: Finalisieren
 
-Nach `weiter` oder Korrekturen im Chat:
-
-1. flows/product-flows.md einlesen, Korrekturen übernehmen
-2. YAML-Frontmatter auf `status: approved` setzen
-3. Commit-Zusammenfassung zeigen und committen:
+Nach `weiter` oder Korrekturen: `flows/product-flows.md` einlesen, Korrekturen übernehmen, `status: approved` setzen.
 
 ```bash
 echo "Ich committe jetzt:"
 echo "  → flows/product-flows.md – Screen-Inventar und Transitions finalisiert"
 git add flows/
-git commit -m "docs: product flows – screen inventory + transitions"
-git push
+git commit -q -m "docs: product flows – screen inventory + transitions" && git push -q
 ```
 
 Sage dem User: "Flows dokumentiert. Nächster Schritt: `/red:proto-ux` für jedes Feature (einmal pro Feature) – die Transitions aus `flows/product-flows.md` sind die verbindliche Referenz.

package/commands/red:proto-qa.md

@@ -146,8 +146,8 @@ STATUS.md: QA-Wert auf `✓`.
 
 ```bash
 git add . features/STATUS.md
-git commit -m "release: v[X.Y.Z] – FEAT-[X] [Feature Name]"
-git tag v[X.Y.Z] && git push && git push origin --tags
+git commit -q -m "release: v[X.Y.Z] – FEAT-[X] [Feature Name]"
+git tag v[X.Y.Z] && git push -q && git push -q origin --tags
 ```
 
 Sage: "v[X.Y.Z] getaggt. FEAT-[X] ist Production-Ready. Nächstes Feature: `/red:proto-requirements`. Nach Pause: `/red:proto-workflow`."

package/commands/red:proto-requirements.md

@@ -193,25 +193,11 @@ AskUserQuestion({
 })
 ```
 
-Nach Approval im Chat: Feature-File als Draft speichern. `project-config.md` aktualisieren (Nächste freie ID um 1 erhöhen).
-
-Dann dem User sagen:
-```
-📝 Draft gespeichert: features/FEAT-[X]-[name].md
-
-Öffne die Datei, prüfe sie und bearbeite sie direkt falls nötig.
-
-→ Schreib `weiter` wenn alles passt
-→ Oder sag mir direkt was geändert werden soll
-```
+Nach Approval: Feature-File als Draft speichern. `project-config.md` aktualisieren (Nächste freie ID um 1 erhöhen). User per CONVENTIONS.md §Resume Pattern informieren.
 
 ## Phase 7b: Finalisieren
 
-Nach `weiter` oder Korrekturen im Chat:
-
-1. Feature-File einlesen, eventuelle Korrekturen übernehmen
-2. YAML-Frontmatter auf `status: approved` setzen
-3. `## Fortschritt` → `Status: Approved` setzen
+Nach `weiter` oder Korrekturen: Feature-File einlesen, Korrekturen übernehmen, `status: approved` + `## Fortschritt → Status: Approved` setzen.
 
 **STATUS.md aktualisieren:** Lies `features/STATUS.md`. Wenn die Datei noch nicht existiert, erstelle sie mit diesem Header:
 
@@ -236,8 +222,7 @@ echo "  → features/FEAT-[X]-[name].md – Spec finalisiert"
 echo "  → features/STATUS.md – Feature eingetragen"
 echo "  → project-config.md – Nächste ID aktualisiert"
 git add features/FEAT-[X]-*.md features/STATUS.md project-config.md
-git commit -m "docs: FEAT-[X] spec – [Feature Name]"
-git push
+git commit -q -m "docs: FEAT-[X] spec – [Feature Name]" && git push -q
 ```
 
 Sage dem User:

package/commands/red:proto-research.md

@@ -373,54 +373,11 @@ AskUserQuestion({
 })
 ```
 
-Nach Approval: Problem Statement Map und Personas als Drafts speichern.
-
-`research/problem-statement.md`:
-```markdown
----
-status: draft
----
-
-# Problem Statement Map
-*Erstellt von: /red:proto-research — [Datum]*
-
-[Inhalt aus Phase 4]
-```
-
-`research/personas.md`:
-```markdown
----
-status: draft
----
-
-# Personas
-*Erstellt von: /red:proto-research — [Datum]*
-
-[Inhalt aus Phase 5]
-```
-
-Dann dem User sagen:
-```
-📝 Drafts gespeichert:
-  → research/problem-statement.md
-  → research/personas.md
-  (+ research/platform-context.md und research/research-questions.md falls noch offen)
-
-Kurze Pause?
-→ Schreib `weiter` wenn du alle Dateien geprüft hast
-
-Echter Research (Interviews, Umfragen, Tage)?
-→ Trag deine Findings direkt in die Dateien ein
-→ Dann /red:proto-research erneut aufrufen – ich erkenne die Drafts automatisch
-```
+Nach Approval: Problem Statement Map und Personas als Drafts speichern (YAML `status: draft`, Header mit Dateinamen und Datum). User per CONVENTIONS.md §Resume Pattern (Option 2 – Research) informieren.
 
 ## Phase 6b: Finalisieren
 
-Nach `weiter` oder Korrekturen im Chat:
-
-1. Alle Research-Dateien lesen und eventuelle Chat-Korrekturen einarbeiten
-2. YAML-Frontmatter in allen Dateien auf `status: approved` setzen
-3. Zusammenfassung zeigen und committen:
+Nach `weiter` oder Korrekturen: Alle Research-Dateien einlesen, Korrekturen übernehmen, `status: approved` in allen Dateien setzen.
 
 ```bash
 echo "Ich committe jetzt:"
@@ -429,8 +386,7 @@ echo "  → research/research-questions.md – Forschungsfragen & Antworten"
 echo "  → research/problem-statement.md – Problem Statement Map"
 echo "  → research/personas.md – Personas"
 git add research/
-git commit -m "docs: add user research, personas and problem statement"
-git push
+git commit -q -m "docs: add user research, personas and problem statement" && git push -q
 ```
 
 Prüfe den aktuellen Stand:

package/commands/red:proto-sparring.md

@@ -92,50 +92,21 @@ AskUserQuestion({
 
 ## Phase 4: Als Draft speichern
 
-> Lies zuerst `docs/CONVENTIONS.md` für die verbindlichen Draft/Approval/Resume-Regeln.
+> Lies `docs/CONVENTIONS.md` – Draft Convention + Resume Pattern (Option 1) gelten hier.
 
-Nach Approval: Speichere das PRD als Draft in `/prd.md`. YAML-Frontmatter `status: draft` ergänzen. Notiere den gewählten Scope (Prototyp-Typ) im PRD unter einem neuen Abschnitt:
-
-```markdown
----
-status: draft
----
-
-# Product Requirements Document
-...
-
-## Scope-Typ
-[Klickbarer Prototyp | Funktionierender Prototyp | Produktionsreifes MVP | Unklar]
-```
-
-Dann dem User sagen:
-```
-📝 Draft gespeichert: prd.md
-
-Öffne die Datei, prüfe sie und bearbeite sie direkt falls nötig.
-
-→ Schreib `weiter` wenn alles passt
-→ Oder sag mir direkt was geändert werden soll
-```
+Nach Approval: Speichere `prd.md` als Draft. YAML `status: draft`. Scope-Typ als Abschnitt `## Scope-Typ` ergänzen. User per CONVENTIONS.md §Resume Pattern informieren.
 
 ## Phase 4b: Finalisieren
 
-Nach `weiter` oder Korrektur im Chat:
-
-1. Datei einlesen: `cat prd.md`
-2. Falls Korrekturen im Chat: Änderungen in prd.md übernehmen
-3. YAML-Frontmatter auf `status: approved` setzen
-4. Commit (nur wenn Git bereits initialisiert ist – bei Erstnutzung noch nicht vorhanden):
+Nach `weiter` oder Korrekturen: `prd.md` einlesen, Korrekturen übernehmen, `status: approved` setzen.
 
 ```bash
 if git rev-parse --git-dir > /dev/null 2>&1; then
   echo "Ich committe jetzt:"
   echo "  → prd.md – PRD finalisiert"
-  git add prd.md
-  git commit -m "docs: add/update PRD"
-  git push
+  git add prd.md && git commit -q -m "docs: add/update PRD" && git push -q
 else
-  echo "Kein Git-Repository – prd.md wurde gespeichert. /red:proto-dev-setup richtet Git ein und macht den ersten Commit."
+  echo "Kein Git-Repository – prd.md gespeichert. /red:proto-dev-setup macht den ersten Commit."
 fi
 ```
 

package/commands/red:proto-ux.md

@@ -176,35 +176,18 @@ AskUserQuestion({ questions: [{ question: "UX-Entscheidungen vollständig?", hea
 ], multiSelect: false }] })
 ```
 
-Nach Approval im Chat: FEAT-[X].md erweitern (Abschnitt `## 2. UX Entscheidungen` schreiben), YAML-Frontmatter auf `status: draft` setzen.
-
-Dann dem User sagen:
-```
-📝 Draft gespeichert: features/FEAT-[X]-[name].md
-
-Öffne die Datei, prüfe die UX-Entscheidungen und bearbeite sie direkt falls nötig.
-
-→ Schreib `weiter` wenn alles passt
-→ Oder sag mir direkt was geändert werden soll
-```
+Nach Approval: FEAT-[X].md um Abschnitt `## 2. UX Entscheidungen` erweitern, YAML `status: draft` setzen. User per CONVENTIONS.md §Resume Pattern informieren.
 
 ## Phase 7b: Finalisieren
 
-Nach `weiter` oder Korrekturen im Chat:
-
-1. FEAT-[X].md einlesen, Korrekturen übernehmen
-2. YAML-Frontmatter auf `status: approved` setzen
-3. `## Fortschritt` → `Status: Approved`, `Aktueller Schritt: UX` setzen
-4. STATUS.md aktualisieren (UX-Spalte auf ✓ setzen)
-5. Commit-Zusammenfassung zeigen und committen:
+Nach `weiter` oder Korrekturen: FEAT-[X].md einlesen, Korrekturen übernehmen, `status: approved` + `## Fortschritt → Status: Approved, Aktueller Schritt: UX` setzen. STATUS.md (UX-Spalte ✓).
 
 ```bash
 echo "Ich committe jetzt:"
 echo "  → features/FEAT-[X]-[name].md – UX Entscheidungen finalisiert"
 echo "  → features/STATUS.md – UX-Status aktualisiert"
 git add features/FEAT-[X]-*.md flows/product-flows.md features/STATUS.md 2>/dev/null
-git commit -m "docs: FEAT-[X] ux design – [Feature Name]"
-git push
+git commit -q -m "docs: FEAT-[X] ux design – [Feature Name]" && git push -q
 ```
 
 ## Routing nach Approval

package/design-system/INDEX.md

@@ -0,0 +1,50 @@
+# Design System – Index
+
+Lade dieses File zuerst. Dann nur die Files, die für das aktuelle Feature relevant sind.
+
+---
+
+## Tokens
+
+| File | Inhalt | Wann laden |
+|------|--------|------------|
+| `tokens/colors.md` | Primär-, Sekundär-, Semantic-, Neutral-Farben + Surface-Aliases | Immer bei visueller Implementierung |
+| `tokens/typography.md` | Schriftgrößen, Gewichte, Line-Heights, Font-Stack | Bei Text-Styling |
+| `tokens/spacing.md` | Spacing-Scale (4px-Basis), Named Sizes (xs–2xl) | Bei Layout, Abstände, Padding |
+| `tokens/shadows.md` | Elevation-System (sm, md, lg, xl) | Bei Cards, Modals, Dropdowns |
+| `tokens/motion.md` | Transitions, Durations, Easing-Kurven | Bei Animationen, Hover-Effekten |
+
+## Komponenten
+
+| File | Varianten | Zustände | Wann laden |
+|------|-----------|----------|------------|
+| `components/button.md` | primary, secondary, ghost, danger, link | default, hover, focus, active, disabled, loading | Bei jeder Aktion/Button |
+| `components/input.md` | text, password, textarea, select | default, focus, error, disabled | Bei Formularen |
+| `components/card.md` | default, interactive, flat | default, hover | Bei Card-Layouts |
+
+## Patterns
+
+| File | Enthält | Wann laden |
+|------|---------|------------|
+| `patterns/navigation.md` | Header, Sidebar, Breadcrumb, Tab-Navigation | Bei Navigation-Implementierung |
+| `patterns/forms.md` | Formular-Aufbau, Validation, Fehlermeldungen | Bei Formularen |
+| `patterns/feedback.md` | Toasts, Modals, Loading States, Empty States | Bei Feedback-Elementen |
+| `patterns/data-display.md` | Tabellen, Listen, Cards, Badges | Bei Datendarstellung |
+
+---
+
+## Laderegel für Agents
+
+1. Lies dieses INDEX.md
+2. Identifiziere welche Tokens/Komponenten/Patterns das Feature braucht
+3. Lade **nur diese Files** – nicht alles auf einmal
+4. Nicht definierte Elemente: pragmatisch mit vorhandenen Tokens bauen, im Feature-File unter `## Offene Punkte` dokumentieren
+
+## Status
+
+| Bereich | Status |
+|---------|--------|
+| Tokens | Beispielwerte – vor Projektstart durch eigene Werte ersetzen |
+| Komponenten | 3 Basiskomponenten vorhanden (Button, Input, Card) |
+| Patterns | 4 Patterns vorhanden |
+| Screens | Leer – Figma-Exports hier ablegen |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "red-proto",
-  "version": "0.11.0",
+  "version": "0.13.2",
   "description": "AI-powered product development framework for Claude Code – from idea to tested prototype",
   "bin": {
     "red-proto": "./bin/install.js"