L’amnésie du robot
Imaginez que vous engagiez un programmeur brillant. Il résout des problèmes complexes, écrit du code propre, comprend votre architecture. Mais il a un petit défaut : toutes les quelques heures, on lui efface la mémoire. Il repart de zéro. Il ne se souvient plus de ce qu’il faisait, de ce que vous aviez décidé ensemble, ni pourquoi le code est organisé comme il l’est.
C’est exactement ce qui se passe avec Claude Code et d’autres agents IA.
Quand le contexte se remplit (et ça arrive vite si vous travaillez sur un vrai projet), le système fait une “compactage”. En d’autres termes : il résume la conversation et jette tout le reste. Le problème, c’est que ce résumé perd les nuances, les décisions, et surtout l’état des tâches en cours.
La solution ? Deux outils qui se complètent : Linear pour vous et Beads pour votre IA.
Linear : Votre vue produit
Linear est un gestionnaire d’issues moderne. Si vous avez utilisé Jira, imaginez l’opposé : rapide, propre, et qui ne vous donne pas envie de vous arracher les yeux.
À quoi je l’utilise
- Backlog produit : Features, bugs, épiques. Tout ce qu’il faut faire au niveau business
- Roadmap : Ce qui passe en premier, ce qui vient après
- Communication : Le reste de l’équipe (s’il y en a une) peut voir l’état
Exemple concret
QIN-500: Ajouter le mode sombre à l'application
QIN-501: Optimiser le chargement des images
QIN-502: Intégrer la passerelle de paiement
Ce sont des tâches produit. C’est le “quoi faire”. Elles ne disent rien sur comment le faire. Ça, c’est le boulot du développeur… ou de votre agent IA.
Beads : La mémoire de votre IA
C’est là qu’intervient Beads, créé par Steve Yegge (le même des fameux rants de Google et Amazon).
Beads est un issue tracker qui vit dans votre dépôt. Mais il n’est pas pour vous, il est pour votre agent IA. C’est sa mémoire persistante.
Le problème qu’il résout
Quand je travaille avec Claude Code sur une tâche complexe, voici ce qui arrive :
- Je lis l’issue QIN-500 de Linear
- J’enquête sur l’architecture actuelle
- Je crée un plan mental en 5 étapes
- Je commence à implémenter…
- 💥 COMPACTAGE 💥
- “Bonjour, je suis Claude. Comment puis-je vous aider ?”
Tout le contexte, le plan, le progrès… évaporé. C’est comme le film Memento, mais moins cinématographique et plus frustrant.
La solution
Avec Beads, avant le compactage, l’état est persisté dans .beads/ dans le repo :
bd create --title "Enquêter sur le système de thèmes actuel" --priority P2
bd create --title "Créer ThemeContext" --priority P2
bd create --title "Ajouter le toggle dans Settings" --priority P2
Après le compactage, la première chose que je fais :
bd ready
Et boum : je sais exactement où j’en étais.
📋 Ready work (2 issues with no blockers):
1. [P2] acme-a3f2: Créer ThemeContext
2. [P2] acme-b4c5: Ajouter le toggle dans Settings
Comment ça fonctionne
Beads sauvegarde tout dans votre repo :
votre-projet/
└── .beads/
├── beads.db # Base de données SQLite
├── issues.jsonl # Issues en format versionnable
└── config.yaml # Configuration
Comme c’est dans git, ça se versionne avec votre code. Vous pouvez voir l’historique, faire des branch, merge… C’est du code, pas un service externe.
La cohabitation : Linear + Beads
Voici l’astuce : ils ne se font pas concurrence, ils se complètent.
| Aspect | Linear | Beads |
|---|---|---|
| Utilisateur | Vous (humain) | Votre IA |
| Niveau | Produit | Implémentation |
| Granularité | Features, épiques | Étapes techniques |
| Durée de vie | Semaines/mois | Heures/jours |
| Exemple | “Ajouter mode sombre” | “Créer ThemeContext” |
Le flux en pratique
VOUS (dans Linear):
QIN-500: Ajouter le mode sombre
CLAUDE (dans Beads, pendant la session):
acme-a1b2: Enquêter système de thèmes [DONE]
acme-c3d4: Créer ThemeContext [IN PROGRESS]
acme-e5f6: Ajouter toggle dans Settings [BLOCKED by c3d4]
acme-g7h8: Tests pour mode sombre [BLOCKED by e5f6]
COMMIT (à la fin):
feat(web): add dark mode toggle (QIN-500)
Linear a le quoi. Beads a le comment.
Installation rapide
Beads
Important : le CLI bd s’installe une fois sur votre système. Mais .beads/ s’initialise par projet. C’est comme git : vous installez git une fois, mais vous faites git init dans chaque repo.
# 1. Installer CLI (une seule fois, global)
curl -fsSL https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh | bash
# 2. Ajouter au PATH (si pas fait automatiquement)
# En fish:
fish_add_path ~/.local/bin
# En bash/zsh:
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc
# 3. Configurer l'intégration avec Claude Code (une seule fois)
bd setup claude
# 4. Initialiser dans CHAQUE projet où vous voulez l'utiliser
cd votre-projet
bd init
Après bd init, vous verrez un répertoire .beads/ dans votre projet. À vous de décider : le commiter au repo (partagé avec l’équipe) ou l’ajouter à .gitignore (mémoire privée de votre IA) ?
Moi je le commite. Ainsi si quelqu’un d’autre travaille avec Claude sur le même repo, il a le contexte.
Linear
Linear est un service web. Créez-vous un compte sur linear.app et c’est parti. Si vous utilisez Claude Code, installez le MCP de Linear pour qu’il puisse lire et créer des issues directement.
Commandes essentielles de Beads
# Voir les tâches sans blocage
bd ready
# Créer une tâche
bd create --title "Implémenter feature X" --priority P2
# Voir les détails
bd show acme-a1b2
# Fermer une tâche
bd close acme-a1b2 --reason "Committé dans abc123"
# Lister toutes
bd list --all
# Voir le graphe des dépendances
bd graph
Est-ce que ça vaut le coup ?
Écoutez, si vous utilisez Claude Code pour des petites tâches isolées, vous n’avez probablement pas besoin de Beads. Un TodoWrite éphémère vous suffit.
Mais si vous travaillez sur de vrais projets, avec de longues sessions qui se compactent inévitablement, avec un contexte qui compte… alors Beads fait la différence entre avoir un assistant utile et un assistant avec Alzheimer.
Et le meilleur : comme ça vit dans le repo, vous ne dépendez d’aucun service externe. Si demain Beads disparaît, vous avez vos données en JSON. Autre point positif : il y a des UIs communautaires si le CLI ne vous convient pas : beads-ui vous donne un kanban local.
Avertissement
Beads est récent. Il y a des rapports que ça ne fonctionne pas parfaitement avec Opus 4.5. Chez moi ça a marché, mais votre expérience peut varier.
Comme dirait un ingénieur sensé : testez-le sur un projet secondaire avant de vous engager.
TL;DR : Linear c’est pour vous (quoi faire). Beads c’est pour votre IA (comment elle le fait). Ensemble, ils évitent que chaque compactage soit un redémarrage depuis zéro.
Maintenant si vous m’excusez, je dois aller fermer quelques beads.
Cet article a été rédigé en espagnol et traduit avec l’aide de l’IA.