🌱 Empieza aquí · Plan a prueba de errores

Esta semilla le enseña a tu asistente a armar un plan a prueba de errores antes de meterse a cualquier trabajo de peso. En vez de arrancar a ciegas, primero se alinea contigo, define un objetivo que se pueda comprobar (no solo decir "ya quedó"), acuerda una vara de calidad, y parte el trabajo en pasos que no se pueden malinterpretar, con una revisión tangible al cerrar cada etapa. Menos retrabajo, menos sorpresas.

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 plan a prueba de errores", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es una habilidad (skill: un conjunto de instrucciones que el asistente carga cuando la tarea lo amerita). No es un programa ejecutable ni 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 archivo de la habilidad donde tu plataforma lo descubra, para que puedas invocarlo cuando toque planear algo de peso.

1. Copia la habilidad donde tu plataforma la descubra

El kernel trae un solo archivo: kernel/SKILL.md (el método completo, con su encabezado que le dice a tu plataforma cuándo activarlo).

Claude Code (macOS / Linux):

mkdir -p "$HOME/.claude/skills/plan-a-prueba-de-errores"
cp kernel/SKILL.md "$HOME/.claude/skills/plan-a-prueba-de-errores/SKILL.md"

Claude Code (Windows · PowerShell):

New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills\plan-a-prueba-de-errores" | Out-Null
Copy-Item "kernel\SKILL.md" "$HOME\.claude\skills\plan-a-prueba-de-errores\SKILL.md"

Las habilidades dentro de ~/.claude/skills/<nombre>/SKILL.md se descubren solas: el asistente lee su encabezado description y la activa cuando la tarea encaja.

Cowork: usa la misma convención de carpeta de habilidades si tu proyecto la soporta (.claude/skills/plan-a-prueba-de-errores/SKILL.md). Si no, coloca SKILL.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: "Cuando arme un plan de peso, aplica el método de plan-a-prueba-de-errores/SKILL.md."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de kernel/SKILL.md (sin su encabezado de dos rayas) dentro de AGENTS.md, o guárdalo aparte en el proyecto y agrégale un puntero, para que el método se cargue con el resto de tus instrucciones.

2. Adáptalo a las capacidades de esta plataforma (recomendado)

El método está escrito para ser portable: en varios pasos dice "si tu plataforma tiene una habilidad o comando nativo para esto, úsalo". Antes de la primera corrida, revisa qué hay disponible en este sistema y anótalo dentro del SKILL.md que copiaste:

• ¿Existe un comando nativo de objetivo/verificación que revise una condición y no devuelva el control hasta cumplirla? → úsalo en el candado 2.
• ¿Existe una habilidad de preguntas de alineación o de calificación de entregables? → úsala en los candados 1 y 5.

Si no hay nada de eso, no pasa nada: el método describe cada paso para hacerlo a mano y funciona igual.

3. Verificación post-siembra (obligatoria)

Como es una habilidad (texto), la verificación tiene dos partes: que el archivo quedó en su lugar, y que la habilidad se activa de verdad.

a) El archivo quedó colocado (ejemplo Claude Code, macOS / Linux):

ls -la "$HOME/.claude/skills/plan-a-prueba-de-errores/SKILL.md"; echo "exit=$?"

En Windows (PowerShell):

Get-Item "$HOME\.claude\skills\plan-a-prueba-de-errores\SKILL.md"; "exit=$LASTEXITCODE"

Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. Si sale No such file or directory (o el equivalente en Windows), la copia no se hizo; repite el paso 1.

b) La habilidad se activa (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva y diga algo como "arma un plan a prueba de errores para [alguna tarea de peso suya]". La conducta correcta es que el asistente no se lance a ejecutar de inmediato, sino que primero: (1) te haga rondas de preguntas para alinearse, (2) proponga un objetivo que se pueda comprobar, (3) acuerde contigo una vara de calidad, y (4) parta el trabajo en fases con pasos numerados y una revisión al cerrar cada una. Si en vez de eso arranca a trabajar sin preguntar ni definir objetivo, la habilidad no se cargó: revisa que SKILL.md esté en la carpeta de habilidades (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 algo grande o irreversible, no va a salir corriendo a "hacerlo y ya". Primero se va a alinear contigo con preguntas, va a poner un objetivo que se pueda comprobar (no un "ya quedó" de palabra), va a acordar qué tan alto ponemos la vara, y va a partir el trabajo en pasos claros con una revisión real al cerrar cada etapa.

No tienes que hacer nada especial en el día a día. Solo vas a notar dos cosas: menos sorpresas a medio camino, y menos veces en que algo se dio por terminado sin estar de verdad terminado. Eso es todo. 🌱