martinandClaude Sonnet 4.6
4bde91a54b
- 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>
4.8 KiB
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Zweck
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)
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
secret-tool store --label="Gitea claude-code Token" user claude-code token gitea
Sync zwischen Rechnern
Pushen (Rechner 1):
cd /mnt/projekte/claude-workflow
git add -p && git commit -m "..." && git push
Übernehmen (Rechner 2):
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:
https://github.com/shanraisshan/claude-code-best-practice
Vorgehen: URL via WebFetch abrufen → mit aktuellem Workflow vergleichen → Abweichungen bewerten → bei Bedarf anpassen.
Struktur
skills/ ← Slash-Commands (Symlinks nach ~/.claude/skills/)
agents/ ← Agenten-Definitionen (Symlinks nach ~/.claude/agents/)
hooks/ ← Shell-Hooks (durch settings.json registriert)
dotfiles/ ← ~/.claude/CLAUDE.md, settings.json, statusline-command.sh
bootstrap.sh ← Einrichtungsskript
Aktivierung (nach Neuinstallation)
Nach System-Neuinstallation bootstrap.sh ausführen (erstellt alle Symlinks automatisch).
Story-Lifecycle
Research → Plan (Opus) → /plan-review → Implement (Sonnet) → /go → Security-Audit
Kurzbefehl für den gesamten Ablauf: /story
| Phase | Befehl | Modell |
|---|---|---|
| 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.6 |
Skills
| Befehl | Datei | Beschreibung |
|---|---|---|
/go |
skills/go/SKILL.md |
test-runner → code-simplifier → Gitea-PR |
/ship |
skills/ship/SKILL.md |
Commit → Push → PR → Merge → Cleanup (finales Kommando) |
/plan-review |
skills/plan-review/SKILL.md |
Startet plan-reviewer-Agent (Opus, fork) |
/story |
skills/story/SKILL.md |
Voller Lifecycle von Research bis PR |
/workflow-review |
skills/workflow-review/SKILL.md |
Opus reviewt alle Skills/Konfig → Umsetzungsplan für Sonnet |
Agenten
| Agent | Modell | Tools | Rolle |
|---|---|---|---|
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 |
Hooks
| Event | Trigger | Skript | Aktion |
|---|---|---|---|
PostToolUse |
Edit / Write | hooks/auto-format.sh |
ruff (Python) oder eslint --fix (JS/TS/Vue) |
Stop |
Session-Ende | hooks/verify-on-stop.sh |
Uncommittete Änderungen anzeigen |
auto-format.sh liest den Dateipfad aus $CLAUDE_TOOL_INPUT_FILE_PATH und erkennt den Typ anhand der Dateiendung.
Modell-Strategie
- 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.6 mit schnellerer Ausgabe — sinnvoll bei langen Implementierungen.
Kontext-Management
- < 200k Tokens: Normal weiterarbeiten
- 200–350k Tokens:
/compact "aktueller Stand: [Hinweis]"ausführen - > 350k Tokens: Neue Session, isolierte Subagenten bevorzugen
Gitea-Integration
- Instanz:
https://gitea.troeger-net.org - Token für Gitea-MCP:
$(secret-tool lookup user claude-code token gitea) - MCP-Server
giteamuss aktiv sein (Binary:~/go/bin/gitea-mcp)