🌱 Empieza aquí · Juez de calidad de producto

¿Te ha pasado que un entregable de producto —una feature nueva, un flujo, una propuesta de valor— se ve terminado y "todos dicen que está listo", pero nadie firmó de verdad que le sirve a tu cliente ideal y que se usa sin fricción? Esta semilla te instala un juez de calidad de producto: no rehace el trabajo, coordina a tu especialista de producto, cruza lo que reporta contra el entregable real, y te entrega un solo veredicto —aprobado, con cambios o escalar— con cada hallazgo citado. Es el filtro final antes de soltar algo.

Para ti (el humano)

Solo tienes que decir una frase. Abre esta carpeta con tu asistente (Claude Code o Cowork) y escríbele:

"Siembra esta semilla 🌱"

¿Otras formas de pedirlo? "instala esta semilla", "activa el juez de calidad de producto", "haz el setup de esto". Te entiende igual. De ahí en adelante tu asistente hace toda la parte técnica; tú no tocas nada. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.

Durante la siembra, tu asistente te va a hacer un par de preguntas fáciles: quién es tu cliente ideal, cuál es tu propuesta de valor y dónde guardas esos documentos, si los tienes. Con eso el juez afina su criterio a lo tuyo. Si todavía no tienes esos documentos, no pasa nada: funciona igual, solo que más general.

Para el asistente que siembra 🤖

Eres el asistente que va a instalar esta semilla. Es un agente (un subagente al que se le delega la misión de dictaminar la calidad de producto de un entregable). No es un hook (una automatización que se dispara sola ante eventos): no hay que registrar nada en settings.json ni dar permisos de ejecución (chmod) — es un archivo de definición en texto, no un script. Sigue estos pasos tal cual.

Los placeholders entre <...> los resuelves tú según la plataforma y el contexto del humano:

<TU-RUTA-DE-AGENTES> → carpeta donde viven las definiciones de agentes del asistente.
- Claude Code (usuario): ~/.claude/agents/ (recomendado; el agente queda disponible en todas las sesiones).
- Por proyecto: .claude/agents/ dentro del proyecto (si el humano solo lo quiere ahí).
- Cowork: la carpeta de configuración equivalente (~/.claude/agents/ si comparte el mismo directorio de config).
- Codex: no instala este juez como subagente delegable (Codex usa otro mecanismo de agentes). Si el humano está en Codex, pega el contenido de kernel/quality-product-judge.md dentro de su AGENTS.md para usar el método a mano, y sáltate la prueba de subagente del Paso 3 (solo aplica la verificación del archivo).

Paso 1 · Copiar la definición del agente y su plantilla

El kernel trae dos archivos:

kernel/quality-product-judge.md — la definición del agente (el juez en sí).
kernel/base-tecnica.ejemplo.md — una plantilla para aterrizar a quién delega y sus fuentes.

Copia ambos a <TU-RUTA-DE-AGENTES>. Crea la carpeta si no existe.

mkdir -p <TU-RUTA-DE-AGENTES>
cp kernel/quality-product-judge.md <TU-RUTA-DE-AGENTES>/quality-product-judge.md
cp kernel/base-tecnica.ejemplo.md <TU-RUTA-DE-AGENTES>/base-tecnica.ejemplo.md

El único agente es quality-product-judge.md (trae su encabezado name:/description:). base-tecnica.ejemplo.md es solo la ficha de contexto que el juez lee para saber a quién delega y dónde viven tus fuentes; no tiene encabezado de agente, así que el asistente la ignora como agente y la usa solo como referencia. Por eso viven juntas.

Paso 2 · Aterrizar la base técnica (un par de preguntas al humano)

Abre base-tecnica.ejemplo.md y, con el humano, llena al menos a quién delega (punto 1) y dónde viven sus fuentes (punto 2). Pregúntale en lenguaje simple: "¿Quién es tu cliente ideal, la persona a la que de verdad le vendes?", "¿Tienes escrita tu propuesta de valor y el recorrido de tu usuario en algún documento?" y "¿Tienes un agente o especialista de producto instalado, o quieres que el juez audite él mismo cuando no haya a quién delegar?".

El juez trae valores por defecto y funciona sin llenar nada: si el humano no tiene un especialista de producto a quien delegar, el juez lo aclara en su reporte y aplica los criterios él mismo en una pasada. No bloquees la siembra por falta de documentos.

Paso 3 · VERIFICACIÓN post-siembra (obligatoria)

Primero confirma que el archivo quedó en su lugar y que su encabezado se lee bien:

ls -la <TU-RUTA-DE-AGENTES>/quality-product-judge.md && head -8 <TU-RUTA-DE-AGENTES>/quality-product-judge.md

Salida esperada — el archivo existe y su encabezado se lee completo así (la línea description es larga; aquí va recortada con ...):

---
name: quality-product-judge
description: "Juez de calidad para entregables de producto ..."
tools: Read, Glob, Grep, Task
model: opus
maxTurns: 20
memory: project
---

Luego haz una prueba funcional real. Desde tu propia conversación, delégale un dictamen chico:

Usa el agente quality-product-judge para dictaminar este entregable de producto: "[pega una feature o una propuesta de valor del humano]".

Qué esperar: que ANTES de opinar mencione que va a leer el contexto de producto y, si hay a quién delegar, que va a delegar la auditoría; que entregue un veredicto (aprobado / requiere cambios / escalar) con el desglose por dimensión (encaje con el cliente ideal, propuesta de valor, usabilidad, alineación con el embudo) y evidencia citada. Si en vez de eso se pone a rediseñar la feature o firma "está bien" sin desglose, el agente no se instaló bien: confirma que copiaste el archivo a <TU-RUTA-DE-AGENTES> correcto (usuario vs. proyecto) y que el encabezado del Paso 3 se lee completo.

Cuando las dos verificaciones den lo esperado, la siembra está completa. Reporta al humano en una línea, sin tecnicismos.

¿Cómo sé que funcionó? (para el humano)

Fácil: la próxima vez que tengas un entregable de producto listo para soltar, pídele a tu asistente que "lo dictamine con el juez de calidad de producto". En un rato te devuelve un veredicto claro: pasa, pasa con cambios o mejor escálalo, con el porqué en cada dimensión y la lista de arreglos priorizada si algo no cumple. A partir de ahí tienes un filtro que hace la pregunta incómoda por ti —¿esto de verdad le sirve a mi cliente ideal y se usa sin fricción?— antes de que salga a la calle. 🌱

Juez de calidad de producto (delega y dictamina)