🌱 Empieza aquí · Aprender de cada error

Esta semilla le enseña a tu asistente un hábito de autocorrección: cada vez que se equivoca (o tú lo corriges), en lugar de solo disculparse, diagnostica por qué pasó, lo anota como un aprendizaje generalizable, y propone un arreglo de fondo para que no se repita. Con el tiempo, tu asistente comete el mismo error cada vez menos.

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 hábito de aprender de los errores", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un skill (una habilidad que el asistente carga y activa cuando detecta el contexto correcto). 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 la habilidad en la carpeta de skills que tu plataforma carga sola.

1. Copia la habilidad a tu carpeta de skills

El kernel trae tres archivos:

kernel/SKILL.md — la habilidad en sí (el protocolo de 7 pasos).
kernel/aprendizaje.ejemplo.md — plantilla para escribir cada aprendizaje como nota atómica.
kernel/tabla-racionalizacion.ejemplo.md — plantilla para el registro de excusas → antídoto.

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

mkdir -p "$HOME/.claude/skills/self-improvement"
cp kernel/SKILL.md "$HOME/.claude/skills/self-improvement/SKILL.md"
cp kernel/aprendizaje.ejemplo.md kernel/tabla-racionalizacion.ejemplo.md "$HOME/.claude/skills/self-improvement/"

Claude Code (Windows PowerShell):

New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills\self-improvement" | Out-Null
Copy-Item kernel\SKILL.md "$HOME\.claude\skills\self-improvement\SKILL.md"
Copy-Item kernel\aprendizaje.ejemplo.md,kernel\tabla-racionalizacion.ejemplo.md "$HOME\.claude\skills\self-improvement\"

Cowork: usa la misma carpeta de skills si tu proyecto la soporta (.claude/skills/self-improvement/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: "Aplica el método de SKILL.md: aprende de cada error."

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

2. Aterriza dónde viven los aprendizajes (recomendado)

Abre el SKILL.md que copiaste en el paso 1 (el que quedó en tu carpeta de skills, no el de la semilla) y, junto a él, aprendizaje.ejemplo.md. Con la persona (o detectándolo tú), reemplaza los placeholders por las rutas reales de este sistema:

<TU-CARPETA-DE-APRENDIZAJES> → la carpeta donde vivirá cada aprendizaje como archivo atómico.
<TU-INDICE-DE-APRENDIZAJES> → el archivo índice con una línea por aprendizaje.
<TU-CAPA-COMPARTIDA> → solo si la persona trabaja en varios proyectos; la capa transversal para aprendizajes que aplican a todo. Si no aplica, quítala.
<TU-ARCHIVO-DE-INSTRUCCIONES> → el archivo maestro (CLAUDE.md en Claude Code / Cowork, AGENTS.md en Codex).

Si la persona todavía no tiene una carpeta de aprendizajes, créala la primera vez y déjala como el lugar canónico. Si no sabe dónde poner cada cosa, no pasa nada: deja los placeholders como categorías genéricas y el método sigue funcionando.

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 el hábito se activa de verdad.

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

ls -la "$HOME/.claude/skills/self-improvement/SKILL.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 hábito se activa (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva y le diga al asistente algo como: "Acabo de corregirte: diste por hecho un dato sin verificarlo en mis archivos. Aplica tu protocolo de autocorrección.". La conducta correcta es que el asistente (1) reconozca el error sin excusas, (2) diagnostique la causa raíz (ejecución, sistémica o patrón), (3) capture verbatim la excusa que lo llevó al error, (4) proponga anotarlo como un aprendizaje con título imperativo, y (5) proponga un arreglo de fondo pidiéndote aprobación antes de tocar archivos. Si en vez de eso solo dice "perdón, ya no lo hago", la habilidad no se cargó: revisa que SKILL.md esté en la carpeta de skills (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 se equivoque, no se va a quedar en el "perdón". Va a diagnosticar por qué pasó, lo va a anotar como un aprendizaje que aplica a más casos, y te va a proponer un ajuste para que no se repita. Vas a notar que el mismo error deja de volver: cada tropiezo lo hace un poco mejor, en vez de tropezar con la misma piedra.

No tienes que hacer nada especial en el día a día. Solo vas a ver que aprende de verdad. 🌱

Aprender de cada error