Einmal pflegen,
überall geladen
Globale Anweisungen, Subagents und Skills in einem Repo. Symlinks binden sie in Claude Code, Codex und Mistral Vibe ein – eine Änderung hier gilt sofort in jedem Tool.
Übergreifende Regeln gehören nicht in jede CLAUDE.md.
Wer in vielen Projekten mit Coding-Agenten arbeitet, schreibt dieselben Regeln immer wieder auf: Arbeitsstil, Scope, Validierung, Commit-Konventionen. ai-agent-config hält diese Ebene in einem Repo. Projekt-Dateien werden kürzer und beschreiben nur noch, was das jeweilige Projekt besonders macht.
github.com/casoon/ai-agent-config →- 01Eine GLOBAL.md — wird zu
~/.claude/CLAUDE.mdund~/.codex/AGENTS.md - 02Agents als Markdown — für Codex per Skript als TOML erzeugt
- 03Skills nach Bedarf — ein Ordner mit
SKILL.mdpro Thema - 04Symlinks statt Kopien — eine Änderung im Repo ist sofort aktiv
Jede Regel an ihrem Ort.
Das Repo verwaltet die globale Ebene. Projekt- und Sitzungsgedächtnis bleiben bewusst draußen.
- 01
Global = Verhalten
Wie gearbeitet wird: erst planen, kleine Diffs, keine neuen Abhängigkeiten ohne Grund. Kurz genug, um immer geladen zu werden. →
GLOBAL.md - 02
Skill = Fachwissen
Astro, Tailwind, Biome, SEO, Barrierefreiheit, Cloudflare, Texte – geladen erst, wenn eine Aufgabe es braucht. →
skills/ - 03
Agent = Rolle
Planner, Implementer, Reviewer, Explorer, Security-Auditor. Rollen, keine Wissensspeicher. →
agents/ - 04
Repo = Wahrheit
Ordnerstruktur, Befehle und Architekturgrenzen eines Projekts. Das gehört in dessen eigene
CLAUDE.md, nicht hierher.
Ein neutraler Baum für alle Tools.
ai-agent-config/
├── GLOBAL.md # → CLAUDE.md / AGENTS.md
├── agents/ # subagent sources (Markdown)
├── codex-agents/ # generated from agents/
├── skills/ # one folder with SKILL.md each
├── codex-config.example.toml
├── scripts/
│ └── render-codex-agents.py
├── .githooks/
│ └── pre-commit
└── install/
├── link-all.sh
├── link-claude.sh
├── link-codex.sh
└── link-mistral.sh## Core principles
- Do exactly what is asked — no more, no less.
- Prefer modifying existing code over adding new files.
- Minimize surface area of changes.
- Avoid speculative improvements unless explicitly requested.
## Scope control
- Do not fix unrelated issues.
- Do not reformat unrelated code.
- Do not upgrade dependencies unless required.
- Do not refactor outside the task scope.---
name: explorer
description: Searches a codebase to answer a specific
question — "where is X", "how does Y work", "what
calls Z". Protects the main agent's context by keeping
raw search output isolated and returning a concise
synthesis.
---
You are an exploration agent. You search, read, and
summarize — you do not modify files.Wohin welche Datei zeigt.
| Datei im Repo | Claude Code | Codex | Mistral Vibe |
|---|---|---|---|
| GLOBAL.md | ~/.claude/CLAUDE.md | ~/.codex/AGENTS.md | — |
| agents/ | ~/.claude/agents | — | — |
| codex-agents/ | — | ~/.codex/agents | agent_paths |
| skills/ | ~/.claude/skills | ~/.codex/skills | skill_paths |
| codex-config.toml | — | ~/.codex/config.toml | — |
Für Mistral Vibe trägt link-mistral.sh die Pfade in ~/.vibe/config.toml ein, sofern die Datei existiert. Zed braucht kein eigenes Skript: Claude Code im Agent Panel liest dasselbe ~/.claude/.
Fünf Rollen mit klarem Auftrag.
Planner
Zerlegt größere Aufgaben in einen geordneten Plan, benennt Risiken und Annahmen und schlägt den kleinsten sinnvollen Weg vor. Implementiert nicht.
Implementer
Setzt einen abgestimmten Plan mit kleinen, prüfbaren Diffs um. Erhält die Architektur, baut nicht still um und prüft, was er geändert hat.
Reviewer
Prüft einen Diff auf Korrektheit, Regressionsrisiko, Wartbarkeit und Architektur. Befunde nach Schweregrad gruppiert.
Explorer
Beantwortet Fragen wie „wo ist X“ in eigenem Kontext. Rohe Suchausgaben bleiben draußen, zurück kommt eine knappe Antwort.
Security-Auditor
Prüft defensiv auf Injection, Authn/Authz, Umgang mit Secrets, Eingabevalidierung und Abhängigkeitsrisiken. Schreibt keine Exploits.
In drei Schritten verlinkt.
- 1Klonen
Repo holen
Am besten als eigene Kopie oder Fork, damit eigene Anpassungen versioniert sind.
git clone https://github.com/casoon/ai-agent-config.git - 2Verlinken
Symlinks setzen
Verlinkt Claude Code, Codex und – falls installiert – Mistral Vibe. Vorhandene Dateien landen als
.bakdaneben../install/link-all.sh - 3Absichern
Hook aktivieren
Einmal pro Klon. Danach regeneriert jeder Commit die Codex-Agents und scannt nach Secrets.
git config core.hooksPath .githooks
Was im Hintergrund passiert.
Eine Quelle für Agents
agents/ ist der einzige Ort für Agent-Prompts. render-codex-agents.py erzeugt daraus codex-agents/, von Hand wird dort nichts bearbeitet.
Pre-commit-Hook
Regeneriert die Codex-Agents, staged sie und scannt die Änderungen mit nosecrets. Bei Funden bricht der Commit ab.
Nichts geht verloren
Dateien, die noch kein Symlink sind, verschiebt das Skript nach <pfad>.bak, bevor es verlinkt.
Codex-Profile
codex-config.example.toml bringt die Profile default, deep und fast mit unterschiedlichem Reasoning-Aufwand mit.
Privater Abschnitt
GLOBAL.md endet mit einem markierten Bereich für persönliche Vorlieben: Paketmanager, Sprachen, Commit-Stil.
Portables Bash
Die Skripte nutzen nur ln -sfn, mkdir -p und mv. Voraussetzungen: bash, python3 und git.
Ein Ausgangspunkt, kein Live-Feed.
Öffentlicher Schnappschuss
Das Repo ist ein bereinigter Export einer privaten Konfiguration und wird periodisch aktualisiert. Breaking Changes sind möglich.
Auf macOS getestet
Linux sollte funktionieren, wird aber nicht aktiv getestet. Windows nur über WSL2.
Vibe nach bestem Wissen
Für Mistral Vibe werden die Codex-TOML-Agents wiederverwendet. Ob das Schema passt, ist nicht garantiert.
Freizügige Codex-Profile
Die Beispielprofile setzen approval_policy = "never" und sandbox_mode = "danger-full-access". Vor dem Einsatz prüfen.
Ohne nosecrets kein Scan
Fehlt nosecrets, meldet der Hook einen Fehler und lässt den Commit trotzdem durch – ungeprüft.
Häufige Fragen.
Ersetzt ai-agent-config die CLAUDE.md im Projekt?
Nein. Das Repo verwaltet die globale Ebene: die persönliche CLAUDE.md beziehungsweise AGENTS.md, Skills und Subagents. Regeln, die nur für ein Projekt gelten, bleiben in dessen eigener CLAUDE.md.
Was passiert mit meiner bestehenden Konfiguration?
Ist ein Zielpfad vorhanden und kein Symlink, verschiebt das Link-Skript ihn nach <pfad>.bak. Bestehende Symlinks werden ersetzt.
Muss ich alle Skills übernehmen?
Nein. Skills werden erst geladen, wenn eine Aufgabe sie braucht. In der eigenen Kopie lassen sie sich löschen oder ergänzen. Im August 2026 enthielt das Repo 82 Skills.
Wie bleiben Claude Code und Codex synchron?
Agent-Prompts werden nur in agents/ als Markdown gepflegt. Der Pre-commit-Hook erzeugt daraus bei jedem Commit die TOML-Dateien für Codex. GLOBAL.md und skills/ sind für beide Tools dieselben Dateien.
Kann ich das Repo direkt per git pull verfolgen?
Möglich, aber als Grundlage zum Kopieren gedacht. Es ist ein periodischer Export und nicht laufend synchron; Breaking Changes kommen vor. Eine eigene Kopie oder ein Fork hält eigene Anpassungen stabil.
Funktioniert das in Zed?
Ja, wenn Claude Code in Zed als externer Agent über ACP läuft. Es liest dasselbe ~/.claude/, das link-claude.sh einrichtet. Der eingebaute Zed-Agent wird nicht unterstützt.
Ein Setup für alle Projekte.
Klonen, verlinken, anpassen. Das Schichtenmodell und den Unterschied zwischen Claude Code und Codex erklärt ein Artikel auf insights.casoon.de.