🌱 Empieza aquí · Calificar un entregable contra tu rúbrica

Esta semilla le enseña a tu asistente a ser un juez auditable de tu trabajo. En vez de decirte "se ve bien" a ojo, toma un entregable (un post, un correo, una landing, una propuesta) y lo califica dimensión por dimensión contra una rúbrica clara, citando la frase exacta que justifica cada nota. Al final te da un veredicto de tres salidas: aprobado, a iterar (arreglar lo que falló) o a escalar (una decisión que solo tú puedes tomar). Calidad medible, no un juicio del momento.

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 juez de entregables", "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 el juicio por tu cuenta cuando toque calificar un entregable.

1. Copia el método donde lo leas siempre

El kernel trae dos archivos:

• kernel/juez-de-entregable.md — el método en sí (cómo calificar y decidir).
• kernel/rubricas.ejemplo.md — una plantilla para definir las dimensiones contra las que vas a juzgar (qué mide cada una, cuáles son "always-on").

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

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo juez-de-entregable.md. La plantilla de rúbricas NO va en esa carpeta (no es una regla permanente, es una guía que usas en el paso 2).

Cowork: usa la misma carpeta de reglas si tu proyecto la soporta (.claude/rules/juez-de-entregable.md). Si no, coloca juez-de-entregable.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: "Antes de dar por listo un entregable de peso, aplica el método de juez-de-entregable.md: califícalo contra su rúbrica con evidencia citada y decide aprobado/iterar/escalar."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de juez-de-entregable.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. Define las rúbricas de ESTE sistema (recomendado)

Abre kernel/rubricas.ejemplo.md. Con la persona (o detectándolo tú), decide qué dimensiones importan para su tipo de trabajo, cuáles son "always-on" (siempre entran, como calidad/QA y ajuste-a-la-audiencia) y cuáles entran solo según el tipo de entregable. Empieza con el set de ejemplo que ya trae la guía y bórrale lo que no aplique.

Cuando la rúbrica esté lista, guárdala donde el asistente la pueda leer al calificar (por ejemplo dentro del proyecto, o junto a juez-de-entregable.md). Si la persona no tiene claras sus dimensiones, no pasa nada: el set de ejemplo funciona tal cual como punto de partida.

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 el juicio se aplica de verdad.

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

ls -la "$HOME/.claude/rules/juez-de-entregable.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 juicio se aplica (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva, le dé al asistente un entregable de ejemplo (un correo corto, un párrafo de landing) y le pida: "califica esto antes de darlo por listo". La conducta correcta es que el asistente elija las dimensiones que aplican, ponga una nota a cada una citando la frase que la justifica, calcule el compuesto y diga aprobado / a iterar / a escalar — no un vago "se ve bien". Si en vez de eso solo opina sin citar evidencia, el método no se cargó: revisa que juez-de-entregable.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 esté por darte algo importante como "listo", primero lo va a poner en la mesa de juicio: le pone nota a cada dimensión, te enseña la frase exacta que sostiene cada nota, y te dice con claridad si pasa, qué le falta, o cuándo la decisión es tuya. Se acabaron los "se ve bien" que después resultan no verse tan bien.

No tienes que hacer nada especial en el día a día. Solo vas a notar que lo que te llega como "listo" de verdad aguanta una segunda mirada, y que cuando algo no pasa, ya viene con el diagnóstico de qué arreglar. Eso es todo. 🌱