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:
2026-04-19 15:13:09 +02:00
co-authored by Claude Sonnet 4.6
parent 6cb472992f
commit 4bde91a54b
18 changed files with 205 additions and 527 deletions
+53 -24
View File
@@ -6,6 +6,49 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
Dieses Repository enthält die globale Claude-Code-Workflow-Konfiguration für alle Projekte von Martin Tröger. Es definiert Skills, Agenten, Hooks und Dokumentation — kein ausführbarer Anwendungscode.
## Einrichtung
### Neuer Rechner (2 Schritte)
```bash
git clone https://gitea.troeger-net.org/martin/claude-workflow.git /mnt/projekte/claude-workflow
/mnt/projekte/claude-workflow/bootstrap.sh
```
Das Bootstrap-Skript installiert alle Tools, erstellt alle Symlinks und richtet den Gitea-Token ein.
### Voraussetzungen
| Tool | Zweck | Installieren |
|---|---|---|
| `jq` | Statusline-Parsing | `apt install jq` |
| `ruff` | Python-Formatter (Hook) | `pipx install ruff` |
| `eslint` | JS/TS/Vue-Formatter (Hook) | Projektabhängig |
| `secret-tool` | Gitea-Token abrufen | `apt install libsecret-tools` |
| `gh` | GitHub CLI | `apt install gh` |
| `go` + `gitea-mcp` | Gitea-MCP-Binary | `go install gitea.com/gitea/gitea-mcp@latest` |
### Gitea-Token einrichten
```bash
secret-tool store --label="Gitea claude-code Token" user claude-code token gitea
```
### Sync zwischen Rechnern
**Pushen (Rechner 1):**
```bash
cd /mnt/projekte/claude-workflow
git add -p && git commit -m "..." && git push
```
**Übernehmen (Rechner 2):**
```bash
cd /mnt/projekte/claude-workflow && git pull
```
Da alles über Symlinks verbunden ist, sind Änderungen sofort aktiv.
## Workflow-Weiterentwicklung
Beim Aktualisieren dieses Workflows immer zuerst die externe Best-Practice-Referenz konsultieren und auf relevante Neuerungen prüfen:
@@ -17,30 +60,16 @@ Vorgehen: URL via `WebFetch` abrufen → mit aktuellem Workflow vergleichen →
## Struktur
```
workflow/ ← Referenzdokumentation (täglich lesen)
README.md ← Schnellreferenz: Welcher Befehl für welche Phase
models.md ← Modell-Strategie + Kostenmatrix
story-lifecycle.md ← Story-Phasen im Detail
skills/ ← Slash-Commands (Symlinks nach ~/.claude/skills/)
agents/ ← Agenten-Definitionen (Symlinks nach ~/.claude/agents/)
hooks/ ← Shell-Hooks (durch settings.json registriert)
SETUP.md Einrichtung nach System-Neuinstallation
dotfiles/~/.claude/CLAUDE.md, settings.json, statusline-command.sh
bootstrap.sh ← Einrichtungsskript
```
## Aktivierung (nach Neuinstallation)
```bash
# Skills und Agent verlinken
ln -sf /mnt/projekte/claude-workflow/skills/go.md ~/.claude/skills/go.md
ln -sf /mnt/projekte/claude-workflow/skills/plan-review.md ~/.claude/skills/plan-review.md
ln -sf /mnt/projekte/claude-workflow/skills/story.md ~/.claude/skills/story.md
ln -sf /mnt/projekte/claude-workflow/agents/plan-reviewer.md ~/.claude/agents/plan-reviewer.md
# Hook-Skripte ausführbar machen
chmod +x /mnt/projekte/claude-workflow/hooks/*.sh
```
Die `hooks`-Sektion in `~/.claude/settings.json` manuell eintragen (siehe `SETUP.md`).
Nach System-Neuinstallation `bootstrap.sh` ausführen (erstellt alle Symlinks automatisch).
## Story-Lifecycle
@@ -52,12 +81,12 @@ Kurzbefehl für den gesamten Ablauf: `/story`
| Phase | Befehl | Modell |
|---|---|---|
| Planung | `EnterPlanMode` | Opus 4.7 |
| Plan-Review | `/plan-review` | Opus 4.7 (Subagent) |
| Planung | `EnterPlanMode` | Opus 4.6 |
| Plan-Review | `/plan-review` | Opus 4.6 (Subagent) |
| Implementierung | direkt | Sonnet 4.6 |
| Test + Simplify + PR | `/go` | Haiku / Sonnet (Subagenten) |
| Commit + PR + Merge | `/ship` | Sonnet (fork) |
| Security-Audit | `security-audit`-Agent | Opus 4.7 |
| Security-Audit | `security-audit`-Agent | Opus 4.6 |
## Skills
@@ -73,7 +102,7 @@ Kurzbefehl für den gesamten Ablauf: `/story`
| Agent | Modell | Tools | Rolle |
|---|---|---|---|
| `plan-reviewer` | Opus 4.7 | Read, Glob, Grep | Prüft Pläne auf Vollständigkeit, Risiken, fehlende Tests |
| `plan-reviewer` | Opus 4.6 | Read, Glob, Grep | Prüft Pläne auf Vollständigkeit, Risiken, fehlende Tests |
| `test-runner` | Sonnet | alle | Tests ausführen, Coverage prüfen |
| `security-audit` | Sonnet | alle | OWASP-Analyse, Security-Tests schreiben |
| `n8n-architect` | Sonnet | alle | n8n-Workflow-Design und Refactoring |
@@ -89,11 +118,11 @@ Kurzbefehl für den gesamten Ablauf: `/story`
## Modell-Strategie
- **Opus 4.7**: Planung, Plan-Review, Security-Audit — überall wo Fehlentscheidungen teuer sind
- **Opus 4.6**: Planung, Plan-Review, Security-Audit — überall wo Fehlentscheidungen teuer sind
- **Sonnet 4.6**: Implementierung, Refactoring, Bug-Fixes (Standard)
- **Haiku 4.5**: Tests, Lint, Format, PR-Beschreibung
`/fast` aktiviert Opus 4.7 mit schnellerer Ausgabe — sinnvoll bei langen Implementierungen.
`/fast` aktiviert Opus 4.6 mit schnellerer Ausgabe — sinnvoll bei langen Implementierungen.
## Kontext-Management
@@ -104,5 +133,5 @@ Kurzbefehl für den gesamten Ablauf: `/story`
## Gitea-Integration
- Instanz: `https://gitea.troeger-net.org`
- Token für `/go`-Skill: `$(secret-tool lookup user claude-code token gitea)`
- Token für Gitea-MCP: `$(secret-tool lookup user claude-code token gitea)`
- MCP-Server `gitea` muss aktiv sein (Binary: `~/go/bin/gitea-mcp`)