Projektübergreifende Agent-Konfiguration einmal pflegen.

Projektübergreifende KI-Wünsche einmal pflegen statt in jeder CLAUDE.md wiederholen. Skills, Agents und globale Regeln als versioniertes Repo – per Symlink in Claude Code und Codex eingebunden.

GitHub

Projektübergreifende KI-Wünsche einmal pflegen statt in jeder CLAUDE.md wiederholen. Skills, Agents und globale Regeln als versioniertes Repo – per Symlink in Claude Code und Codex eingebunden.

GLOBAL.md 18 Skills Claude Code Codex Pre-commit Hook Auto-generiertes TOML MIT-Lizenz


git clone git@github.com:casoon/ai-agent-config.git ~/ai-agent-config

Einmal definieren – überall wirksam

Wer mit mehreren Projekten arbeitet, wiederholt sich: Arbeitsstil, Qualitätsregeln, Commit-Konventionen – irgendwo steht das in jeder CLAUDE.md nochmal. Ändert sich etwas, müssen alle Projekte einzeln angefasst werden.

ai-agent-config zentralisiert genau diese übergreifenden Wünsche. Projektspezifische CLAUDE.md-Dateien werden kürzer und fokussierter – sie beschreiben nur noch, was dieses Projekt besonders macht. Der Rest kommt aus dem zentralen Repo, einmal gepflegt, sofort in allen Projekten wirksam.

Repo-Struktur

Eine GLOBAL.md für beide Tools. Agents als Markdown gepflegt, für Codex automatisch als TOML generiert. Update per git pull.

ai-agent-config/

ai-agent-config/
├─ GLOBAL.md ← Claude Code & Codex
├─ agents/ ← Quelldateien (Markdown)
│  ├─ planner.md
│  ├─ implementer.md
│  └─ reviewer.md
├─ codex-agents/ ← Auto-generiert (TOML)
│  └─ planner.toml ...
├─ codex-config.toml
├─ skills/ ← 18 Domain-Skills
│  ├─ astro-architecture/
│  ├─ tailwind-ui/
│  └─ ... (16 weitere)
└─ install/
 └─ link-all.sh

Das 4-Schichten-Modell

Jede Schicht hat genau das, was auf sie gehört. Keine Vermischung, kein Kontext-Ballast.

Global = Verhalten

Persönliche Arbeitsweise

Wie du arbeitest: erst analysieren, dann ändern. Kleine Diffs. Keine neuen Abhängigkeiten ohne Grund. Gilt in jedem Projekt gleich.

GLOBAL.md → ~/.claude/CLAUDE.md & ~/.codex/AGENTS.md

Skill = Fachwissen

Stack-spezifisches Wissen

18 kurierte Domain-Skills: Astro, Tailwind, Biome, SEO, Accessibility, Playwright, Dark Mode und mehr – werden nur geladen, wenn sie gebraucht werden.

skills/astro-architecture/SKILL.md

Repo = Wahrheit

Projektspezifische Regeln

Ordnerstruktur, Commands, Architekturgrenzen, Naming-Konventionen – was nur für dieses Repo gilt, gehört ins Repo.

CLAUDE.md (im Projekt)

Agent = Rolle

Spezialisierte Rollen

Planner, Implementer, Reviewer als Markdown-Quelldateien – für Codex automatisch als TOML generiert. Einmal pflegen, beide Tools nutzen es.

agents/reviewer.md → codex-agents/reviewer.toml

GLOBAL.md – eine Datei für beide Tools

Kurz genug, um immer geladen zu werden. Wird als CLAUDE.md und AGENTS.md eingebunden.

GLOBAL.md

## Core principles
- Do exactly what is asked — no more, no less.
- Prefer modifying existing code over adding new files.
- Minimize surface area of changes.
 
## Working style
- Start non-trivial tasks with a brief plan.
- Break work into small, reviewable steps.
- State assumptions explicitly when requirements are unclear.
 
## Scope control
- Do not fix unrelated issues.
- Do not reformat unrelated code.
- Do not refactor outside the task scope.
 
## Validation
- Run targeted checks first: typecheck, lint, focused tests.
- Mention what was validated and what was not.

Stack-Wissen kommt in Skills. Repo-Regeln ins Repo. Die globale Datei bleibt schlank.

Der Pre-commit Hook scannt jeden Commit mit nosecrets – Secrets gelangen nicht in die Versionsgeschichte.

Fünf spezialisierte Rollen

Agents sind Rollen, keine Wissensdatenbanken. Das Fachwissen steckt in Skills.

planner

Zerlegt Aufgaben in Schritte, benennt Risiken, schlägt den kleinsten sinnvollen Implementierungspfad vor.

implementer

Setzt gezielt um. Kleiner Diff, bestehende Architektur erhalten, keine stillen Umstrukturierungen.

reviewer

Prüft auf Korrektheit, Regressionen, Wartbarkeit und Architekturbrüche. Ergebnis nach Severity gruppiert.

explorer

Durchsucht den Codebase kontextisoliert. Gibt eine direkte Antwort mit file:line-Referenzen zurück – ohne rohen Dateiinhalt in den Hauptkontext zu laden.

security-auditor

Prüft defensiv auf Injection, Authn/Authz, Secret-Handling und Input-Validierung. Unterscheidet Critical / Warning / Hardening. Schreibt keine Exploits.

Einrichten in zwei Schritten

Klonen und verlinken. Update per git pull.

install/link-all.sh

# Klonen
git clone git@github.com:casoon/ai-agent-config.git ~/ai-agent-config
 
# Symlinks setzen (Claude Code + Codex)
cd ~/ai-agent-config && ./install/link-all.sh
 
# Pre-commit Hook aktivieren
git config core.hooksPath .githooks
 
# Später aktualisieren
cd ~/ai-agent-config && git pull

Das Konzept im Detail

Das 4-Schichten-Modell, der Unterschied zwischen Claude Code und Codex, warum Skills besser sind als riesige globale Dateien – ausführlich erklärt im Insights-Blog.

Artikel lesen