GenCodeDoc

1. L'Idée Fondatrice

L'historique d'un projet n'est pas qu'un journal de commits : c'est un index structuré que les agents IA doivent pouvoir explorer programmatiquement.

2. Le Problème Réel

Quand un agent modifie du code, il perd la vision globale de ses altérations et ne peut pas revenir en arrière chirurgicalement sans casser le dépôt.

3. Pourquoi les approches classiques échouent

Git est conçu pour l'humain (branches, merges interactifs). Les agents ont besoin de primitives atomiques simples : snapshotter un dossier, calculer un diff sémantique, restaurer un composant précis.

4. Le Mécanisme Original

Snapshots différentiels dédupliqués avec interface MCP native permettant à n'importe quel éditeur IA (OpenCode, Claude, Cursor) d'avoir un filet de sécurité complet.

5. Difficultés Rencontrées & Verrous

Déduplication ultra-rapide sur des arborescences de plusieurs milliers de fichiers
Calcul de diffs unifiés légers sans saturer la mémoire du serveur
Gestion propre des règles d'exclusion (.gitignore, node_modules)

6. Choix Techniques Structurants

Hashing content-addressedBase SQLite embarquéeDiff unifié natifServeur MCP standardisé

7. Résultat & État Actuel

Publié en open source et activement utilisé dans nos environnements de développement et de formation.

8. Ce que ce projet nous a appris

💡 Enseignement majeur : Donner un outil de versioning local-first aux agents augmente considérablement leur taux de succès sur les refactorings complexes.

Formations professionnelles associées :

Construire un serveur MCP Agent ↔ fichiers Résilience et reprise