Le piège du backlog.md : des notes obsolètes qui égarent plus qu’elles n’aident
Dès que l’agent a lu « quatre articles en attente » et que l’API a répondu « déjà publiés », l’incohérence était flagrante. Un fichier que vous avez autrefois entretenu peut devenir un menteur silencieux si rien ne le synchronise avec la réalité. Ce n’est pas la faute de l’agent : il a ouvert fidèlement backlog.md et énoncé son contenu. Le problème venait du fichier lui-même : un cache qui a cessé de se rafraîchir dès que les commits ont cessé de le déclencher.
La dérive invisible des notes personnelles
Les projets solo accumulent deux flux parallèles. L’un est le code, les commits, les déploiements – des données gérées par un contrôle de version et des pipelines CI. L’autre est les gribouillis que nous laissons pour nous-mêmes : backlog.md, mises à jour de README, notes de session. Ces notes vieillissent rapidement parce que leur cycle de rafraîchissement est humain, pas automatique. Une sprint se termine, un fichier est fermé, et la note devient un instantané qui dérive rapidement de l’état actuel. Sans mécanisme qui interroge à nouveau la source et met à jour le cache, la note se transforme en hallucination déguisée en mémoire.
Considérez les notes comme des caches, pas comme des sources
Un cache doit déclarer sa règle de rafraîchissement dès sa création, tout comme les colonnes d’une base de données indiquent si elles sont en temps réel, en snapshot ou en cache. Si la valeur de backlog.md peut être déduite de state.json et de drapeaux éditoriaux, alors sync-backlog.ts en est le déclencheur. Omettez le déclencheur et le fichier devient un artefact instable. La solution n’est pas d’arrêter d’écrire des notes, mais de cesser de les traiter comme des sources fiables. Avant de faire confiance à un résumé, exécutez quatre commandes qui recalculent l’état en quelques secondes : commits récents, git status, nombre d’ADR, et comptes d’API. Consultez ensuite le Markdown, mais avec scepticisme – demandez qui l’a rédigé et quand, puis vérifiez dans git log. Si le mécanisme de rafraîchissement n’est pas visible en quinze secondes, considérez le fichier comme obsolète par défaut.
Coda Une note qui ne précise ni sa date de production ni son processus de rafraîchissement ne vaut rien. Soit intégrez le mécanisme de rafraîchissement dans le même commit qui crée la note, soit reléguez le fichier au rang de brouillon et déduisez la vérité à partir des données en temps réel.
Source : DEV Community. Synthèse éditoriale assistée par IA — TechnoExpress.