🌱 Empieza aquí · Índice de memoria en forma

Tu asistente guarda en un archivo lo que no quiere olvidar entre conversaciones (el estado de tus proyectos, decisiones, dónde vive cada cosa). Ese archivo se carga completo cada vez que abres una conversación nueva. Si crece sin freno, cada arranque se vuelve más caro y más lento, sin que lo notes.

Esta semilla le enseña a tu asistente un hábito de higiene: al terminar de trabajar, mide ese archivo, quita lo que sobra de forma segura, baja el exceso a archivos aparte (sin perder nada) y no te deja cerrar si el archivo se pasó de tamaño. Resultado: arranques más ligeros, para siempre, sin que tú tengas que limpiar a mano.

Para instalarla

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace todo lo demás y al final te dice cómo comprobar que quedó funcionando. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar la higiene del índice de memoria", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un workflow (método de trabajo), no un programa ejecutable. No es un hook (gancho de automatización): no lleva chmod, no lleva entrada en settings.json y no ejecuta ningún script por sí solo. Se "siembra" colocando el método donde tú, el asistente, lo leas de forma automática al arrancar cada conversación, para aplicar el reflejo por tu cuenta al cerrar sesión.

Nota de sinergia (opcional pero recomendada): el paso 4 del método (el "candado" que bloquea el cierre si el archivo se pasó) se automatiza de verdad con la semilla hermana "Guardián de Cap de Memoria" (un hook). Si el usuario la tiene o la quiere, instálala también; si no, el candado se cumple como chequeo manual (mides el archivo antes de cerrar). Esta semilla funciona por sí sola de cualquier modo.

1. Copia el método donde lo leas siempre

El kernel trae dos archivos:

• kernel/mantenimiento-indice-memoria.md — el método en sí (el reflejo de higiene).
• kernel/contrato-de-cap.ejemplo.md — una plantilla para definir los límites reales de esta persona y a dónde baja el exceso.

Coloca mantenimiento-indice-memoria.md en el lugar que tu plataforma carga automáticamente como instrucción permanente:

Claude Code (macOS / Linux / Windows con Git Bash):

mkdir -p "$HOME/.claude/rules"
cp kernel/mantenimiento-indice-memoria.md "$HOME/.claude/rules/mantenimiento-indice-memoria.md"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo el método. La plantilla del contrato NO va en esa carpeta (no es una regla, es una guía que usas en el paso 2).

Cowork: usa la misma carpeta de reglas si tu proyecto la soporta (.claude/rules/mantenimiento-indice-memoria.md). Si no, coloca el archivo dentro del proyecto y agrega una línea que apunte a él en el archivo de instrucciones del proyecto (el CLAUDE.md), por ejemplo: "Aplica siempre el método de mantenimiento-indice-memoria.md: mantén el índice de memoria dentro de su límite al cerrar."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de mantenimiento-indice-memoria.md dentro de AGENTS.md (o agrégale un puntero al archivo si lo guardas aparte en el proyecto), para que el método se cargue con el resto de tus instrucciones.

2. Aterriza el contrato de límite a ESTE sistema (recomendado)

Abre kernel/contrato-de-cap.ejemplo.md. Con la persona (o detectándolo tú), llena la tabla reemplazando los placeholders:

• <TU-ARCHIVO-DE-MEMORIA> → el archivo de memoria persistente de tu plataforma (en Claude Code / Cowork suele ser ~/.claude/memory/MEMORY.md o el que se cargue en cada boot).
• <TU-ARCHIVO-HISTORICO> → un archivo aparte a donde mandar lo muy viejo.
• <TU-CARPETA-DE-DECISIONES> / <TU-CARPETA-DE-SESIONES> / <TU-CARPETA-DE-APRENDIZAJES> → dónde viven (o vivirán) los archivos de detalle.
• Los números de límite → deja los sugeridos (180 líneas / 25 KB / 180 caracteres por entrada) o ajústalos al archivo real.

Cuando la tabla esté lista, pega esos valores dentro de la sección "Tu contrato de límite" del método que copiaste en el paso 1, para que el reflejo apunte a los archivos y números reales de la persona. Si la persona no sabe dónde vive cada cosa, no pasa nada: deja los valores genéricos y el método sigue funcionando.

3. Verificación post-siembra (obligatoria)

Como es un método (texto), la verificación tiene dos partes: que el archivo quedó en su lugar, y que el reflejo se aplica de verdad.

a) El archivo quedó colocado (ejemplo Claude Code):

ls -la "$HOME/.claude/rules/mantenimiento-indice-memoria.md"; echo "exit=$?"

Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. Si sale No such file or directory, la copia no se hizo; repite el paso 1.

b) El reflejo se aplica (prueba de comportamiento): pídele a la persona que, al terminar de trabajar, te diga "cerramos". La conducta correcta es que primero midas el archivo de memoria (líneas, tamaño, entradas largas), reportes esos números, podes lo seguro, bajes el exceso a archivos de detalle con su puntero, y solo declares "dentro de límite" con la medición final citada. Si en vez de eso cierras sin medir, el método no se cargó: revisa que el archivo esté en la carpeta de reglas (o dentro de AGENTS.md en Codex).

Cuando ambas partes pasen, avísale a la persona en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cada vez que cierres una sesión, tu asistente le va a dar una pasada de higiene a su archivo de memoria: lo mide, quita lo que sobra, guarda lo importante en archivos aparte (sin perder nada) y se asegura de que no se pasó de tamaño. Tú no tienes que hacer nada.

Con el tiempo vas a notar que tus conversaciones arrancan más ligeras y rápidas, porque ese archivo que se carga al inicio se mantiene delgado solo. Eso es todo. 🌱