Le problème de la mémoire

Claude Code a un problème : il oublie tout. Vous fermez la session, vous en ouvrez une autre, et c’est comme parler à quelqu’un qui ne vous connaît pas. Vous pouvez charger du contexte avec CLAUDE.md, certes, mais qu’en est-il des tâches à moitié terminées ? Des bugs que vous avez trouvés mais pas corrigés ? Du plan que vous aviez pour demain ?

Il existe trois solutions complémentaires : Linear (ou votre outil de gestion produit), Beads (plugin git-backed) et Tasks (intégrées dans Claude Code). Chacune pour un horizon temporel différent.

Tasks : La mémoire de travail

Tasks est le système interne de Claude Code pour suivre ce qu’il fait en ce moment même. Quand vous lui demandez quelque chose de complexe, Claude crée automatiquement une liste de tâches.

Appuyez sur Ctrl+T pour les voir :

┌─────────────────────────────────────────────────┐
│ Tasks                                           │
├─────────────────────────────────────────────────┤
│ ✓ Lire la structure du projet                   │
│ ● Implémenter endpoint d'authentification       │
│ ○ Écrire les tests                              │
│ ○ Mettre à jour la documentation                │
└─────────────────────────────────────────────────┘

Caractéristiques

  • Automatiques : Claude les crée quand le travail a plusieurs étapes
  • Persistantes après compaction : Survivent quand le contexte est compacté
  • Visibles avec Ctrl+T : Basculement rapide de la vue
  • Limitées à 10 : N’affiche que les 10 premières (demandez “show me all tasks” pour en voir plus)

Partager entre sessions

Par défaut, les Tasks meurent avec la session. Mais vous pouvez les rendre persistantes :

CLAUDE_CODE_TASK_LIST_ID=qualitra claude

Ceci sauvegarde les tâches dans ~/.claude/tasks/qualitra/. La prochaine fois que vous démarrez avec le même ID, vous récupérez la liste.

Quand utiliser Tasks

SituationTasks
Implémenter une fonctionnalité en une session✓
Suivre un plan de travail défini✓
Débogage étape par étape✓
Refactoring avec des étapes claires✓

Tasks c’est pour l’exécution. Vous savez ce qu’il faut faire, vous avez juste besoin d’un suivi.

Beads : La mémoire du projet

Beads est un plugin qui ajoute un système de suivi d’issues complet, stocké dans git. Pensez-y comme “Linear mais local et gratuit”.

bd list --status open
ID          TYPE    PRI  STATUS       TITLE
qua-1       epic    P2   open         Scoring Raven
qua-2       task    P1   in_progress  Implémenter module de scoring
qua-3       bug     P0   blocked      Stack overflow dans acquireStartLock

Caractéristiques

  • Git-backed : Les issues vivent dans .beads/ et sont committées avec votre code
  • Dépendances : Une issue peut en bloquer une autre
  • Priorités et types : Epics, tasks, bugs, features, chores
  • Multi-session : Le contexte persiste entre sessions (et personnes)
  • Hooks : Se synchronise automatiquement avec bd sync

Le flux de travail

# Trouver du travail disponible
bd ready

# Voir les détails
bd show qua-2

# Commencer à travailler
bd update qua-2 --status in_progress

# Créer des sous-tâches
bd create --title="Écrire tests PBT" --type=task
bd dep add qua-5 qua-2  # qua-5 dépend de qua-2

# Terminer
bd close qua-2

# Synchroniser
bd sync

Quand utiliser Beads

SituationBeads
Travail qui s’étend sur plusieurs sessions✓
Bugs découverts pendant le développement✓
Fonctionnalités avec dépendances✓
Projets avec plusieurs agents/personnes✓
Suivi de la dette technique✓
Issues que vous voulez dans l’historique git✓

Beads c’est pour la planification. Vous ne savez pas exactement ce que vous allez faire, mais vous savez quels problèmes il faut résoudre.

La différence clé

Tasks : “Je fais X, qui a les étapes A, B, C”

Beads : “Il faut résoudre X, Y, Z. Maintenant je travaille sur X.”

Tasks c’est la liste de courses pendant que vous cuisinez. Beads c’est le menu de la semaine.

Les utiliser ensemble

Le flux idéal combine les deux :

  1. Beads pour capturer le travail (issues, bugs, idées)
  2. Tasks pour exécuter ce travail étape par étape
# 1. Début de session : qu'est-ce qui est en attente ?
bd ready

# 2. Je choisis une issue
bd show qua-42
bd update qua-42 --status in_progress

# 3. Claude crée des Tasks pour les étapes
# (automatique quand je lui demande d'implémenter qua-42)

# 4. Pendant la session, je trouve un bug
bd create --title="Race condition dans le cache" --type=bug --priority=1

# 5. Je termine le travail original
bd close qua-42

# 6. Le bug reste pour une autre session
bd sync
git push

