DOX : garder les consignes d’un projet lisibles et à jour

https://github.com/agent0ai/dox + https://agent-zero.ai

📌 DOX est un cadre minimal autour des fichiers AGENTS.md qui sert à donner à une IA un contexte de projet précis, sans installation ni dépendance. L’idée est simple: organiser les consignes au plus près du code, pour que l’agent sache quoi faire avant d’éditer un fichier.

Dans un projet qui grandit, les règles dispersées deviennent vite difficiles à suivre. DOX répond à ce problème avec une hiérarchie de consignes: un AGENTS.md racine pour les règles globales, puis des fichiers enfants pour les zones plus spécifiques. L’agent parcourt cette arborescence avant chaque modification et s’appuie sur les instructions locales au lieu d’improviser.

Cette approche change le quotidien sur les tâches de maintenance. Quand un dépôt contient plusieurs sous-domaines, des conventions différentes ou des exceptions ponctuelles, l’IA peut adapter son comportement au bon endroit sans casser les habitudes du reste du projet. Le résultat est plus propre: moins de modifications hors sujet, moins de drift documentaire, et une meilleure cohérence entre l’intention et l’édition réelle.

Le format reste volontairement simple. Un projet qui n’a pas encore de structure AGENTS.md peut démarrer en copiant le fichier racine, puis en laissant l’agent construire les fichiers enfants au fil des besoins. Pour un dépôt existant, l’instruction est directe: initialiser l’arborescence DOX, puis laisser les règles locales apparaître là où elles servent vraiment.

En pratique, DOX prend surtout de la valeur dans les environnements où l’on veut encadrer un assistant sans alourdir la pile technique. Il n’y a pas de runtime à déployer, pas de package à installer, pas de dépendance à gérer. Le projet fonctionne comme une discipline de documentation exécutable par les agents compatibles AGENTS.md, y compris Codex, Claude Code ou OpenCode.

points clés

• 🧭 Hiérarchie claire: une règle racine, puis des règles locales par zone du projet.
• 🛠️ Édits plus précis: l’agent lit le contexte avant d’intervenir, ce qui limite les modifications aveugles.
• 🧱 Zéro installation: aucun package, aucune dépendance, aucun runtime à maintenir.
• 🤖 Compatibilité large: fonctionne avec plusieurs agents qui comprennent AGENTS.md.
• 🧾 Documentation vivante: les consignes évoluent avec le projet au lieu de rester figées dans un README.

DOX convient bien aux dépôts qui changent souvent de structure ou qui mélangent plusieurs usages. Une équipe peut y garder des règles globales communes, tout en ajoutant des instructions locales pour une bibliothèque, une application ou une zone sensible du code. Cette granularité évite les consignes trop générales qui perdent leur effet dès qu’un dossier devient particulier.

L’intérêt principal tient aussi à la mémoire de projet. Au lieu de réexpliquer les mêmes attentes à chaque session, les consignes restent à côté des fichiers concernés. L’agent lit le bon niveau d’information, ce qui réduit les oublis et améliore la continuité entre deux interventions.

Sur le plan produit, DOX ne promet pas un assistant plus “intelligent”; il promet un assistant mieux guidé. C’est une nuance importante, parce que la qualité vient ici de la structure du contexte, pas d’une couche logicielle supplémentaire. Pour beaucoup de projets, cette discipline suffit déjà à rendre les changements plus fiables et plus faciles à relire.

Au final, DOX est utile dès qu’un dépôt mérite des règles explicites, locales et stables. Il transforme AGENTS.md en infrastructure légère de gouvernance éditoriale pour agents, avec un bénéfice immédiat: moins de flou, plus de précision, et une base documentaire qui suit réellement le code.

📌 DOX structure les consignes AGENTS.md d’un projet pour guider l’IA fichier par fichier, sans installation ni dépendance. Utile pour garder des edits précis, limiter le drift et documenter les règles locales.