Linear, Beads y Tasks: Tres capas de memoria para Claude Code

El problema de la memoria

Claude Code tiene un problema: se le olvida todo. Cierras la sesión, abres otra, y es como hablar con alguien que no te conoce. Puedes cargar contexto con CLAUDE.md, sí, pero ¿qué pasa con las tareas a medio hacer? ¿Los bugs que encontraste pero no arreglaste? ¿El plan que tenías para mañana?

Hay tres soluciones que se complementan: Linear (o tu herramienta de producto), Beads (plugin git-backed) y Tasks (integradas en Claude Code). Cada una para un horizonte temporal diferente.

Tasks: La memoria de trabajo

Tasks es el sistema interno de Claude Code para trackear lo que está haciendo ahora mismo. Cuando le pides algo complejo, Claude crea una lista de tareas automáticamente.

Pulsa Ctrl+T para verlas:

┌─────────────────────────────────────────────────┐
│ Tasks                                           │
├─────────────────────────────────────────────────┤
│ ✓ Leer estructura del proyecto                  │
│ ● Implementar endpoint de autenticación         │
│ ○ Escribir tests                                │
│ ○ Actualizar documentación                      │
└─────────────────────────────────────────────────┘

Características

• Automáticas: Claude las crea cuando el trabajo tiene varios pasos
• Persistentes tras compaction: Sobreviven cuando el contexto se compacta
• Visibles con Ctrl+T: Toggle rápido de la vista
• Limitadas a 10: Solo muestra las 10 primeras (pide «show me all tasks» para ver más)

Compartir entre sesiones

Por defecto, las Tasks mueren con la sesión. Pero puedes hacerlas persistentes:

CLAUDE_CODE_TASK_LIST_ID=qualitra claude

Esto guarda las tareas en ~/.claude/tasks/qualitra/. La próxima vez que arranques con el mismo ID, recuperas la lista.

Cuándo usar Tasks

Situación	Tasks
Implementar una feature en una sesión	✓
Seguir un plan de trabajo definido	✓
Debugging paso a paso	✓
Refactoring con pasos claros	✓

Tasks es para ejecución. Sabes lo que hay que hacer, solo necesitas seguimiento.

Beads: La memoria del proyecto

Beads es un plugin que añade un issue tracker completo, almacenado en git. Piensa en él como «Linear pero local y gratis».

bd list --status open

ID          TYPE    PRI  STATUS       TITLE
qua-1       epic    P2   open         Scoring Raven
qua-2       task    P1   in_progress  Implementar scoring module
qua-3       bug     P0   blocked      Stack overflow en acquireStartLock

Características

• Git-backed: Los issues viven en .beads/ y se commitean con tu código
• Dependencias: Un issue puede bloquear a otro
• Prioridades y tipos: Epics, tasks, bugs, features, chores
• Multi-sesión: El contexto persiste entre sesiones (y personas)
• Hooks: Se sincroniza automáticamente con bd sync

El flujo de trabajo

# Encontrar trabajo disponible
bd ready

# Ver detalles
bd show qua-2

# Empezar a trabajar
bd update qua-2 --status in_progress

# Crear sub-tareas
bd create --title="Escribir tests PBT" --type=task
bd dep add qua-5 qua-2  # qua-5 depende de qua-2

# Terminar
bd close qua-2

# Sincronizar
bd sync

Cuándo usar Beads

Situación	Beads
Trabajo que abarca varias sesiones	✓
Bugs descubiertos durante desarrollo	✓
Features con dependencias	✓
Proyectos con múltiples agentes/personas	✓
Tracking de deuda técnica	✓
Issues que quieres en git history	✓

Beads es para planificación. No sabes exactamente qué harás, pero sabes qué problemas hay que resolver.

La diferencia clave

Tasks: «Estoy haciendo X, que tiene pasos A, B, C»

Beads: «Hay que resolver X, Y, Z. Ahora trabajo en X.»

Tasks es la lista de la compra mientras cocinas. Beads es el menú de la semana.

Usarlos juntos

El flujo ideal combina ambos:

1. Beads para capturar trabajo (issues, bugs, ideas)
2. Tasks para ejecutar ese trabajo paso a paso

# 1. Inicio de sesión: qué hay pendiente?
bd ready

# 2. Elijo un issue
bd show qua-42
bd update qua-42 --status in_progress

# 3. Claude crea Tasks para los pasos
# (automático cuando le pido implementar qua-42)

# 4. Durante la sesión, encuentro un bug
bd create --title="Race condition en cache" --type=bug --priority=1

# 5. Termino el trabajo original
bd close qua-42

# 6. El bug queda para otra sesión
bd sync
git push

