🌱 Empieza aquí · Checkpoint de contexto

Esta semilla le enseña a tu asistente a hacer un punto de guardado cuando una conversación de trabajo se está alargando tanto que ya empieza a olvidar detalles. En vez de perder el hilo, tu asistente guarda todo el estado de la tarea, arma el plan de lo que falta, y te da un mensaje corto para reiniciar la conversación y retomar exactamente donde ibas, sin lagunas.

Es como cuando un videojuego guarda tu avance antes de apagar: prendes después y sigues desde el mismo lugar.

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 técnico 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 checkpoint de contexto", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Esto es un skill (habilidad), no un hook (gancho de automatización). No necesita settings.json ni permisos de ejecución: los skills se descubren solos cuando viven en la carpeta correcta. Tu trabajo es copiar el archivo del kernel al lugar adecuado y verificar que quedó.

1. Decide el alcance con el usuario

• Alcance global (recomendado): disponible en todas las conversaciones del usuario. Va en $HOME/.claude/skills/plan-checkpoint/SKILL.md.
• Alcance de un proyecto: solo dentro de una carpeta específica. Va en <TU-RUTA>/.claude/skills/plan-checkpoint/SKILL.md, donde <TU-RUTA> es la carpeta raíz del proyecto del usuario.

Si el usuario no tiene preferencia, usa el alcance global.

2. Copia el archivo del kernel

Claude Code / Cowork (macOS o Linux), alcance global:

mkdir -p "$HOME/.claude/skills/plan-checkpoint"
cp kernel/SKILL.md "$HOME/.claude/skills/plan-checkpoint/SKILL.md"

Windows (Git Bash / WSL): misma ruta ~/.claude/skills/plan-checkpoint/. Es un archivo de texto, así que funciona igual en cualquier sistema. Si prefieres PowerShell nativo:

New-Item -ItemType Directory -Force "$HOME\.claude\skills\plan-checkpoint"
Copy-Item kernel\SKILL.md "$HOME\.claude\skills\plan-checkpoint\SKILL.md"

No hace falta chmod: SKILL.md es un archivo de texto que el asistente lee, no un programa que se ejecute.

3. (Opcional) Aterriza los dos placeholders del método

El skill funciona tal cual, sin tocar nada. Solo hay dos placeholders y ambos son opcionales; viven dentro del método, no en el archivo de instalación:

• <TU-CARPETA-DE-RECARGA> → la carpeta donde el asistente dejará el archivo de recarga temporal (RETOMAR-<slug>.txt). Por defecto sirve cualquier carpeta de trabajo temporal del asistente; si el usuario quiere una fija, edítala una vez en el SKILL.md.
• <slug> → no se configura; es un nombre corto que el asistente inventa por cada trabajo al momento de hacer el checkpoint (por ejemplo RETOMAR-reporte-ventas.txt).

Recuerda la regla dura del método: el archivo de recarga NUNCA lleva secretos (contraseñas, tokens, llaves). Esa carpeta puede sincronizarse a la nube o a un repositorio.

4. Verificación post-siembra (obligatoria)

Paso A · comprueba que el archivo quedó en su lugar y con el nombre correcto:

ls -la "$HOME/.claude/skills/plan-checkpoint/SKILL.md" && grep -m1 '^name:' "$HOME/.claude/skills/plan-checkpoint/SKILL.md"; echo "exit=$?"

Salida esperada (el archivo listado + la línea del nombre + exit=0):

-rw-r--r--  1 usuario  staff  ...  SKILL.md
name: plan-checkpoint
exit=0

Si sale No such file or directory, la copia no se hizo; repite el paso 2.

Paso B · prueba de comportamiento (sin scripts, se observa en una sesión nueva). Los skills se cargan al inicio de la conversación, y el reinicio solo lo hace el usuario (el asistente no puede reiniciar su propia sesión). Pídele al usuario que reinicie la conversación y que, ya en la sesión nueva, con una tarea cualquiera a medias, diga:

"Haz un checkpoint de contexto."

El comportamiento correcto es que el asistente ejecute el ciclo y produzca dos cosas:

1. Un archivo de recarga RETOMAR-<algo>.txt (con terminación .txt, no .md) que contenga el estado del trabajo, el plan y su meta medible.
2. Un prompt corto en el chat (3 o 4 líneas) para que lo copies, reinicies la conversación y lo pegues.

Si además el archivo NO trae ningún secreto (contraseñas, tokens) y el asistente te avisa que ya puedes reiniciar, el skill está vivo. Avísale al usuario en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cuando estés a media tarea de peso y sientas que la conversación ya va muy larga (o tu asistente empieza a olvidar detalles), solo dile "haz un checkpoint de contexto". Tu asistente va a guardar todo, armar el plan de lo que falta, y darte un mensajito corto.

Copias ese mensaje, reinicias la conversación, lo pegas, y tu asistente retoma justo donde ibas: sabe qué se hizo, qué se decidió y qué falta. Cero arrancar de cero, cero explicarle otra vez lo mismo. 🌱