red-proto 0.11.0 → 0.12.0

package/README.md

@@ -65,8 +65,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

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

@@ -161,8 +161,7 @@ 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

@@ -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

@@ -247,8 +247,7 @@ Nach `weiter` oder Korrekturen im Chat:
 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

@@ -236,8 +236,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

@@ -429,8 +429,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-ux.md

@@ -203,8 +203,7 @@ 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/package.json

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