agentleFS
dbareagimenodbareagimeno/enu/.claude/skills/juicio/SKILL.md

juicio

Skill2 starsChanged 4 months agoApache-2.0View on GitHub

Revisión clean-room de un diff por un panel de jueces no contaminados (espec, tests, concurrencia) con verificación adversarial de cada hallazgo. Úsala antes de cerrar una sesión de implementación (siempre ANTES de escribir bitácora/puntero) o para auditar cualquier cambio sensible. La política de coste decide el tamaño del panel.

The file

Files
SKILL.md

Juicio clean-room

Los jueces valen porque no comparten tus supuestos. Todo este protocolo existe para que sigan sin compartirlos: arrancan sin contexto de esta conversación, reciben solo artefactos públicos (diff + espec) y su garantía técnica es el frontmatter tools: sin Bash/Edit/Write (sin git log, sin mensajes de commit, sin el razonamiento histórico del autor). No relajes ninguna de las dos cosas.

Regla de secuencia

El juicio se ejecuta antes de escribir el worklog de la sesión y mover el puntero ▶: el worklog contiene la racionalización del autor y, si existiera ya, contaminaría a cualquier juez que lea implementacion.md.

Política de coste (cuándo montar qué)

El diff...Panel
Es de una sesión 🔒, o toca docs/contracts/api.md/contratos, o toca scheduler/cancelación/eventos/workersCompleto: juez-espec + juez-tests + juez-concurrencia (en paralelo)
Implementa lógica propia fuera de lo anteriorjuez-espec + juez-tests
Es un wrapper fino sobre stdlib/libreríaSolo juez-espec
Es glue de paso, docs o render visualNinguno (basta el DoD normal)

Esta tabla es para no saltarse el juicio "porque es caro" justo cuando importa. Para el panel completo puedes delegar la orquestación en el workflow guardado revision-limpia (.claude/workflows/revision-limpia.js), que implementa exactamente este protocolo de forma determinista.

Plantilla del prompt de juez (literal — prohibido desviarse)

Construye el prompt de CADA juez exactamente así, sin añadir nada más:

Sesión: S## — <enunciado de la sesión copiado verbatim del plan, o "cambio
fuera de plan: <una frase factual de QUÉ cambia, no por qué>">
Espec que gobierna este diff: <doc> §N, <doc> §M <(+ G## que la sesión cita)>

Diff a juzgar (verbatim):
<salida de `git diff` (o `git diff --staged`) completa, sin recortar>

Emite tu veredicto con tu formato de salida.

Prohibido incluir: el razonamiento del autor, "decidimos X porque...", alternativas discutidas, fragmentos de esta conversación, resultados de otros jueces, o el contenido del worklog. Si el orquestador puede improvisar el prompt, filtrará su propia justificación sin querer — por eso la plantilla es literal.

Pasos

  1. Determina el panel con la política de coste. Prepara el diff (git diff del alcance de la sesión) y la lista de §N que la gobiernan (columna "Espec" de la S## en el plan).
  2. Lanza los jueces del panel en paralelo, cada uno con la plantilla. (Excepción de entrada: a juez-tests puedes añadirle, tras el diff, el informe de mutantes LIVED de /mutacion — es evidencia mecánica, no razonamiento.)
  3. Recoge los veredictos. Por cada hallazgo (de cualquier juez), lanza un verificador fresco con SOLO el hallazgo (título, cita de espec, línea de diff) + el diff — nunca el razonamiento del juez ni los demás hallazgos. En paralelo si hay varios.
  4. Sintetiza:
    • REAL → se arregla antes del DoD. Si el arreglo revela que la espec es insuficiente → /hallazgo (el código nunca corrige la espec por la vía de hecho).
    • FALSO POSITIVO → se descarta, anotando la evidencia del verificador.
    • NO CONCLUYENTE → decide tú con el código delante, y si sigue en duda, escálalo al usuario. No lo entierres.
  5. Reporta al usuario el resultado: hallazgos reales arreglados, falsos positivos descartados (con su evidencia) y veredicto final del panel. Después continúa el cierre normal de la sesión (worklog, puntero, commit).

Cuándo NO sirve este juicio

Para decisiones de diseño contenciosas (opciones de un G##, una propuesta de ADR) el instrumento no es este panel sino juez-filosofia — y si la decisión es de verdad reñida, varios verificador con lentes opuestas sobre la opción favorita. El juicio clean-room juzga código contra espec congelada.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.