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:
@@ -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`)
|
||||
|
||||
Reference in New Issue
Block a user