🌱 Empieza aquí · Umbral de Calidad de la Sesión
¿Cuántas veces tu asistente te cerró un trabajo diciendo "quedó listo" cuando en realidad era un "casi"? Esta semilla le da una herramienta para que eso no pase: tú le firmas una vara mínima de calidad para la sesión (por ejemplo, "esta entrega no baja de 9.5") y él la guarda. A partir de ahí, antes de presentarte algo como "listo para firma", se auto-evalúa con honestidad; si no llegó a la vara y tú no aprobaste el hueco, se frena y le sigue hasta alcanzarla, o te para y te pide permiso. Se acabó el "casi" disfrazado de "listo".
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 técnico 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", "activa el umbral de calidad", "haz el setup de esto". Te entiende igual.
Para el asistente que siembra 🤖
Este componente es una skill (habilidad): un método que el asistente carga y aplica para
fijar y persistir un umbral de calidad. 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 propio. Se "siembra" colocando el archivo donde tu plataforma cargue habilidades.
1. Copia la habilidad a su lugar
El kernel trae un archivo:
kernel/SKILL.md— el método en sí (fijar la vara, persistirla, auto-evaluarse antes del cierre y sostener la disciplina de no aceptar el hueco).
Claude Code (macOS / Linux / Windows con Git Bash):
mkdir -p "$HOME/.claude/skills/set-eval-gate"
cp kernel/SKILL.md "$HOME/.claude/skills/set-eval-gate/SKILL.md"
La carpeta dentro de
~/.claude/skills/se carga como habilidad disponible. El asistente la invoca cuando la persona dice "fija el eval gate en N", "esta entrega no baja de N", o firma un estándar de calidad para la sesión.
Windows (PowerShell nativo):
New-Item -ItemType Directory -Force "$HOME\.claude\skills\set-eval-gate" | Out-Null
Copy-Item kernel\SKILL.md "$HOME\.claude\skills\set-eval-gate\SKILL.md"
Cowork: coloca la carpeta set-eval-gate/ (con su SKILL.md) en la ruta de habilidades
de tu proyecto si la soporta. Si no, guarda SKILL.md dentro del proyecto y agrega en el
archivo de instrucciones (CLAUDE.md) una línea que apunte a él: "Para fijar una vara de
calidad de la sesión, aplica el método de set-eval-gate/SKILL.md: persiste el umbral,
auto-evalúate antes de cerrar y no aceptes el hueco sin permiso."
2. Empareja con el candado de cierre (recomendado)
Esta skill fija la vara; el freno automático lo pone un hook de cierre que lee el estado y bloquea si el trabajo se quedó corto. Ese hook viaja como semilla aparte, "Candado de Umbral de Calidad". Si el usuario la tiene, siémbrala también: ambas usan los mismos nombres de archivo y el mismo directorio de estado, así que se emparejan solas.
Sin ese candado, la skill sigue sirviendo: el asistente persiste la vara y sostiene él mismo la disciplina (se auto-evalúa y se frena). Con el candado, el freno es automático a nivel del sistema.
3. Verificación post-siembra (obligatoria)
Como es una habilidad (método en texto), la verificación tiene dos partes: que el archivo quedó colocado, y que el método se aplica de verdad.
a) El archivo quedó colocado (ejemplo Claude Code):
ls -la "$HOME/.claude/skills/set-eval-gate/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 método 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 "fija el eval gate en 9.5
porque esta entrega es para un cliente". La conducta correcta es que escribas el archivo
de estado eval-gate-active.json en el directorio de estado ($CLAUDE_PROJECT_DIR, o
$HOME/.claude si no está) con el umbral y su razón, y confirmes en lenguaje de persona
que la vara quedó fijada y qué implica. Puedes comprobar el archivo así:
DIR="${CLAUDE_PROJECT_DIR:-$HOME/.claude}"
cat "$DIR/eval-gate-active.json"; echo "exit=$?"
Salida esperada: un JSON con "threshold": 9.5, "active_until": "session_end" y la
razón que dio la persona, y exit=0. Si el archivo no existe, el método no se cargó: revisa
que SKILL.md esté en la carpeta de habilidades.
Cuando ambas partes pasen, avísale a la persona en una línea qué gana con esto.
✅ ¿Cómo sé que funcionó?
A partir de ahora puedes decirle a tu asistente algo como "para esta entrega, la vara es 9.5, porque es para un cliente" y él la guarda. Cuando esté por cerrarte el trabajo, se califica a sí mismo; si no llegó a la vara, le sigue hasta pasarla —o te para y te dice "me quedé en 9.3 por esto, ¿lo aceptas o le sigo?"—. Y cuando no fijas ninguna vara, no aparece nada: cero fricción en el día a día. Eso es todo. 🌱
