Aprende · la habilidad que le da memoria a Claude Code

Voy a instalar la habilidad aprende (https://github.com/Hainrixz/aprende-skill). Antes de hacerlo, quiero un diagnóstico rápido en seis puntos.

1. Revisa la versión de Claude Code instalada. Tiene que ser 2.0 o superior. Si no llegamos a esa versión, dime cómo actualizar (npm install -g @anthropic-ai/claude-code@latest si me instalé por npm; reinstalar la app si me instalé por desktop).

2. Verifica permisos de escritura en ~/.claude/. Lista los archivos que ya viven ahí (projects/, skills/, settings.json si existe). Si la carpeta no existe todavía, dímelo — eso es normal en una instalación nueva.

3. Revisa si este repo donde estamos ya tiene CLAUDE.md o AGENTS.md. Si los tiene, abre los primeros 20 renglones de cada uno y dime qué encontraste (esto importa porque aprende va a hacer escritura dual a los dos archivos).

4. Comprueba si por error tengo alguna otra habilidad de memoria activa (claude-mem, mempalace, claude-reflect). Lee ~/.claude/settings.json si existe y dime qué hooks tiene registrados.

5. Resumen en cuatro bullets:
   - Versión de Claude Code: <X.Y>
   - Permisos en ~/.claude/: <ok / faltan>
   - CLAUDE.md / AGENTS.md en el repo: <existen / no existen>
   - Otras habilidades de memoria activas: <ninguna / cuáles>

6. Recomendación final: ¿puedo seguir con /plugin marketplace add Hainrixz/aprende-skill o necesito arreglar algo primero?

No instales ni borres nada. Solo el reporte. Cuando lo apruebe, te paso el siguiente prompt.

Acabamos de terminar una sesión donde trabajamos en este proyecto. Antes de cerrar, quiero correr /aprende por primera vez y entender cada paso.

1. Antes de correrlo, hazme un resumen de la sesión en tres bullets: qué corregí, qué errores resolvimos juntos, qué decisión tomé que el agente debería recordar la próxima vez. Esto me ayuda a saber qué esperar de la lista.

2. Ahora corre /aprende. Cuando aparezca la lista numerada de candidatos, NO me pidas la confirmación todavía. En vez de eso, para cada candidato dime:
   - Qué señal lo originó (corrección explícita, error → fix, patrón repetido, explicación de por qué, workflow descrito).
   - Por qué cayó en esa categoría (memory, lesson, skill, o project-doc) y no en otra.
   - Qué confidence label tiene (alta, media, baja) y por qué.
   - Si tiene un marcador [overlaps with: ...], dime con qué se solapa.

3. Después de tu explicación, te digo qué números aprobar. Espero usar números o rangos (1,3-5 por ejemplo). Si no quiero guardar ninguno, digo 'none'. Si quiero guardar todos los de alta confidence y descartar los de baja, digo 'drop low'.

4. Cuando ejecutes las escrituras, dime archivo por archivo cuál escribiste y a qué ruta exacta (no me digas solo 'guardé el memory', dime ~/.claude/projects/<slug>/memory/<filename>.md).

5. Al final, abre MEMORY.md y muéstrame las líneas que se agregaron. Quiero verificar que el índice quedó al día.

Si algo falla:
- /aprende no aparece como comando → corrí /plugin install aprende@aprende-skill antes de esto?
- La lista está vacía → quizás la sesión fue corta o no hubo correcciones; corre /aprende otra vez después de una sesión más cargada.
- Permisos negados al escribir → revisa que ~/.claude/projects/<slug>/memory/ exista y tenga permisos de escritura.

Es momento de revisar las lessons que aprende ha guardado durante el último mes. Antes de correr /aprende --review, quiero un mapa completo.

1. Lista todas las lessons del proyecto actual. Lee ~/.claude/projects/<slug>/memory/ y filtra solo los archivos que empiezan con lesson_. Para cada uno extrae: filename, fecha de creación (frontmatter), título corto, y status si existe (active, retired, draft).

2. Para cada lesson, clasifícala con un semáforo:
   - 🟢 Verde: La lesson sigue siendo relevante. Las 4 secciones Reflexion (qué pasó / por qué / cómo evitar / señal de detección) tienen sentido contra el estado actual del repo.
   - 🟡 Amarillo: Borderline. La lesson capturó algo que pasó pero el código ya cambió. Necesita refresh o nota.
   - 🔴 Rojo: Retirada. La lesson ya no aplica porque el archivo se borró, la stack cambió, o resultó ser un falso positivo.

3. Ahora corre /aprende --review y deja que la habilidad haga su pasada. Cuando termine, compárame su clasificación con la mía. Si discrepamos, dime en cuál y por qué.

4. Para las lessons clasificadas en rojo, NO uses rm. Edita el frontmatter y agrega status: retired más una línea retired_at: YYYY-MM-DD. La auditoría importa.

5. Al final, dame un resumen:
   - Total de lessons al inicio: N
   - Verdes (vigentes): N
   - Amarillas (necesitan refresh): N
   - Rojas (retiradas en este review): N

Si algo falla:
- /aprende --review no encuentra lessons → quizás todavía no has guardado ninguna. Corre /aprende primero después de una sesión donde resolvieron un error.
- El frontmatter no tiene type: lesson → quizás es una memoria normal, no una lesson. Verifica con grep "^type:" en los archivos.

Quiero abrir este proyecto también en Codex y necesito que conserve la memoria que aprende ya guardó en Claude Code. Hazlo en este orden.

1. Verifica que aprende ya tiene contenido para migrar. Cuenta cuántos archivos hay en ~/.claude/projects/<slug>/memory/ (memorias y lessons). Si hay cero, dímelo y detente acá — no hay nada que migrar todavía.

2. Corre /aprende --portable. Esto hace dos cosas: la corrida estándar (escanea, presenta candidatos, espera confirmación) y al ejecutar también espeja las lessons aprobadas a ./.aprende/lessons/ en la raíz del proyecto.

3. Verifica que ./.aprende/ quedó creado. Listame su contenido:
   - ./.aprende/index.md (debe existir)
   - ./.aprende/lessons/<filename>.md por cada lesson que se mirrors

4. Abre el AGENTS.md del proyecto. Tiene que tener una línea agregada automáticamente apuntando a ./.aprende/index.md. Si no la tiene, agrega tú esta línea al final de la sección de project-docs:

   ## Aprende mirror
   Las lessons espejadas viven en ./.aprende/lessons/. El índice está en ./.aprende/index.md.

5. Smoke test desde Codex (manual): cuando abras el proyecto en Codex, pídele "lee AGENTS.md y dime qué lessons hay en ./.aprende/lessons/". Si responde con la lista, la migración funcionó.

Si algo falla:
- ./.aprende/ no se creó → confirma que corriste --portable, no /aprende solo. El flag es lo que activa el mirror.
- AGENTS.md no recibió la línea → revisa permisos de escritura en la raíz del proyecto.
- Codex no encuentra el index → quizás abrió el proyecto antes de que terminara la corrida. Cierra Codex, vuelve a abrir.

Quiero hacer una limpieza guiada de mi carpeta de memoria. No borres ni edites nada — solo me das un reporte y yo apruebo después.

1. Listame todo lo que vive en ~/.claude/projects/<slug>/memory/ (donde <slug> es el slug del proyecto actual). Agrupa por tipo:
   - feedback_*.md (preferencias del usuario)
   - project_*.md (contexto del proyecto)
   - lesson_*.md (lessons estilo Reflexion)
   - otros (cualquier cosa que no entre en los tres anteriores)

2. Por cada archivo extrae: filename, una línea de resumen del cuerpo, fecha del frontmatter, status si existe.

3. Detecta overlaps. Para cada par de archivos que cubre el mismo tema (mismo error, misma preferencia, misma convención), marca el par con [overlap potencial: <razon de 1 línea>]. NO los unas todavía — solo márcalos.

4. Sugiere hasta 3 archivos para retirar (no borrar). Para cada uno explícame:
   - Por qué deberías retirarlo (obsoleto, cubierto por otro, capturado por error).
   - Qué archivo lo reemplaza si aplica.
   - El comando de edición que ejecutaría: 'edit ~/.claude/projects/<slug>/memory/<filename>.md y agregar status: retired al frontmatter'.

5. Pregunta confirmación archivo por archivo. Si apruebo, edita solo el frontmatter (agregar status: retired y retired_at: YYYY-MM-DD). Si no apruebo, déjalo intacto y pasa al siguiente.

6. Al final, actualiza MEMORY.md para que el índice refleje los nuevos status. Muéstrame las líneas modificadas.

Si algo falla:
- Carpeta vacía → /aprende aún no ha capturado nada en este proyecto. Corre una sesión y luego /aprende.
- Permisos negados → revisa que tu usuario sea dueño de ~/.claude/projects/.

Una lesson que aprende guardó resultó ser un falso positivo. No la borres — márquemela como retirada con el rastro de auditoría.

1. Te paso el filename exacto (o yo te lo digo después de que listes los disponibles). Ejemplo:
   ~/.claude/projects/<slug>/memory/lesson_<algo>.md

2. Antes de editar, ábrelo y muéstrame:
   - El frontmatter actual (todo el bloque YAML).
   - Las 4 secciones Reflexion (qué pasó / por qué / cómo evitar / señal de detección).

3. Hazme una pregunta corta: ¿por qué crees que es falso positivo? Espera mi respuesta — la voy a copiar tal cual al frontmatter como motivo.

4. Cuando responda, edita el frontmatter agregando estos campos (sin tocar el resto del archivo):
   - status: retired
   - retired_at: <fecha de hoy YYYY-MM-DD>
   - retired_reason: <mi respuesta literal>

5. Actualiza MEMORY.md: cambia la línea que apunta a esta lesson para que diga (retirada YYYY-MM-DD: <motivo abreviado>).

6. Confirma el cambio:
   - Vuelve a abrir la lesson y muéstrame el frontmatter nuevo.
   - Vuelve a abrir MEMORY.md y muéstrame la línea actualizada.

7. No borres el archivo. Importa el rastro: en un /aprende --review futuro vamos a poder revisar las lessons retiradas y ver patrones de falsos positivos.

Si algo falla:
- No encuentras el archivo → quizás está en otra carpeta de proyecto. Lista todas las carpetas en ~/.claude/projects/ que tienen lessons.
- El archivo ya tiene status: retired → confirma fecha y motivo viejo, y pregunta si quiero sobrescribir.

Quiero guardar una lesson manualmente sin correr /aprende. Tengo el contenido en la cabeza y necesito que me lo formatees con las 4 secciones Reflexion y lo guardes en el lugar correcto.

1. Pregúntame las 4 secciones, una por una, esperando mi respuesta antes de pasar a la siguiente:
   - **Qué pasó:** el evento concreto (error, mistake, mala decisión).
   - **Por qué pasó:** la causa raíz, no el síntoma.
   - **Cómo evitar:** la regla práctica que el agente debe seguir la próxima vez.
   - **Señal de detección:** qué patrón en el código o en el log indica que el mismo error está a punto de repetirse.

2. Cuando tenga las 4 respuestas, propónme un filename corto en kebab-case con prefijo lesson_ (ejemplo: lesson_webview-localstorage.md). Espera mi visto bueno antes de escribir.

3. Arma el archivo final con este formato exacto:

   ---
   type: lesson
   created_at: <fecha hoy YYYY-MM-DD>
   status: active
   confidence: <pregúntame: alta / media / baja>
   ---

   # <título corto en una línea>

   **Qué pasó:** <respuesta 1>

   **Por qué pasó:** <respuesta 2>

   **Cómo evitar:** <respuesta 3>

   **Señal de detección:** <respuesta 4>

4. Guarda el archivo en ~/.claude/projects/<slug>/memory/<filename>.md (donde <slug> es el slug del proyecto actual).

5. Actualiza MEMORY.md agregando una línea al final con el filename + el título.

6. Confírmame qué quedó:
   - Ruta del archivo nuevo.
   - Línea agregada a MEMORY.md.

Si algo falla:
- Carpeta memory/ no existe → créala primero con mkdir -p antes de escribir.
- Filename ya existe → propón una variación (lesson_<base>-v2.md) y pregunta cuál usar.