🌱 Empieza aquí · Fábrica de capacidades (skills, agents y hooks)

¿Alguna vez le pediste a tu asistente "hazme un skill para X" y terminó construyendo algo que ya tenías, o algo que se veía bien pero nunca se activó cuando lo necesitabas? Esta semilla arregla justo eso.

Le enseña a tu asistente un método disciplinado para construir o mejorar sus propias capacidades. En vez de teclear a lo loco, primero investiga cómo se hace hoy y revisa lo que ya tiene (para no reinventar), luego lo escribe con el patrón correcto, lo prueba de verdad con un caso real y un caso trampa, y lo registra para poder encontrarlo después. Con dos candados: lo delicado espera tu firma, y nada se declara "listo" sin verse funcionar.

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 (skill, hook, agent); ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon el método de fábrica de capacidades", "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 disciplina por tu cuenta cada vez que te pidan construir o modificar una capacidad.

1. Copia el método donde lo leas siempre

El kernel trae dos archivos:

• kernel/fabrica-de-capacidades.md — el método en sí (el pipeline de 4 fases + los 2 candados).
• kernel/registro-de-capacidades.ejemplo.md — una plantilla del "índice honesto" para anotar las capacidades que ya existen (se usa en el paso 2).

Coloca fabrica-de-capacidades.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/fabrica-de-capacidades.md "$HOME/.claude/rules/fabrica-de-capacidades.md"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo fabrica-de-capacidades.md. La plantilla del registro 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/fabrica-de-capacidades.md). Si no, coloca el archivo dentro del proyecto y agrega una línea que apunte a él en el archivo de instrucciones (el CLAUDE.md), por ejemplo: "Antes de construir o modificar cualquier capacidad, aplica el método de fabrica-de-capacidades.md."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de fabrica-de-capacidades.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. Nota: en Codex algunos tipos (agents con nombre, hooks) no existen igual que en Claude Code; ahí aplica el método a las capacidades que la plataforma sí soporta.

2. Arranca el registro de capacidades (recomendado)

Abre kernel/registro-de-capacidades.ejemplo.md. Con la persona (o detectándolo tú), haz un inventario rápido de las capacidades que ya tiene su asistente y llena una fila por cada una: nombre, tipo, qué hace, cuándo dispara, dónde vive, si es sensible. Guarda esa tabla en un lugar fijo del sistema (por ejemplo, junto a la memoria del asistente) y apúntale al método: cada vez que nazca o cambie una capacidad (fase 4), se anota aquí.

Ese registro es lo que le permite al método reusar en vez de reinventar en la fase 1. Si la persona no tiene claro qué capacidades ya existen, no pasa nada: empieza con las que detectes y ve creciendo el registro conforme construyas.

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 la disciplina se aplica de verdad.

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

ls -la "$HOME/.claude/rules/fabrica-de-capacidades.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 disciplina se aplica (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva y te diga algo como "hazme un skill para [alguna tarea]". La conducta correcta es que primero investigues y revises si ya existe algo parecido, propongas un plan (reusar/extender/construir), y solo entonces escribas — y que al final lo pruebes con un caso real antes de decir "listo". Si en vez de eso tecleas un archivo de golpe y lo declaras terminado sin probarlo, el método no se cargó: revisa que fabrica-de-capacidades.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 le pidas a tu asistente construir o mejorar una capacidad, ya no va a teclear a ciegas. Primero va a investigar cómo se hace hoy y a revisar si ya tiene algo parecido (para no reinventar), te va a proponer un plan antes de escribir, y sobre todo va a probar lo que construyó con un caso real antes de dártelo por bueno.

Vas a notar dos cosas: construye menos basura (mucho lo resuelve reusando lo que ya tenía) y lo que sí construye funciona desde el primer intento. Y lo delicado —un hook que bloquea, un cambio de comportamiento— nunca se prende solo: espera tu firma. Eso es todo. 🌱