refactor: Konsolidiere Workflow-Dokumentation in CLAUDE.md, lösche redundante Dateien
- Verschiebe alle Inhalte aus workflow/ (README, models, story-lifecycle, plan) in CLAUDE.md - Lösche SETUP.md (redundant mit CLAUDE.md Aktivierungsabschnitt) - Vereinfache Agent/Skill-Dokumentation (Querverweis zu CLAUDE.md statt Details) - Aktualisiere Hooks-Dokumentation für neue Struktur - Zentralisiere Skills/Agents/Hooks in einer Datei (Single Source of Truth) Verifiziert durch: Manuelle Überprüfung aller Querverweis-Pfade, lokale Tests laufen ✓ Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,107 @@
|
||||
# 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`).
|
||||
Reference in New Issue
Block a user