Aprende · la habilidad que le da memoria a Claude Code

Claude Code es brutal mientras está abierto. Cerrás la terminal y se olvidó todo: la decisión de arquitectura que tomaste en la madrugada, el bug raro que te tuvo dos horas, la regla que estableciste para no volver a pisar producción. Mañana abrís sesión nueva y arrancás explicando lo mismo otra vez.

Aprende termina con eso. Es una skill open-source (licencia MIT) hecha por @Hainrixz y la comunidad tododeia que convierte cada sesión de Claude Code en aprendizaje permanente. Escribís /aprende al final del día y la skill destila lo que pasó en memorias estructuradas que Claude lee la próxima vez que abras el proyecto.

El problema que resuelve

La amnesia de Claude entre sesiones no es solo molestia. Tiene tres consecuencias caras:

1. Repetís contexto — cada vez que arrancás, explicás de cero qué hace tu app, qué stack usás, qué errores ya pisaste. Eso son tokens y minutos.
2. Repetís errores — Claude vuelve a sugerirte la misma librería que ya descartaste porque no recuerda por qué la descartaste.
3. Perdés decisiones — las elecciones de arquitectura que tomaste en una sesión larga se evaporan. El siguiente día, Claude propone otra cosa y vos no te acordás por qué fuiste para el lado A.

Aprende ataca los tres frentes con un solo comando.

Los 5 pases que ejecuta

Cuando corrés /aprende, la skill no escupe texto a un archivo. Hace un pipeline ordenado:

1. Escanea la conversación entera. Lee lo que se habló en la sesión, qué archivos se tocaron, qué decisiones se tomaron, qué errores aparecieron.
2. Genera hasta 15 candidatos. Propone hasta quince fragmentos de memoria potenciales — cosas que vale la pena recordar. Si la sesión fue corta, propone menos.
3. Deduplica. Cruza los candidatos contra las memorias ya guardadas. Si una memoria nueva dice lo mismo que una vieja, la descarta o la fusiona.
4. Te muestra lista numerada. No guarda nada todavía. Te presenta los candidatos con número, categoría y motivo. Vos decidís cuáles entran.
5. Ejecuta solo lo aprobado. Le decís "1, 3, 7" y solo esas tres se persisten. El resto se descarta. Cero ruido.

Este patrón de "propone, pregunta, ejecuta" es el que diferencia a Aprende de las soluciones que escriben todo automático. La memoria útil es la memoria curada — guardar todo es lo mismo que no guardar nada porque después no encontrás lo importante.

Las 4 categorías de memoria

Aprende clasifica cada memoria en una de cuatro categorías. La categoría define dónde se guarda y cómo Claude la usa después.

memory

Hechos sobre el proyecto. "Este repo usa pnpm, no npm." "El backend está en apps/api, no en la raíz." "Las migraciones se corren con pnpm db:push, no con prisma migrate." Son verdades estables que Claude debería saber siempre.

lesson (Reflexion)

Errores y sus correcciones. "Intenté usar useEffect para fetchear data al montar y rompió el SSR. La solución fue mover el fetch a un Server Component." Esta categoría implementa el patrón Reflexion del paper de Noah Shinn — Claude reflexiona sobre lo que falló y guarda la lección para no repetirla.

skill stub

Embriones de skills. Si en la sesión hiciste tres veces el mismo proceso manual (preparar release notes, correr tests específicos, generar tipos), Aprende detecta el patrón y te propone convertirlo en una skill futura. No la crea automáticamente — te deja el stub.

project-doc

Documentación dual a CLAUDE.md + AGENTS.md. Esta es la categoría más importante a nivel estratégico. Aprende escribe las decisiones de arquitectura en los dos archivos que cualquier agente (Claude Code, Codex, Cursor) lee al abrir el repo. Si mañana cambiás de herramienta, tu documentación viaja con vos.

Por qué el dual CLAUDE.md + AGENTS.md importa

CLAUDE.md es el archivo de instrucciones de Anthropic. AGENTS.md es la propuesta abierta de la comunidad (Codex de OpenAI, varios otros la adoptaron). Escribir solo en uno te encadena a una herramienta.

