Empieza aquí · Auditor de Memoria 🌱

Dile a tu asistente: "siembra esta semilla 🌱"

Con eso basta. Tu asistente hace todo lo técnico por ti. Tú solo confirmas cuando te pregunte.

¿Otras formas de pedirlo? "instala esta semilla", "activa este agente", "pon esto a funcionar". Te entiende igual. Vas a ver algunas palabras en inglés en la pantalla; ni caso, tu asistente te guía.

¿Qué hace esta semilla y por qué te sirve?

El problema. Le das a tu asistente notas, memoria y documentación para que trabaje mejor. Pero el tiempo pasa: renombras carpetas, subes de versión, mueves archivos, borras cosas. Y esas notas se quedan congeladas apuntando a un mundo que ya cambió. La nota dice que algo vive en tal carpeta, pero esa carpeta ya no existe. Dice que usas la versión 2, pero ya vas en la 4. Dice "lo hicimos ayer" y ese "ayer" fue hace tres meses. Poco a poco tu asistente confía en un mapa viejo, y empieza a equivocarse.

Qué hace esta semilla. Instala un agente auditor que revisa tus notas contra la realidad de tus archivos y te dice cuáles ya no son verdad. Su regla de oro: nunca opina, siempre prueba. No te dice "esto quizás está viejo"; te dice "esta nota apunta a esta carpeta, y aquí está el comando que muestra que la carpeta ya no existe". Cada hallazgo viene con su evidencia pegada. Así tú decides con datos, no con corazonadas.

Cómo funciona, en corto. Lee tus notas, saca de cada una los datos concretos (rutas, versiones, nombres), y los va comprobando uno por uno contra tus archivos reales y contra el historial de git. Lo que ya no cuadra, te lo reporta con la prueba. Lo que sí sigue siendo verdad, lo deja en paz.

Para el asistente que siembra 🤖

Eres el asistente. Sigue estos pasos con precisión. Esto es un agente de Claude Code / Cowork (un subagente con nombre propio), no un hook (gancho de automatización) ni un script: se instala copiando archivos Markdown a la carpeta de agentes del usuario. La plataforma lo descubre sola al leer esa carpeta. No lleva chmod y no se cablea en settings.json.

Paso 1 · Copiar el archivo del agente

El kernel trae dos archivos:

• kernel/memory-auditor.md — el agente en sí (esto es lo que se instala).
• kernel/fuentes-a-auditar.ejemplo.md — una plantilla para aterrizar QUÉ auditar en este sistema (se usa en el Paso 3, NO se copia a la carpeta de agentes).

Copia solo memory-auditor.md a la carpeta de agentes del usuario:

• macOS / Linux (Claude Code o Cowork):

  mkdir -p ~/.claude/agents
  cp kernel/memory-auditor.md ~/.claude/agents/memory-auditor.md
  

• Windows (Claude Code o Cowork):

  mkdir -p "$USERPROFILE/.claude/agents"
  cp kernel/memory-auditor.md "$USERPROFILE/.claude/agents/memory-auditor.md"
  

Sin permisos de ejecución y sin settings.json. A diferencia de un hook, un agente es un archivo de texto que la plataforma lee, no un programa que se ejecute. Con copiarlo a la carpeta agents es suficiente: Claude Code y Cowork lo detectan solos.

Paso 2 · Verificación post-siembra (obligatoria)

No declares "listo" sin correr esto. Confirma que el archivo llegó a su sitio y que su encabezado (frontmatter) quedó bien formado.

grep -m1 '^name:' ~/.claude/agents/memory-auditor.md

Salida esperada:

name: memory-auditor

En Windows, cambia ~ por "$USERPROFILE". Si no imprime nada, revisa que el archivo se haya copiado a la carpeta agents (no a hooks) y que el nombre sea exactamente memory-auditor.md.

Como comprobación adicional en una sesión interactiva de Claude Code, el comando /agents debe listar memory-auditor entre los agentes disponibles. Si aparece ahí, ya se puede invocar.

Paso 3 · Aterrizar QUÉ auditar (recomendado, opcional)

Abre kernel/fuentes-a-auditar.ejemplo.md. Con la persona (o detectándolo tú), llena las tablas con dónde vive de verdad cada cosa en su equipo, reemplazando los placeholders:

• <TU-ARCHIVO-DE-MEMORIA> → el archivo de memoria persistente del asistente (en Claude Code / Cowork suele ser ~/.claude/memory/MEMORY.md o el que use su plataforma).
• <TU-CARPETA-DE-NOTAS> → la carpeta donde viven sus notas de proyectos, clientes, decisiones.
• <TU-CARPETA-DE-REPOS> → dónde tiene sus repositorios de código (para el modo --amplio).
• <TU-CARPETA-DE-CONFIG> → la carpeta de config de su asistente (normalmente ~/.claude/).
• <TU-ARCHIVO-GRANDE-1> → uno o dos archivos de conocimiento que tiendan a inflarse (para el modo --salud).

Cuando las tablas estén listas, pega esa información como contexto al invocar al agente, o guárdala en el archivo de instrucciones del proyecto (CLAUDE.md / AGENTS.md) para que el agente sepa dónde mirar. Si la persona no sabe dónde vive cada cosa, no pasa nada: el agente detecta el scope por su cuenta; aterrizarlo solo lo hace más certero.

Ajuste opcional que la persona puede pedirte después (edítalo dentro del .md): el modelo en la línea model: inherit (puedes fijarlo a un modelo potente si quieres más rigor), y el archivo de aprendizajes del agente (<TU-ARCHIVO-DE-APRENDIZAJES>) si quiere que acumule qué rutas se mueven más seguido.

¿Cómo sé que funcionó?

Cuando tu asistente termine, pídele que corra la verificación del Paso 2 y te muestre el resultado. Si aparece name: memory-auditor, ya quedó sembrado.

Para probarlo de verdad, la próxima vez que muevas o renombres cosas, dile a tu asistente algo como: "audita mis notas a ver si algo quedó viejo" o "hazme un health check de mis memorias". El agente va a leer tus notas, comprobar cada dato contra tus archivos reales, y entregarte una lista de lo que ya no es verdad — cada hallazgo con su prueba pegada, para que tú decidas qué corregir. Lo que sigue siendo cierto, lo deja tranquilo. 🌱