🌱 Empieza aquí · Verificación con evidencia antes de declarar listo

Esta semilla le enseña a tu asistente una regla dura: antes de decirte que algo está "listo", "hecho" o "funcionando", primero lo comprueba y te trae la prueba pegada. Corre el comando y te enseña lo que de verdad salió, confirma que el archivo existe, y separa lo que probó de lo que solo supone. Menos sorpresas de "creí que estaba y no estaba".

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 la regla de comprobar antes de decir listo", "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 la regla por tu cuenta.

1. Copia el método donde lo leas siempre

El kernel trae dos archivos:

• kernel/verify-before-ship.md — el método en sí (la regla que vas a seguir).
• kernel/checklist-de-evidencia.ejemplo.md — una plantilla para pre-declarar, por cada entregable, qué prueba respalda cada afirmación de "hecho".

Coloca verify-before-ship.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/verify-before-ship.md "$HOME/.claude/rules/verify-before-ship.md"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo verify-before-ship.md. La plantilla de checklist NO va en esa carpeta (no es una regla permanente, es una guía que usas al arrancar cada entregable).

Windows (PowerShell, si no usas Git Bash):

New-Item -ItemType Directory -Force -Path "$HOME\.claude\rules" | Out-Null
Copy-Item "kernel\verify-before-ship.md" "$HOME\.claude\rules\verify-before-ship.md"

Cowork: usa la misma carpeta de reglas si tu proyecto la soporta (.claude/rules/verify-before-ship.md). Si no, coloca verify-before-ship.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 método de verify-before-ship.md: no declarar nada listo sin evidencia citable."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de verify-before-ship.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. 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 la regla se aplica de verdad.

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

ls -la "$HOME/.claude/rules/verify-before-ship.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) La regla se aplica (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva y te encargue una tarea pequeña y comprobable, por ejemplo: "crea un archivo con estas tres líneas y dime cuando esté". La conducta correcta es que, antes de decir "listo", corras la comprobación y pegues la prueba ("confirmé que el archivo existe, aquí está su contenido"), en vez de solo afirmar "ya quedó". Si en cambio declaras "listo" sin ninguna evidencia a la vista, el método no se cargó: revisa que verify-before-ship.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 que algo está "listo", va a venir con la prueba pegada: la salida real del comando, la confirmación de que el archivo existe, la captura de que la pantalla funciona. Y cuando no pueda comprobar algo (por ejemplo, una pantalla detrás de un login sin usuario de prueba), en vez de dártelo por bueno a ciegas te va a avisar y ofrecerte cómo verificarlo.

No tienes que hacer nada especial en el día a día. Solo vas a notar que confías más en sus "ya quedó", porque cada uno llega demostrado. Eso es todo. 🌱