🌱 Empieza aquí · Control de calidad con piso firmado y grader auditable
Esta semilla le enseña a tu asistente un hábito de calidad: antes de darte un entregable de peso como "listo", primero firma contigo un piso de calidad (un número con su razón), califica el trabajo contra rúbricas claras con evidencia citada, y no te lo presenta como cierre si quedó por debajo del piso sin que tú decidas qué hacer. En corto: calidad medible, no un "se ve bien" al aire.
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 control de calidad con piso firmado", "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
control de calidad por tu cuenta.
1. Copia el método donde lo leas siempre
El kernel trae dos archivos:
kernel/control-de-calidad-piso-firmado.md— el método en sí (el aparato de gate: firmar piso → elegir rúbricas → calificar con evidencia → decidir PASA/ITERA/ESCALA → guardrail de cierre).kernel/rubricas.ejemplo.md— una plantilla para definir las rúbricas de calidad reales de esta persona.
Coloca control-de-calidad-piso-firmado.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/control-de-calidad-piso-firmado.md "$HOME/.claude/rules/control-de-calidad-piso-firmado.md"
Los archivos dentro de
~/.claude/rules/se cargan solos al inicio de cada sesión. Copia ahí solo el método. La plantilla de rúbricas 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/control-de-calidad-piso-firmado.md). Si no, coloca el método 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
control-de-calidad-piso-firmado.md: firma un piso de calidad y no presentes nada por
debajo como listo sin decisión explícita."
Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de
control-de-calidad-piso-firmado.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. Aterriza las rúbricas a ESTE sistema (recomendado)
Abre kernel/rubricas.ejemplo.md. Con la persona (o detectándolo tú), define las
dimensiones de calidad que le importan y cómo se ve un 0 y un 10 en cada una. Deja como
mínimo las dos always-on (calidad/QA y ajuste-a-la-audiencia) y agrega las que apliquen
a su tipo de trabajo (accionabilidad, marca, honestidad, lo que sea suyo). Cuando la tabla
esté lista, pega esas rúbricas dentro de la sección "Elegir las rúbricas que aplican"
del método del paso 1, para que el gate apunte a criterios reales. Si la persona no sabe
por dónde empezar, deja las de ejemplo: el método funciona igual.
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 control se aplica de verdad.
a) El archivo quedó colocado (ejemplo Claude Code):
ls -la "$HOME/.claude/rules/control-de-calidad-piso-firmado.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 control se aplica (prueba de comportamiento, en una conversación nueva):
Pídele a la persona que abra una sesión nueva, firme un piso (por ejemplo "pon el piso de
calidad en 9.0 porque es para un cliente") y luego pida un entregable de peso. La
conducta correcta es que tu asistente firme el piso con su razón, califique el resultado
contra las rúbricas citando evidencia por nota, y si el resultado quedó por debajo del
piso te ofrezca la decisión de tres opciones (iterar / diferir documentado / aceptar el
gap con firma) en vez de presentarlo como "listo". Si en cambio te entrega algo bajo el
piso diciendo "quedó cerca, va", el método no se cargó: revisa que el archivo 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 un entregable importante, primero va a firmar contigo un piso de calidad y luego va a medir el trabajo contra él con evidencia, no a ojo. Si algo se queda corto, ya no te lo va a colar como "listo": te va a decir claro "quedó en 8.6 contra el 9.0 que firmaste, la arista floja es esta; ¿la itero, la difiero con plan, o aceptas el gap?". Menos sorpresas, menos "casi bien" disfrazado de terminado.
No tienes que hacer nada especial en el día a día, más que firmar el piso al arrancar algo importante. El resto lo cuida el método. Eso es todo. 🌱