Aller au contenu

TechnologieBase de connaissances

Backlog.md

SFEIR AI Rédaction humaine et IA · Comment nous écrivons
Publié le

En bref

Tracker open source (MIT) d'Alex Gavrilescu : une tâche par fichier Markdown dans le dépôt, pilotée par une CLI que lisent et écrivent les agents de code.

Un fichier Markdown par tâche, dans le dépôt

Backlog.md est un tracker open source sous licence MIT, créé par Alex Gavrilescu (MrLesk) et lancé en juin 2025. Chaque tâche est un fichier Markdown à en-tête YAML rangé dans le dossier backlog/ du dépôt : identifiant, titre, statut, assignee, étiquettes, dépendances et priorité dans l'en-tête, description et critères d'acceptation dans le corps.

Tout est versionné avec le code : la modification d'une tâche se relit dans la même merge request que le code qu'elle décrit. Une CLI crée et modifie les fichiers (backlog task create, backlog task edit, backlog task list --ready pour les tâches qu'aucune dépendance ne bloque), un board s'affiche dans le terminal (backlog board) et une interface web locale s'ouvre avec backlog browser. Le README demande de passer par la CLI, le MCP ou l'interface web plutôt que d'éditer les fichiers à la main. L'outil fonctionne sans compte ni serveur et, selon le README, sans télémétrie.

Brancher les agents : la CLI par défaut, le MCP en option

Les agents passent par défaut par la CLI. À l'initialisation, l'option recommandée écrit dans AGENTS.md une consigne courte qui demande à l'agent de lancer backlog instructions overview ; la commande backlog agents --update-instructions met ensuite à jour CLAUDE.md, AGENTS.md, GEMINI.md et les instructions Copilot. Claude Code ou Codex CLI appellent alors les commandes backlog comme le ferait un développeur.

Un serveur MCP intégré (backlog mcp start) reste maintenu ; le README le destine à ceux qui le choisissent, « when you explicitly prefer an MCP connector ». Depuis la v1.51.0 du 2 septembre 2026, le guide de travail ne se lit plus à chaque requête : « Agents are told to read the Backlog overview once per conversation instead of before every request ».

Une méthode : trois relectures humaines

Le README décrit une méthode autant qu'un outil. Il prévoit trois relectures humaines : sur les tâches et leurs critères d'acceptation, sur le plan d'implémentation que l'agent écrit dans la tâche, puis sur le code. Sa règle : une tâche, une fenêtre de contexte, une pull request. La tâche devient la mémoire qui survit à la fin de la session : du context engineering appliqué au ticket.

Le README précise que presque tout le code du projet est écrit par des agents qui travaillent eux-mêmes via Backlog.md, et que le registre de ses tâches est public dans le dossier backlog/ du dépôt. Dans « A year of building Backlog.md » (7 juillet 2026), Alex Gavrilescu explique que l'atout de départ était une persistance des tâches qui survit aux compactions de contexte, et que l'outil lui sert aujourd'hui autant à comprendre ce que font les agents qu'à les guider.

Activité du projet et changements récents

Le 22 novembre 2026, le dépôt GitHub comptait 7 469 étoiles, 497 forks et environ 1 530 commits. Onze versions ont été publiées entre le 16 octobre et le 22 novembre 2026, de la v1.54.0 à la v1.57.4.

Deux de ces versions changent l'usage. Depuis la v1.54.0, backlog task complete et l'outil MCP task_complete ne font plus rien : on passe la tâche au statut final (« Done » par défaut), puis on l'archive. La v1.57.0 a ajouté backlog browser export, qui produit un site statique en lecture seule à publier sur GitLab Pages ou GitHub Pages.

Limites pour une DSI

Backlog.md sert une équipe sur un dépôt ; il ne pilote pas un portefeuille. Dans la grille de l'article Sortir de Jira, notée par SFEIR sur huit critères agent au 13 novembre 2026, il obtient 4,5 sur 5, le score le plus élevé des quinze solutions comparées, et 3 sur 5 en accessibilité pour les non-développeurs. Ce qu'il reste à construire ou à accepter :

  • Pas de vue de portefeuille. Un backlog vit dans un dépôt ; rien n'agrège dix dépôts.
  • Pas de reporting de vélocité ni de burndown. Il se construit à partir de la sortie --json, dont le contrat est versionné.
  • Des permissions héritées du dépôt. Qui lit le code lit les tâches : un ticket sensible n'a pas sa place dans ce dossier.
  • Un accès difficile pour les profils non techniques. L'interface web écoute par défaut sur 127.0.0.1 ; l'export statique montre à tout lecteur du site les plans, notes et commentaires des tâches publiées.
  • Des écarts entre branches. Une même tâche peut évoluer sur deux branches ; backlog doctor signale les identifiants en double.

Questions fréquentes

  • Backlog.md est-il gratuit ?

    Oui. Il est publié sous licence MIT, s'utilise sans compte ni serveur et, selon son README, sans télémétrie. Il s'installe par npm, Bun ou Homebrew ; pour un essai par npx, il faut le nom complet du paquet, npx backlog.md, la documentation prévenant que npx backlog appelle un paquet tiers sans rapport.

  • Faut-il un serveur MCP pour utiliser Backlog.md avec Claude Code ou Codex ?

    Non. La voie par défaut est la CLI : l'agent lit AGENTS.md ou CLAUDE.md, lance backlog instructions overview, puis appelle les commandes backlog. Le serveur MCP intégré (backlog mcp start) reste disponible pour qui le préfère. Pas à pas dans le tutoriel Backlog.md.

  • Backlog.md remplace-t-il Jira ?

    Il prend la place du ticket au niveau de l'équipe qui développe, pas celle d'un outil de portefeuille ou de reporting de direction. Il n'importe pas Jira nativement : un script d'export produit des fichiers à en-tête YAML, à contrôler ensuite avec backlog doctor (voir exporter ses tickets Jira en Markdown).

  • Backlog.md fonctionne-t-il sans Git ?

    Oui : backlog init --no-git crée un projet sur le seul système de fichiers. L'intérêt principal reste pourtant le versionnement des tâches avec le code, qui permet de relire une tâche dans la même merge request que le code qu'elle décrit.

Sources

  1. GitHub — dépôt Backlog.md, Alex Gavrilescu (README : licence, méthode, CLI et MCP, compteurs à la date) · 2026-11-22

    when you explicitly prefer an MCP connector

  2. GitHub — Backlog.md, page des versions (v1.54.0 à v1.57.4) · 2026-11-22
  3. GitHub — Backlog.md, « CLI Reference » (initialisation, consigne AGENTS.md, sortie --json, backlog doctor) · 2026-11-22
  4. GitHub — Backlog.md, dossier backlog/ du dépôt (format d'un fichier de tâche) · 2026-11-22
  5. GitHub — Backlog.md, notes de version v1.54.0 (task complete sans effet, archivage) · 2026-10-16
  6. GitHub — Backlog.md, notes de version v1.51.0 (guide lu une fois par conversation) · 2026-09-02

    Agents are told to read the Backlog overview once per conversation instead of before every request

  7. GitHub — Backlog.md, notes de version v1.57.0 (export statique en lecture seule) · 2026-11-21
  8. Alex Gavrilescu — « A year of building Backlog.md: do we still need a task manager in the AI era? » · 2026-07-07

Passer à l’action

Backlog.md dans vos projets

Échanger avec SFEIR

Perspectives

Articles liés

Backlog.md : le backlog Markdown pour Claude Code et Codex Backlog.md range chaque tâche dans un fichier Markdown du dépôt et la pilote par une CLI. Installation, commandes vérifiées sur la version 1.57.4, format exact d'un fichier de tâche, branchement de Claude Code et Codex, et limites pour une DSI. 22 nov. 2026 Backlog.md, Beads ou Task Master : quel tracker pour vos agents ? Trois trackers conçus pour les agents de code, trois modèles : fichiers Markdown dans le dépôt, graphe de tâches dans une base Dolt, liste générée depuis un PRD. Comparatif vérifié au 22 novembre 2026 et choix selon votre niveau de maturité. 22 nov. 2026 Sortir de Jira en 2027 : mettez vos tickets là où travaillent vos agents Jira Data Center passe en lecture seule le 28 mars 2029. Pour une équipe qui fait déjà travailler des agents de code, le successeur de Jira est un backlog Markdown versionné dans le repo. Grille SFEIR de quinze solutions, échelle de maturité N0-N4, trajectoire de migration. 13 nov. 2026 Exporter ses tickets Jira en Markdown pour ses agents de code Jira Cloud ne répond plus sur /rest/api/3/search : l'export passe par /search/jql et son nextPageToken. Script Python testé qui écrit un fichier Markdown par ticket au format Backlog.md, convertit l'ADF, rapatrie commentaires et pièces jointes, et les pièges à connaître. 22 nov. 2026 Alternatives à Jira auto-hébergées et souveraines : le comparatif GitLab, OpenProject, Plane, YouTrack, Tuleap, Redmine, Huly et git-bug comparés sur la licence, l'éditeur et son pays, l'import depuis Jira et le serveur MCP, avec ce que l'édition libre ne couvre pas. Vérifié au 22 novembre 2026. 22 nov. 2026