Migración mental

Si vienes de otros sistemas:

Vienes de…	Tasks equivale a…	Beads equivale a…
Jira	Subtasks de un ticket	Tickets del backlog
Linear	–	Linear completo
GitHub Issues	–	Issues
Notion	Checklist	Database de tareas
Papel	Lista de hoy	Cuaderno de proyecto

Setup rápido

Tasks

Ya vienen incluidas. Solo recuerda:

• Ctrl+T para toggle de vista
• CLAUDE_CODE_TASK_LIST_ID=nombre para persistencia
• «clear all tasks» para limpiar

Beads

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

# En tu proyecto
bd init

# Ver comandos
bd help

Comandos útiles

Tasks

Comando	Qué hace
Ctrl+T	Toggle vista de tareas
/todos	Listar tareas actuales
«show me all tasks»	Ver todas (no solo 10)
«clear all tasks»	Borrar lista

Beads

Comando	Qué hace
bd ready	Issues sin bloqueos
bd list -s open	Todos los abiertos
bd show <id>	Detalle de issue
bd create	Nuevo issue
bd update <id>	Modificar issue
bd close <id>	Cerrar issue
bd sync	Sincronizar con git
bd blocked	Ver qué está bloqueado

El error común

No uses Beads como Tasks. He visto esto:

# MAL: Beads para micro-tareas de sesión
bd create --title="Leer archivo X"
bd create --title="Modificar función Y"
bd create --title="Ejecutar tests"

Eso es trabajo de Tasks, no de Beads. Beads es para cosas que importan mañana:

# BIEN: Beads para trabajo significativo
bd create --title="Implementar autenticación OAuth" --type=feature
bd create --title="Memory leak en worker" --type=bug
bd create --title="Migrar DB a PostgreSQL" --type=epic

El sistema de tres capas

Si trabajas con Claude Code en proyectos serios, probablemente ya uses algo como Linear, Jira o GitHub Projects para la visión de producto. ¿Dónde encaja eso?

La respuesta es un sistema de tres capas por horizonte temporal y audiencia:

Capa	Horizonte	Audiencia	Herramienta
Estratégica	Semanas/meses	Humano	Linear, Jira, etc.
Táctica	Días/sesiones	LLM	Beads
Ejecución	Minutos/horas	LLM	Tasks

Por qué funciona

Linear (o tu herramienta de producto) tiene lo que Beads no puede ofrecer:

• Roadmaps visuales
• Cycles y sprints
• Integraciones (Slack, GitHub, etc.)
• UI para pensar en grande
• Colaboración con stakeholders

Beads tiene lo que Linear no puede ofrecer:

• Vive en el repo (el LLM lo ve sin configuración)
• Cero latencia (local)
• Dependencias que el LLM entiende nativamente
• Git history de las decisiones
• Funciona offline

Tasks tiene lo que ninguno de los otros ofrece:

• Creación automática
• Visualización en tiempo real
• Cero fricción

El flujo natural

Linear (roadmap)
    ↓ descompones manualmente
Beads (sprint/semana)
    ↓ Claude descompone automáticamente
Tasks (sesión)

Evitar duplicación

No copies issues de Linear a Beads literalmente. Beads debería tener el trabajo concreto, no la descripción de producto.

# Linear (qué quieres)
"Implementar autenticación OAuth con Google y GitHub"

# Beads (qué hay que hacer)
qua-12: Configurar OAuth provider en Supabase
qua-13: Endpoint /auth/callback
qua-14: Refresh token rotation
qua-15: Tests e2e de login flow

# Tasks (qué estoy haciendo ahora)
✓ Leer documentación de Supabase Auth
● Crear migración para tabla oauth_tokens
○ Implementar callback handler

Linear dice qué quieres. Beads dice qué hay que hacer. Tasks dice qué estoy haciendo.

Resumen

Aspecto	Tasks	Beads	Linear
Horizonte	Horas	Días	Semanas/meses
Audiencia	LLM	LLM	Humano
Alcance	Sesión	Proyecto	Producto
Persistencia	Opcional	Git	Cloud
Dependencias	No	Sí	Sí
Creación	Automática	Manual	Manual
Colaboración	No	Sí (git)	Sí (equipo)
Propósito	Ejecución	Táctica	Estrategia

---

TL;DR: Tres capas de memoria para trabajar con IA: Linear para visión de producto (semanas), Beads para trabajo táctico (días), Tasks para ejecución (horas). Linear dice qué quieres, Beads dice qué hay que hacer, Tasks dice qué estoy haciendo. No dupliques entre capas.

Más info: – Tasks – Claude Code Docs – Beads – GitHub – Linear

---

Read this article in English.