Migration conceptuelle

Si vous venez d’autres systèmes :

Vous venez de…Tasks équivaut à…Beads équivaut à…
JiraSous-tâches d’un ticketTickets du backlog
Linear-Linear complet
GitHub Issues-Issues
NotionChecklistBase de données de tâches
PapierListe d’aujourd’huiCarnet de projet

Configuration rapide

Tasks

Déjà incluses. Retenez juste :

  • Ctrl+T pour basculer la vue
  • CLAUDE_CODE_TASK_LIST_ID=nom pour la persistance
  • “clear all tasks” pour nettoyer

Beads

# Installer le plugin
claude mcp add beads-marketplace -- npx -y @anthropics/beads-mcp

# Dans votre projet
bd init

# Voir les commandes
bd help

Commandes utiles

Tasks

CommandeCe que ça fait
Ctrl+TBasculer la vue des tâches
/todosLister les tâches actuelles
“show me all tasks”Voir toutes (pas seulement 10)
“clear all tasks”Effacer la liste

Beads

CommandeCe que ça fait
bd readyIssues sans blocages
bd list -s openToutes les ouvertes
bd show <id>Détail d’une issue
bd createNouvelle issue
bd update <id>Modifier une issue
bd close <id>Fermer une issue
bd syncSynchroniser avec git
bd blockedVoir ce qui est bloqué

L’erreur courante

N’utilisez pas Beads comme Tasks. J’ai vu ceci :

# MAUVAIS : Beads pour des micro-tâches de session
bd create --title="Lire fichier X"
bd create --title="Modifier fonction Y"
bd create --title="Exécuter les tests"

C’est le travail de Tasks, pas de Beads. Beads c’est pour les choses qui comptent demain :

# BON : Beads pour du travail significatif
bd create --title="Implémenter authentification OAuth" --type=feature
bd create --title="Fuite mémoire dans worker" --type=bug
bd create --title="Migrer DB vers PostgreSQL" --type=epic

Le système à trois couches

Si vous travaillez avec Claude Code sur des projets sérieux, vous utilisez probablement déjà quelque chose comme Linear, Jira ou GitHub Projects pour la vision produit. Où cela s’intègre-t-il ?

La réponse est un système à trois couches par horizon temporel et audience :

CoucheHorizonAudienceOutil
StratégiqueSemaines/moisHumainLinear, Jira, etc.
TactiqueJours/sessionsLLMBeads
ExécutionMinutes/heuresLLMTasks

Pourquoi ça marche

Linear (ou votre outil produit) a ce que Beads ne peut pas offrir :

  • Roadmaps visuelles
  • Cycles et sprints
  • Intégrations (Slack, GitHub, etc.)
  • Interface pour penser en grand
  • Collaboration avec les parties prenantes

Beads a ce que Linear ne peut pas offrir :

  • Vit dans le repo (le LLM le voit sans configuration)
  • Latence zéro (local)
  • Dépendances que le LLM comprend nativement
  • Historique git des décisions
  • Fonctionne hors ligne

Tasks a ce qu’aucun des autres n’offre :

  • Création automatique
  • Visualisation en temps réel
  • Friction zéro

Le flux naturel

Linear (roadmap)
    ↓ vous décomposez manuellement
Beads (sprint/semaine)
    ↓ Claude décompose automatiquement
Tasks (session)

Éviter la duplication

Ne copiez pas les issues de Linear vers Beads littéralement. Beads devrait avoir le travail concret, pas la description produit.

# Linear (ce que vous voulez)
"Implémenter authentification OAuth avec Google et GitHub"

# Beads (ce qu'il faut faire)
qua-12: Configurer OAuth provider dans Supabase
qua-13: Endpoint /auth/callback
qua-14: Rotation des refresh tokens
qua-15: Tests e2e du flux de connexion

# Tasks (ce que je fais maintenant)
✓ Lire documentation Supabase Auth
● Créer migration pour table oauth_tokens
○ Implémenter callback handler

Linear dit ce que vous voulez. Beads dit ce qu’il faut faire. Tasks dit ce que je fais.

Résumé

AspectTasksBeadsLinear
HorizonHeuresJoursSemaines/mois
AudienceLLMLLMHumain
PortéeSessionProjetProduit
PersistanceOptionnelleGitCloud
DépendancesNonOuiOui
CréationAutomatiqueManuelleManuelle
CollaborationNonOui (git)Oui (équipe)
ObjectifExécutionTactiqueStratégie

En résumé : Trois couches de mémoire pour travailler avec l’IA : Linear pour la vision produit (semaines), Beads pour le travail tactique (jours), Tasks pour l’exécution (heures). Linear dit ce que vous voulez, Beads dit ce qu’il faut faire, Tasks dit ce que je fais. Ne dupliquez pas entre les couches.

Plus d’infos :


Cet article a été rédigé en espagnol et traduit avec l’aide de l’IA.