Gabriel Radureau
41ee8c56ac
Création de 9 fichiers neufs pour décharger AGENTS.md (1296 lignes →
~130) en documents lazy-loadables, compatibles avec la limite de
contexte 128k de Mistral Vibe (cf. ARCODANGE migration Phase 1,
Tâche 6 du curriculum).
Sept guides ciblés sous documentation/ :
- HISTORY.md : phases historiques 1-9 du développement
- CLI.md : commandes CLI, server lifecycle, config DLC_*
- API.md : endpoints REST, OpenAPI, Greet v1/v2
- OBSERVABILITY.md : OpenTelemetry + Jaeger, sampler types, test
- TROUBLESHOOTING.md : issues connues + pointeurs vers guides spé
- CODE_EXAMPLES.md : snippets endpoint/logging/context, pointeurs ADR
- ROADMAP.md : potential features, architectural improvements
Deux fichiers racine :
- CHANGELOG.md : user-facing, format Keep a Changelog
- AGENT_CHANGELOG.md : décisions structurantes des agents AI
(référencé par AGENTS.md, n'existait pas)
Le contenu est extrait fidèlement d'AGENTS.md sans réinterprétation.
Phase C (réécriture AGENTS.md court) suit dans le commit suivant.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2.0 KiB
AGENT_CHANGELOG
Trace ordonnée des décisions et actions structurantes prises par les agents AI (Claude Code, Mistral Vibe, autres) sur le projet dance-lessons-coach. Complémentaire au CHANGELOG.md qui couvre les changements user-facing du produit.
Pourquoi ce fichier : référencé dans la documentation directrice (cf. AGENTS.md), mais initialement absent du repo. Initialisé dans le cadre de la Tâche 6 du curriculum migration Claude → Mistral Vibe (ARCODANGE Phase 1).
Convention
Une entrée par décision/action structurante prise par un agent AI. Format :
## YYYY-MM-DD — <Agent> — <Titre court>
**Contexte** : 1-3 lignes — pourquoi cette action
**Décision/Action** : ce qui a été fait
**Conséquence** : impact sur le projet (fichiers, conventions, workflows)
**Référence** : commit hash, PR Gitea, ADR, issue (le cas échéant)
Les entrées qui ne demandent pas de discussion (typo fixes, formatting, dependency bumps mineurs) ne sont pas loguées ici — c'est ce que fait le commit Git. Ce fichier garde uniquement les décisions où le pourquoi mérite une trace.
2026-05-02 — Mistral Vibe (intent-router) + Claude Code (Opus 4.7) — Initialisation AGENT_CHANGELOG.md
Contexte : Tâche 6 du curriculum migration ARCODANGE Phase 1 (cf. ~/.vibe/plans/migration-claude-vers-mistral-phase-1.md). Le fichier AGENT_CHANGELOG.md était mentionné dans la documentation directrice projet mais n'existait pas — friction identifiée par l'audit Phase A.
Décision/Action : initialiser le fichier avec convention claire et pointer depuis AGENTS.md (Tâche 6 Phase C).
Conséquence : tout agent qui prend une décision structurante sur le projet doit ajouter une entrée datée ici. Permet la traçabilité des choix AI au-delà des commits Git.
Référence : Tâche 6 du plan migration. Voir aussi ~/.vibe/plans/task-6-phase-a-results.md pour le contexte complet de la restructuration en cours.