Ce dépôt centralise les ressources personnelles partageables entre plusieurs agents IA locaux, notamment Codex et Claude.

L'objectif est d'avoir un seul endroit versionné pour les éléments stables et réutilisables, tout en gardant les configurations spécifiques, secrets et états runtime dans les dossiers propres à chaque outil.

~/.agents est la source de vérité pour les artefacts communs.

Les outils consomment ensuite ces fichiers via des liens symboliques depuis leurs dossiers respectifs :

~/.codex/
~/.claude/

Les fichiers spécifiques à un outil restent dans son propre dossier. Par exemple :

• configuration Codex : ~/.codex/
• configuration Claude : ~/.claude/
• credentials et sessions Codex : ~/.codex/
• credentials et sessions Claude : ~/.claude/

Les dossiers suivants peuvent être versionnés et réutilisés entre agents :

skills/      Procédures réutilisables pour tâches fréquentes
blueprints/  Modèles Markdown pour specs, tasks, ADR, README et runbooks
scripts/     Scripts utilitaires déterministes
prompts/     Prompts exploratoires ou de cadrage
commands/    Commandes réutilisables, notamment côté Claude

Les fichiers et dossiers propres à chaque agent ne doivent pas être déplacés ici.

Exemples :

• ~/.codex/config.toml
• ~/.codex/auth.json
• ~/.claude/settings.json
• ~/.claude/.credentials.json
• sessions/
• projects/
• cache/
• logs, bases SQLite et historiques locaux

Exemples de liens attendus :

~/.codex/skills/<skill>  -> ~/.agents/skills/<skill>
~/.claude/skills/<skill> -> ~/.agents/skills/<skill>

~/.codex/blueprints -> ~/.agents/blueprints
~/.codex/scripts    -> ~/.agents/scripts
~/.codex/prompts    -> ~/.agents/prompts

~/.claude/commands  -> ~/.agents/commands

Le partage doit rester granulaire : préférer des liens par dossier utile plutôt que remplacer entièrement les dossiers système d'un outil.

• Ne pas committer de secret.
• Ne pas committer de fichier runtime.
• Ne pas committer de session, cache, logs ou base SQLite.
• Garder les ressources partagées indépendantes d'un outil quand c'est possible.
• Placer le spécifique Codex dans ~/.codex/.
• Placer le spécifique Claude dans ~/.claude/.