claude-workflow/.claude/plans/workflow-simplification.md

Plan: Workflow-Vereinfachung — Single Source of Truth

Ziel: CLAUDE.md ist die einzige normative Quelle. Alle redundanten Dokumentations-Dateien werden entfernt. Einzigartiger Inhalt aus SETUP.md wird vorher in CLAUDE.md integriert.

---

Phase 1 — CLAUDE.md erweitern (vor dem Löschen)

Folgende Inhalte aus SETUP.md in CLAUDE.md einbauen, die dort noch fehlen:

• Einrichtung (2 Schritte):

  git clone https://gitea.troeger-net.org/martin/claude-workflow.git /mnt/projekte/claude-workflow
  /mnt/projekte/claude-workflow/bootstrap.sh
  

• Voraussetzungen-Tabelle (tatsächliche aus bootstrap.sh, nicht die veraltete aus SETUP.md):
  • jq — Statusline-Parsing (apt install jq)
  • ruff — Python-Formatter (pip install ruff / pipx)
  • eslint — JS/TS/Vue-Formatter (projektabhängig)
  • secret-tool — Token abrufen (apt install libsecret-tools)
  • gh — GitHub CLI (aus bootstrap.sh)
  • go + gitea-mcp — Gitea-MCP-Binary (aus bootstrap.sh)
• Gitea-Token einrichten:

  secret-tool store --label="Gitea claude-code Token" user claude-code token gitea
  

• Sync-Workflow (Pull/Push zwischen Rechnern) — falls gewünscht

Empfohlener Platz in CLAUDE.md: neuer Abschnitt ## Einrichtung direkt nach dem bestehenden ## Zweck-Block.

---

Phase 2 — Dateien löschen

# Gesamten workflow/-Ordner entfernen
rm -rf /mnt/projekte/claude-workflow/workflow/

# Root-README entfernen (nur 1 Zeile "# Claude Workflow")
rm /mnt/projekte/claude-workflow/README.md

# SETUP.md entfernen (Inhalt wurde in CLAUDE.md integriert)
rm /mnt/projekte/claude-workflow/SETUP.md

---

Phase 3 — CLAUDE.md-Verweise bereinigen

Nach dem Löschen folgende Stellen in /mnt/projekte/claude-workflow/CLAUDE.md anpassen:

• Zeile "## Struktur" (workflow/ im Verzeichnisbaum): Eintrag entfernen
• Zeile "workflow/ ← Referenzdokumentation (täglich lesen)": entfernen
• Zeile "workflow/README.md ← Schnellreferenz": entfernen
• Zeile "workflow/models.md ← Modell-Strategie + Kostenmatrix": entfernen
• Zeile "workflow/story-lifecycle.md ← Story-Phasen im Detail": entfernen
• Abschnitt "Workflow-Weiterentwicklung" (Zeile mit https://github.com/shanraisshan/...): WebFetch-Anweisung bleibt, aber Verweis auf workflow/-Vergleich entfernen
• SETUP.md → bootstrap.sh im Aktivierungs-Block: bereits korrekt, nur Verweis auf "siehe SETUP.md" entfernen

---

Phase 4 — Weitere bekannte Inkonsistenzen beheben (aus workflow-review)

Priorität 1 (kritisch)

• CLAUDE.md, Abschnitt "Aktivierung (nach Neuinstallation)": Veralteten Symlink-Block komplett ersetzen durch:

  Nach System-Neuinstallation `bootstrap.sh` ausführen (erstellt alle Symlinks automatisch).
  

• skills/go/SKILL.md, Schritt 3: Gitea-API via secret-tool+curl ersetzen durch mcp__gitea__pull_request_write. Den Token-Hinweis in CLAUDE.md Zeile 107 auf "Token für Gitea-MCP" umformulieren.

• skills/story/SKILL.md, Phase 4: Branch-Präfix feature/ → feat/ (konsistent mit /ship).

• skills/story/SKILL.md, Phase 5: Nach /go fehlen Security-Audit und /ship. Ergänzen:

  • Phase 6: security-audit-Agent starten
  • Phase 7: /ship aufrufen

• skills/go/SKILL.md, Schritt 2: Verweis auf code-simplifier-Agent präzisieren → "simplify-Skill (Plugin) aufrufen".

• agents/test-runner.md: Frontmatter model: auf claude-haiku-4-5-20251001 setzen.

• agents/security-audit.md: Frontmatter model: auf claude-opus-4-7 setzen.

• agents/n8n-architect.md: Veraltete Frontmatter-Keys (mcpServers, tools: [fs, terminal, git, editor], skills:, memory:, permissionMode:) ersetzen durch Standard-Schema: tools: Bash, Read, Write, Edit, Glob, Grep.

• dotfiles/settings.json, permissions.allow: Bash(curl:*) entfernen (widerspricht globaler Regel gegen curl-Workarounds).

• skills/workflow-review/SKILL.md, Schritt 1: find-Befehl ersetzen durch Glob-Tool-Anweisung (**/*.md).

Priorität 2 (Konsistenz)

• agents/plan-reviewer.md, Schritt 1: Pfad /home/martin/.claude/plans/ → .claude/plans/ des aktuellen Projekts (oder Kontext aus EnterPlanMode).

• skills/go/SKILL.md, Frontmatter: model: claude-haiku-4-5-20251001 setzen.

• skills/story/SKILL.md, Frontmatter: model: claude-opus-4-7 setzen; manuelle "/model opus"-Anweisung in Phase 2 entfernen.

• skills/plan-review/SKILL.md, Frontmatter: model: claude-opus-4-7 ergänzen (konsistent mit workflow-review-Skill).

• hooks/auto-format.sh, Zeile 26: Vor npx eslint prüfen ob node_modules/.bin/eslint existiert, sonst überspringen.

---

Abschluss

Nach allen Änderungen: /ship aufrufen (Feature-Branch feat/workflow-simplification).