🌱 Empieza aquí · Saneamiento periódico del sistema

Esta semilla le enseña a tu asistente un buen hábito: cada cierto tiempo, revisar todo tu sistema de conocimiento (tus notas, su memoria, tu documentación, tus tareas) y curar lo que se ensució solo —referencias que quedaron apuntando a lo viejo, errores que se repiten, tareas que ya están hechas pero siguen abiertas, cosas que se desincronizaron—. Y lo hace con dos reglas que lo vuelven confiable: no mueve nada sin evidencia dura, y todo lo delicado te lo propone para tu firma en vez de tocarlo solo. Menos desorden acumulado, un sistema en el que tu asistente puede confiar.

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 el saneamiento periódico", "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. Se "siembra" colocando el método donde tú, el asistente, lo leas de forma automática al arrancar cada conversación, para aplicar el loop de saneamiento por tu cuenta cuando toque.

1. Copia el método donde lo leas siempre

El kernel trae dos archivos:

• kernel/saneamiento-periodico.md — el método en sí (el loop que vas a seguir).
• kernel/hallazgos-y-motores.ejemplo.md — una plantilla para aterrizar el método al sistema real de esta persona (qué barrer, con qué se arregla cada cosa, qué es intocable).

Coloca saneamiento-periodico.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/saneamiento-periodico.md "$HOME/.claude/rules/saneamiento-periodico.md"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo saneamiento-periodico.md. La plantilla de hallazgos 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/saneamiento-periodico.md). Si no, coloca saneamiento-periodico.md 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 el método de saneamiento-periodico.md cuando toque revisar la salud del sistema."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de saneamiento-periodico.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 ruteo a ESTE sistema (muy recomendado)

Abre kernel/hallazgos-y-motores.ejemplo.md. Con la persona (o detectándolo tú), llena las tablas con la realidad de su sistema, reemplazando los placeholders:

• Qué barrer: dónde viven de verdad sus notas, su memoria, sus tareas, sus repos (<TU-RUTA>, <TU-ARCHIVO-DE-MEMORIA>, <TU-CARPETA-DE-AGENTES>).
• Con qué se arregla cada hallazgo: si la persona ya tiene herramientas dedicadas (un auditor de memorias, un verificador de tareas), apúntalas; si no, tú harás el arreglo a mano en el mismo carril.
• La lista intocable: lo más importante. Anota con nombre y ruta qué archivos son canon / instrucciones / voz — eso NUNCA se auto-corrige, solo se propone. Por defecto, entra ahí el archivo maestro de instrucciones (<TU-ARCHIVO-DE-INSTRUCCIONES>, el CLAUDE.md o el AGENTS.md).

Cuando las tablas estén listas, úsalas como guía cada vez que corras el método, para que el barrido apunte a los archivos reales de la persona y respete sus fronteras. Si la persona no sabe dónde vive cada cosa, no pasa nada: deja las categorías genéricas 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 loop se aplica de verdad.

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

ls -la "$HOME/.claude/rules/saneamiento-periodico.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 loop se aplica (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva y te diga: "hazme un saneamiento rápido de mis notas". La conducta correcta es que: (1) primero declares qué fuentes vas a barrer, (2) reportes cada hallazgo con su evidencia citable (no "creo que…"), (3) marques lo seguro como aplicable solo y lo que toque instrucciones/voz/canon como "requiere tu firma", y (4) si no encuentras nada, lo digas con honestidad ("cero hallazgos, todo sano"). Si en vez de eso mueves algo delicado sin preguntar, o inventas un problema sin prueba, el método no se cargó: revisa que saneamiento-periodico.md 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 cierto tiempo tu asistente va a darse una vuelta por tus notas, su memoria, tu documentación y tus tareas, y te va a entregar una bitácora: "encontré esto viejo y ya lo corregí (era seguro), encontré esta tarea que ya estaba hecha y te propongo cerrarla, y encontré este tema delicado que solo tú puedes decidir". Nunca te lo va a dejar peor: no mueve nada sin prueba, y lo que toca tus reglas de fondo siempre te lo pregunta.

No tienes que hacer nada especial en el día a día. Solo vas a notar que tu sistema se mantiene limpio solo, que dejas de tropezarte con referencias viejas, y que tu asistente te atina más porque su mapa por fin coincide con el terreno. Eso es todo. 🌱