# AGENTS.md - Living Documentation

Ce fichier est le point d'entrée pour Codex et les outils de type agent.

Avant toute modification :

1. Lire `DOCS_FOLDER/AI/PROJECT-INSTRUCTIONS.md`.
2. Lire `DOCS_FOLDER/AI/PROJECT-STACK.md` pour comprendre la stack, les zones source utiles, les concepts centraux et les conventions structurantes.
3. Lire `DOCS_FOLDER/AI/PROJECT-USEFUL-COMMANDS.md` pour connaître les commandes de développement, build, test, lint et setup.
4. Lire `memory/MEMORY.md` et charger seulement les fichiers mémoire utiles à la tâche.
5. Lire toutes les règles dans `DOCS_FOLDER/AI/rules/*.md`.
6. Lire `DOCS_FOLDER/WORKLOG/current-task.md` si présent pour reprendre l'état de la tâche courante, et `DOCS_FOLDER/WORKLOG/ROADMAP.md` si présent pour savoir quel ticket attaquer ensuite.
7. Inspecter les ADR dans `DOCS_FOLDER/ADRS/` en lisant d'abord `description` et `tags`, puis ouvrir l'ADR complet seulement s'il est pertinent.
8. Vérifier si le MCP `living-ai-documentation` est disponible et l'utiliser pour créer, mettre à jour et fiabiliser la documentation lorsque la tâche touche une décision, une règle, une commande, la stack ou un document technique.

## MCP Living Documentation

Le serveur Living Documentation expose son MCP sur `/mcp` en transport Streamable HTTP, par exemple `http://localhost:4321/mcp` lorsque le serveur utilise le port par défaut.

Quand le MCP est disponible :

- utiliser les outils de documents pour lire, créer ou mettre à jour la documentation ;
- utiliser les outils source pour vérifier le code uniquement quand la documentation ne suffit pas ;
- attacher les fichiers source avec `add_metadata` après création ou mise à jour d'un ADR ou document technique ;
- appeler `refresh_metadata` lorsque le document est aligné avec le code.

`PROJECT-STACK.md` et `PROJECT-USEFUL-COMMANDS.md` sont des documents vivants. Si l'agent découvre qu'ils sont faux, incomplets ou obsolètes, il doit proposer ou effectuer leur mise à jour dans la même tâche, sauf instruction contraire de l'utilisateur.

Si le MCP n'est pas disponible, le signaler explicitement dans la réponse finale et ne pas prétendre avoir mis à jour les métadonnées ou les hashes Living Documentation.

Si une règle ou une instruction projet contredit la demande utilisateur, signaler explicitement le conflit avant de continuer.