🌱 Empieza aquí · Sprint de auditoría de salud del sistema

Imagina que tu sistema de trabajo (tus repos de código, tus documentos, tus notas) es una casa. Con el tiempo se juntan goteras que nadie ve: cambios sin guardar, notas viejas que se contradicen, links rotos, un manual que menciona cuartos que ya tiraste. Ninguna te avisa. Se acumulan hasta que un día una te inunda.

Esta semilla le enseña a tu asistente a hacer, cada cierto tiempo, una revisión de salud de esa casa: entra cuarto por cuarto, encuentra las goteras, tapa las fáciles sin molestarte, te avisa de las delicadas para que tú decidas, y —lo mejor— cuando encuentra una gotera que se repite, no solo la tapa: instala el mecanismo que evita que vuelva a gotear ahí.

Lo importante: antes de empezar, tu asistente firma el estándar de calidad con el que se va a juzgar el trabajo. Así no baja la vara al final con el clásico "ya casi".

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ó. 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 sprint de auditoría", "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: 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 para poder correr el sprint cuando la persona lo pida.

1. Copia el método donde lo leas siempre

El kernel trae dos archivos:

• kernel/auditoria-de-salud-del-sistema.md — el método en sí (las 5 reglas + las 4 fases).
• kernel/alcance-del-sprint.ejemplo.md — una plantilla para aterrizar el método a los repos, docs y fuente de verdad reales de esta persona.

Coloca auditoria-de-salud-del-sistema.md en el lugar que tu plataforma carga como instrucción permanente:

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

mkdir -p "$HOME/.claude/rules"
cp kernel/auditoria-de-salud-del-sistema.md "$HOME/.claude/rules/auditoria-de-salud-del-sistema.md"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo el método. La plantilla de alcance 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/auditoria-de-salud-del-sistema.md). Si no, coloca el método dentro del proyecto y agrega una línea que apunte a él en el archivo de instrucciones del proyecto (el CLAUDE.md), por ejemplo: "Para el sprint de auditoría, aplica el método de auditoria-de-salud-del-sistema.md."

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

2. Aterriza el alcance a ESTE sistema (recomendado)

Abre kernel/alcance-del-sprint.ejemplo.md. Con la persona (o detectándolo tú), llena la plantilla reemplazando los placeholders:

• <TU-ARCHIVO-DE-INSTRUCCIONES> → el archivo maestro de instrucciones (el CLAUDE.md o el AGENTS.md).
• <TU-ARCHIVO-DE-MEMORIA> → el archivo de memoria persistente (en Claude Code / Cowork suele ser ~/.claude/memory/MEMORY.md).
• <TU-RUTA-AL-REPO-N> → las carpetas reales de los repos de código a auditar.
• <TU-CARPETA-DE-DOCS-N> → las carpetas de documentos/notas a barrer.
• <TU-UMBRAL> y <POR-QUÉ-ESE-UMBRAL> → el listón de calidad que se firma al inicio.

Guarda esa plantilla llena junto al método (o pega su contenido dentro de él), para que el sprint sepa exactamente qué mirar y contra qué comparar. 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 sprint se puede correr de verdad.

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

ls -la "$HOME/.claude/rules/auditoria-de-salud-del-sistema.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 sprint se puede correr (prueba de comportamiento): pídele a la persona que abra una sesión nueva y diga "corre el sprint de auditoría de mi sistema". La conducta correcta es que tú, ANTES de tocar nada, firmes el listón de calidad, declares el alcance, y luego reportes los hallazgos clasificados con evidencia —sin borrar ni hacer push sin su firma—. Si en vez de eso empiezas a "arreglar" cosas a ciegas o firmas "todo sano" sin mostrar pruebas, 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, cuando le pidas a tu asistente correr el sprint, va a:

1. Firmar el estándar de calidad primero (no bajar la vara al final).
2. Barrer dos frentes: tus repos de código (cambios sin subir, ramas viejas, manuales que mencionan cosas que ya no existen) y tus documentos (contradicciones, info vieja, duplicados, links rotos, notas huérfanas).
3. Tapar solo lo seguro sin molestarte, avisarte de lo delicado, y nunca borrar ni publicar nada sin tu firma.
4. Mostrarte pruebas de cada arreglo (nada de "ya quedó" sin evidencia).
5. Convertir cada problema de fondo en una salvaguarda que evita que vuelva.

El resultado: tu sistema se mantiene sano solo, y los mismos errores dejan de repetirse. Eso es todo. 🌱