agent-setup

Source de vérité versionnée pour mes skills d'agents (Claude Code + Codex), synchronisée vers tous les emplacements sur WSL, Windows et macOS.

Créé après avoir perdu des skills lors d'un remplacement de distro WSL (2026-07-01) — plus jamais ça.

Layout

Chemin	Rôle
skills/	les skills actives (une par dossier, SKILL.md + assets)
archive/	skills conservées mais non synchronisées (restaurer : git mv archive/<nom> skills/ + sync)
agents/	subagents Codex custom (*.toml, synced vers ~/.codex/agents)
CLAUDE.md	mémoire globale Claude Code (source de vérité, synced vers ~/.claude/CLAUDE.md)
AGENTS.md	mémoire globale des autres agents (synced vers ~/.agents/AGENTS.md)
config.env	WINDOWS_USER
scripts/sync.sh	sync Linux / WSL / macOS (bash 3.2 compatible)
scripts/sync.ps1	sync Windows natif (PowerShell + robocopy)
shell/env.sh	exports d'environnement (ex. CDP_PORT_FILE pour chrome-cdp sous WSL)

Destinations

Skills :

• ~/.agents/skills : toutes les skills (répertoire standard cross-outils)
• ~/.claude/skills : symlinks vers les skills gérées dans ~/.agents/skills, pour Claude Code
• ~/.codex/agents : les subagents Codex (agents/*.toml)
• Chaque destination reçoit un manifeste .agent-setup-managed : seules les entrées listées dedans peuvent être supprimées (prune). Les skills/agents installés par d'autres outils ne sont jamais touchés.

Mémoire globale (repo = source de vérité) :

• CLAUDE.md → ~/.claude/CLAUDE.md
• AGENTS.md → ~/.agents/AGENTS.md
• Avant tout écrasement, l'ancien fichier cible est sauvegardé en <chemin>.bak-<AAAAMMJJ-HHMMSS> (uniquement s'il diffère). Pas de backup pour les skills.

Sous WSL, les mêmes destinations côté Windows (/mnt/c/Users/$WINDOWS_USER/…) sont aussi synchronisées — pas besoin de lancer sync.ps1 si le WSL tourne.

Usage

./scripts/sync.sh --dry-run   # voir ce qui serait fait
./scripts/sync.sh             # sync + prune
./scripts/sync.sh --no-prune  # sync sans suppression

Windows natif (sans WSL) :

powershell -ExecutionPolicy Bypass -File scripts\sync.ps1 -DryRun
powershell -ExecutionPolicy Bypass -File scripts\sync.ps1

Nouvelle machine :

git clone <ce repo> && cd agent-setup && ./scripts/sync.sh
echo 'source ~/Documents/Developper/agent-setup/shell/env.sh' >> ~/.zshrc

Workflow

1. Modifier/ajouter une skill dans skills/
2. ./scripts/sync.sh
3. git add -A && git commit && git push

Ne jamais éditer directement dans les skills gérées sous ~/.agents/skills ou ~/.claude/skills, ni dans ~/.claude/CLAUDE.md ou ~/.agents/AGENTS.md : le prochain sync écrase les skills gérées (rsync --delete / robocopy /MIR) ; les fichiers mémoire sont sauvegardés avant écrasement.

Notes

• Les copies d'agent-guards (orchestrator, use-loop, self-test, …) sont des versions patchées (chemins de preuves ~/.codex/proofs/, pas de chemins absolus de l'auteur).