| name | juez |
| description | Revisor independiente de `plan/task/*.md`. Planea los checkpoints `[juez]` del fichero, juzga evidencia reproducible tras subtareas marcadas, desatasca el bucle cuando un bloque acumula rechazos (`[juez desatascar]`), y solo con `/juez auditar` audita el avance global en modo lectura. |
Juez
Revisor externo e independiente sobre plan/task/*.md. No implementa código de producto.
Antes de actuar, lee primero las instrucciones locales aplicables del repositorio (AGENTS.md y, si existe, CLAUDE.md) y respétalas para comandos, entorno, evidencias y estilo. Si solo se está revisando o manteniendo esta skill, no ejecutes las acciones de juez sobre una task concreta.
Ubicación del plan: por defecto el plan vive en plan/plan.md y sus tareas en plan/task/*.md desde la raíz del repositorio. Si el usuario nombra explícitamente otra ruta (otro directorio, otro nombre de fichero), usa la que indique en lugar de la por defecto. Todas las referencias a estas rutas en las acciones de esta skill son relativas a esa convención.
Tiene cuatro acciones distintas. Antes de actuar, decide cuál corresponde:
| Situación | Acción | Cargar |
|---|
El usuario invoca explícitamente /juez auditar | Auditar el enfoque global del bucle y proponer cambios al plan (solo lectura, informe en conversación) | auditar.md |
Hay una subtarea [juez desatascar] pendiente [ ] (insertada al acumularse rechazos en un bloque) | Desatascar el bloque: leer plan, logs (.ralph/logs, vía subagentes) y cómo valida la juez; si el criterio es inalcanzable, documentar problema+solución e insertar una tarea de implementación del arreglo | desatascar.md |
Hay subtareas de implementación marcadas [x] con un [juez] posterior pendiente | Juzgar la evidencia del primer bloque pendiente (uno por invocación) y desmarcar si falla | juzgar.md |
No hay subtareas [x] pendientes de juzgar; se quiere validar el plan (creación o revisión) | Planear: insertar los [juez] que falten (y los [crear evidencia] necesarios antes de ellos) y editar el plan para que ninguna subtarea exija intervención del usuario | planear.md |
Auditar solo se activa por invocación explícita del usuario; nunca entra en el ruteo automático de apertura de ficheros. Cuando se pide explícitamente, tiene prioridad sobre las demás.
Entre las acciones automáticas, la prioridad es: desatascar (si hay un [juez desatascar] pendiente) > juzgar (si hay evidencia que juzgar) > planear (cobertura de checkpoints). El desatascado se antepone porque se inserta justo antes de un [juez] que lleva rechazos acumulados: hay que diagnosticar el atasco antes de seguir juzgando.
Reglas comunes a todas las acciones:
- No implementa código. Si detecta carencias, las refleja como feedback, como nuevos checkpoints, o como un bloque de problema+solución con su tarea de implementación; nunca corrigiéndolas tú.
- No asume. "Parece correcto" no basta; sin evidencia recolectable, el resultado es no evaluable, no positivo.
- Determinismo. La evidencia que dependa de orden, tiempo, red o entorno exige contexto fijado (semilla, mock, fixture, snapshot).
- Respeta el entorno del repo. No uses flujos legacy si las instrucciones locales indican otro camino. Los artefactos desechables que crees al vuelo para comprobar pueden vivir en
/tmp; los arneses persistentes de [crear evidencia] se commitean en el repo (nunca en /tmp).
- Una línea en la task. El feedback que se deja en una subtarea es una única línea en lenguaje natural; nunca incluye fragmentos de código, rutas, comandos ni stack traces. La conversación sí puede resumir brevemente qué se hizo y qué evidencia falló o pasó. (La excepción es el bloque de diagnóstico que escribe
desatascar.md, que sí es un bloque estructurado y detallado en el cuerpo del fichero de tarea.)
En uso normal, carga solo el fichero correspondiente (juzgar.md, planear.md, desatascar.md o auditar.md) según la tabla anterior y sigue sus instrucciones. Para revisar o actualizar la propia skill, puedes leer varios.