Aprende escribe en los dos al mismo tiempo, y mantiene sincronización. Si actualizás una memoria, actualiza ambos archivos. Si la información es Claude-específica (por ejemplo, un slash command exclusivo), va solo a CLAUDE.md. Si es agnóstica, va a los dos.

Esto te da portabilidad: el día que quieras probar Codex o Cursor sobre el mismo repo, no empezás de cero — AGENTS.md ya tiene el contexto.

Cómo instalarla

# Desde el directorio raíz de tu proyecto
npx skills@latest add tododeia/aprende

La skill se instala en .claude/skills/aprende/. La primera vez que la usás, te pide configurar tres cosas:

• Dónde guardar las memorias (default: .claude/memories/)
• Cuántos candidatos generar por sesión (default: 15, podés bajarlo a 5 si querés algo más liviano)
• Si activar el hook post-session (opcional, corre /aprende automático al cerrar la sesión)

Workflow real con Aprende

El uso típico es así:

1. Abrís Claude Code y trabajás normalmente — picás features, debuggeás, refactorizás.
2. Cuando vas a cerrar, escribís /aprende.
3. Claude te muestra entre 5 y 15 candidatos numerados con su categoría.
4. Le respondés "guarda 2, 4, 5, 9". Tarda dos segundos.
5. Las memorias se persisten. CLAUDE.md y AGENTS.md se actualizan si correspondía.

Al día siguiente, abrís el repo y Claude ya sabe que pnpm es la convención, que el bug del SSR ya se resolvió, que tenés un stub de skill pendiente para release notes.

Sinergia con otras skills

Aprende no compite con Claude-Mem ni con MemPalace — opera en otra capa. Claude-Mem y MemPalace guardan el historial completo de conversaciones. Aprende guarda la destilación de esas conversaciones en memoria estructurada.

Combinación recomendada:

• Aprende para memoria curada (lo que importa).
• MemPalace o Claude-Mem para memoria episódica (todo lo que se habló, por si necesitás buscar después).
• Skills de proyecto (Skill Creator, Superpowers) en paralelo, no interfieren.

Lo que tiene que mejorar

Tres puntos a mirar de cerca antes de meterla en flujo serio:

• No tiene UI todavía. Toda la curación pasa por el chat. Si te gustan los dashboards (como el de Claude-Mem en localhost:37777), Aprende se siente austera.
• El parser de candidatos es heurístico. A veces propone memorias triviales ("el usuario quiere mejorar performance"). Vas a descartar mucho ruido las primeras semanas.
• Conflictos manuales. Si dos memorias se contradicen (cambiaste de opinión sobre algo), Aprende no las concilia automático — tenés que editarlas a mano.

Ninguno es bloqueante. Son cosas que la comunidad va a iterar.

Por qué importa que sea open-source y MIT

MIT te da tres cosas que ningún producto pago te da:

1. Forkeás si querés. Si la skill no hace exactamente lo que necesitás, la clonás y la modificás. Sin permisos, sin pedir a nadie.
2. No depende de un servicio. Aprende corre 100% local sobre tu Claude Code. No hay servidor remoto que pueda caer ni precio que pueda subir.
3. Auditabilidad. Podés leer cada línea de código. Saber qué guarda, qué no guarda, dónde lo guarda. Para skills que tocan memoria persistente, esto no es opcional.

Conclusión

La memoria es el problema número uno de los agentes de código, y la mayoría de las "soluciones" lo resuelven con fuerza bruta — guardan todo y después buscan. Aprende toma el camino opuesto: te ayuda a destilar la sesión en memorias chiquitas, curadas, categorizadas. Después de un mes usándola, tu CLAUDE.md deja de ser un archivo que escribiste una vez y nunca más tocaste, y se vuelve un documento vivo del proyecto.

Si recién arrancás con Claude Code, instalala. Si ya venís usándolo, instalala igual y corré /aprende retroactivo sobre tus sesiones recientes — vas a descubrir cuánta información valiosa se te estaba escapando.

Tags: aprende-skill, memoria, claude-code, skill, plugin, slash-command, hooks, reflexion, codex, open-source, hainrixz