🌱 Empieza aquí · Reportar el estado más reciente, no el oficial
Esta semilla le enseña a tu asistente un buen hábito: antes de decirte "cómo va" un proyecto, revisa todas tus fuentes de estado, mira cuál es la más reciente de verdad, y arma la foto desde esa, no desde la que "oficialmente" guarda el estado (porque a veces la oficial ya quedó vieja). Nunca te reporta información pasada como si fuera de hoy.
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 filtro de frescura de estado", "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 correr el
gate de frescura por tu cuenta antes de reportar cualquier estado.
1. Copia el método donde lo leas siempre
El kernel trae dos archivos:
kernel/freshness-gate.md— el método en sí (el gate que vas a correr antes de reportar estado).kernel/mapa-de-fuentes.ejemplo.md— una plantilla para aterrizar el método a las fuentes reales de esta persona.
Coloca freshness-gate.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/freshness-gate.md "$HOME/.claude/rules/freshness-gate.md"
Los archivos dentro de
~/.claude/rules/se cargan solos al inicio de cada sesión. Copia ahí solofreshness-gate.md. El mapa de fuentes 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/freshness-gate.md). Si no, coloca freshness-gate.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 siempre el gate de freshness-gate.md: reconcilia el
estado por frescura antes de reportarlo."
Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de
freshness-gate.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 las fuentes a ESTE sistema (recomendado)
Abre kernel/mapa-de-fuentes.ejemplo.md. Con la persona (o detectándolo tú), llena la
tabla con dónde vive cada fuente de estado en su sistema y, sobre todo, qué marca de
fecha leer en cada una (la de contenido, no la de modificación del archivo), reemplazando
los placeholders:
<TU-RUTA>→ una carpeta o archivo real donde viven esas notas (el documento de estado, las bitácoras de sesión, los planes).<TU-ARCHIVO-DE-MEMORIA>→ el archivo de memoria persistente de tu plataforma (en Claude Code / Cowork suele ser~/.claude/memory/MEMORY.md).
Cuando la tabla esté lista, pega sus filas dentro del freshness-gate.md que copiaste en
el paso 1, justo debajo del paso «2 · Enumera las fuentes de estado que aplican al tema»,
para que el gate apunte directo a los archivos reales de la persona en vez de a las
categorías genéricas. 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 gate se aplica de verdad.
a) El archivo quedó colocado (ejemplo Claude Code):
ls -la "$HOME/.claude/rules/freshness-gate.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 gate se aplica (prueba de comportamiento, en una conversación nueva):
Prepara una trampa sencilla. Pídele a la persona que tenga un documento "oficial" de estado
con una fecha vieja en el cuerpo, y una bitácora de sesión más reciente que lo contradiga.
Luego, en una sesión nueva, que te pregunte "¿cómo va [ese proyecto]?". La conducta
correcta es que primero reconcilies por frescura, dejes ganar a la bitácora reciente
sobre el documento oficial viejo, y avises en una línea que el oficial estaba desactualizado.
Si en vez de eso reportas el estado viejo del documento oficial como si fuera de hoy, el
método no se cargó: revisa que freshness-gate.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, cuando tu asistente te diga "cómo va" algo, ya no se va a creer a ciegas el documento que "oficialmente" guarda el estado. Primero va a mirar cuál de tus fuentes es la más reciente de verdad, va a armar la foto desde esa, y si el documento oficial estaba viejo, te lo va a avisar en una línea en vez de reportarte lo pasado como si fuera de hoy.
Vas a notar tres cambios: deja de reportarte cosas ya hechas como pendientes, deja de confundir un plan con algo cumplido, y cuando algo no lo puede confirmar te lo dice ("por confirmar") en vez de inventarlo. Menos decisiones sobre fotos equivocadas. Eso es todo. 🌱