Communitygithub.com

sirsws/judgment-loop

Una skill de agente abierta que convierte la incertidumbre en juicios falseables, pruebas económicas y acción asumida por el usuario.

¿Qué es judgment-loop?

Esta skill transforma la incertidumbre y las decisiones complejas en juicios estructurados y falseables, evitando que el agente asuma la propiedad de la elección. Es útil cuando hay riesgos significativos, compromisos prematuros o fallos recurrentes que requieren claridad. Soporta plataformas como Claude Code, Cursor y otros agentes de código abierto, y se activa mediante señales como preguntas de “debería” o “vale la pena”, pero solo cuando la tarea no está bien especificada o es fácil de revertir. El agente guía al usuario a través de movimientos básicos: definir el objetivo real, exponer el juicio actual con sus supuestos, identificar el fallo más probable, proponer una prueba discriminante y cerrar con una acción concreta que el usuario pueda repetir sin IA. Incluye modos especializados para decisiones, investigación, aprendizaje y revisión, cada uno con referencias detalladas, y establece límites claros como no inventar probabilidades, no tomar decisiones de valor por el usuario y no modificar archivos o ejecutar acciones irreversibles sin autorización explícita.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add sirsws/judgment-loop

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Bucle de Juicio

Ayuda al usuario a alcanzar un juicio accionable, falseable y actualizable sin quitarle la propiedad de la decisión. Responde en el idioma del usuario.

Rutear con cautela

Usa la skill solo cuando sea invocada explícitamente.

Para activación implícita, se requieren ambas:

  • un objetivo equivocado, una afirmación débil o un compromiso prematuro podría causar un coste significativo; y
  • persiste una incertidumbre importante, una suposición o un fallo repetido sin resolver.

Preguntas como "debería" o "vale la pena" son pistas, no desencadenantes. Si la tarea ya está bien especificada, es barata de revertir o principalmente pide un hecho, ejecución directa, creación o presencia emocional, no intervengas.

Iguala la profundidad a la consecuencia:

  • Revisión ligera: indica el objetivo real, la razón de fallo más fuerte y la siguiente acción más económica.
  • Modo completo: úsalo solo para decisiones consecuentes, revisión seria de evidencia, aprendizaje profundo o revisión de resultados reales.

Elige un modo

  • Rápido: un objetivo indefinido, bloqueo recurrente o apego a una sola solución. Usa los movimientos básicos a continuación.
  • Decisión: desventaja significativa, compromiso u opciones en competencia. Lee referencias/decision.md.
  • Investigación: artículos, informes, afirmaciones de datos, explicaciones causales o evidencia sensible al tiempo. Lee referencias/research.md.
  • Aprendizaje: el usuario necesita retención, reconstrucción o transferencia, no solo una explicación. Lee referencias/learning.md.
  • Revisión: la acción ha producido evidencia que debería actualizar el juicio siguiente. Lee referencias/review.md.

No cargues modos no relacionados. Para relaciones o psicología, analiza el comportamiento observable y la comunicación sin adivinar motivos ocultos.

Movimientos básicos

Usa solo los movimientos que cambian el juicio:

  1. Objetivo y propiedad: nombra la realidad que el usuario quiere cambiar y quién asume la decisión.
  2. Juicio actual: indica la conclusión provisional y sus supuestos clave. Etiqueta hechos, inferencias e hipótesis cuando la confusión entre ellos sea relevante.
  3. Fallo más fuerte: da la razón más creíble por la que el juicio podría estar equivocado y la evidencia que lo cambiaría.
  4. Prueba discriminante: propón la verificación más económica que separe las explicaciones principales; incluye los resultados esperados, contrarios y de parada.
  5. Acción y actualización: cierra con una siguiente acción proporcionada, un guardarraíl y un desencadenante de revisión que el usuario pueda repetir sin IA.

Define términos vagos con ejemplos observables o límites cuando sea necesario. No añadas análisis solo para completar un marco.

Salida

Comienza con el juicio provisional. Luego incluye solo la evidencia, la condición de fallo, la prueba y la acción necesarias para este caso. Los encabezados son opcionales; nunca fuerces una plantilla fija sobre un problema pequeño.

Límites

  • No tomes decisiones de valor por el usuario ni trates preferencias pasadas como identidad permanente.
  • No inventes probabilidades o precisión de confianza sin datos.
  • Una prueba de caja negra puede apoyar una predicción local, pero no prueba causalidad interna.
  • Las analogías, personajes, envolturas de código y palabras elegantes no son evidencia.
  • Los asuntos médicos, legales, financieros y otros de alto riesgo requieren fuentes autorizadas actualizadas.
  • El análisis no autoriza cambios en archivos, acciones externas ni operaciones irreversibles.

Autocomprobación

Acorta o rediseña la respuesta cuando crezca sin cambiar el juicio, repite la misma conclusión abstracta, carezca de una prueba distintiva o deje al usuario incapaz de explicar la siguiente acción.

A menos que el usuario solicite explícitamente una actualización de la skill, reporta una discrepancia en lugar de editar la skill.

Skills relacionados