# 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

```bash
# 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`).