Communitygithub.com

Renn-Labs/Looptimal

Looptimal: convierte un objetivo en un resultado ENTREGADO y VERIFICADO: un conjunto de pruebas sellado, el bucle correcto, una simulación de guerra superada, ejecución por expertos en el dominio (creador != verificador) y un verificador separado. Incluye el asistente de diseño de bucles (antes LoopPrint).

¿Qué es Looptimal?

Looptimal es un orquestador de resultados para agentes de IA que transforma un objetivo en un resultado verificado, garantizando que "terminado" se pruebe contra el estado real del sistema, no solo por la declaración del agente que realizó el trabajo. Su pipeline de 8 etapas (Enmarcar, Analizar, Diseñar-bucle/Rutar, Planificar, Simular, Ejecutar, Verificar-resultado, Persistir) sella los criterios de aceptación, exige un verificador externo separado del creador y aplica compuertas de verificación humana antes de ejecutar acciones irreversibles (despliegues, envíos, pagos). Soporta bucles reutilizables, misiones/ejecuciones de objetivos de un solo paso y un modo rápido de diseño solo para generar planos de bucle. Es particularmente útil para objetivos no triviales, trabajo multidisciplinario y patrones recurrentes. Su diseño está desacoplado del marco de trabajo, con resolución de enlaces desde perfiles YAML o un script de detección, y se integra con plataformas de agentes como Claude Code, Cursor y Codex.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add Renn-Labs/Looptimal

Preguntar en tu IA favorita

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

Documentación

Looptimal — orquestador de resultados

Convierte un objetivo en un resultado verificado y entregado: sella los criterios de aceptación, selecciona o rechaza el bucle correcto, realiza una simulación de guerra del plan, ejecuta con expertos en el dominio y condiciona la finalización a un verificador separado que vuelve a ejecutar el conjunto sellado contra el estado real, nunca en un VERDE autoinformado.

El asistente de diseño de bucles (antes LoopPrint independiente) está integrado como Etapa 2: Diseño-bucle. También se ejecuta como una ruta rápida de diseño cuando solo se desea un plano de bucle sin orquestación de resultados.

Cuándo usar

  • "looptimal", "/looptimal", "ejecutar un bucle de resultado", "orquestar este objetivo hasta completarlo", "planificar y enviar este objetivo".
  • Un objetivo no trivial donde "terminado" debe probarse contra el estado real, no ser afirmado por el agente que realizó el trabajo.
  • Trabajo multidisciplinario que necesita un Manifiesto de Capacidades, un plan consensuado y creador ≠ verificador a la altitud del resultado.
  • Patrones recurrentes, supervisados, de trinquete o de orquestación — después de que el Diseño-bucle confirme que esto es realmente un bucle.
  • Desea que Simular realice una simulación de guerra del plan antes de cualquier ejecución autónoma.
  • Un objetivo único y no trivial que desea entregar una vez y probar contra el estado real. Si necesita iteración limitada, enrutarlo como misión/ejecución de objetivo; si un solo pase cuidadoso es suficiente, usar el modo de un solo paso (ver la bifurcación de modo a continuación).

Cuándo usar la ruta rápida de diseño

  • "diseñar un bucle", "construir un bucle", "nuevo bucle", "asistente de bucles" o una tarea recurrente vaga para automatizar.
  • Solo desea un plano de bucle (especificaciones + artefactos), sin orquestación de resultados.
  • Salta directamente a la Etapa 2 (Compuerta de Decisión → asistente → generación de artefactos) y se detiene.

Cuándo NO usar

  • Una respuesta trivial de una sola vez, una edición rápida o una pregunta conversacional → simplemente hacerlo bien una vez, sin necesidad de herramienta. (Un objetivo sustancial de una sola vez que aún desea probar — no trivial, simplemente no recurrente — se enruta a misión/ejecución de objetivo o un solo paso a continuación, no una razón para saltarse Looptimal por completo).
  • Análisis sin obligación de entrega → responder directamente o usar esat.
  • Acciones irreversibles y con mucho juicio sin un humano dispuesto a mantener la compuerta GO → recomendar un proceso con compuerta humana.
  • Meta-bucles ("ejecutar Looptimal para verificar Looptimal", "fusión automática cuando Looptimal dice VERDE") → Diseño-bucle debe RECHAZAR.
  • Métricas de éxito basadas solo en síntomas sin un oráculo de resultado conductual → re-Enmarcar o RECHAZAR.

Reglas operativas (leer primero)

  • Esto es una habilidad, no una persona o modo. Comenzar con una línea de activación, luego hacer el trabajo.
  • Con compuerta de verificación: Enmarcar → Analizar → Diseñar-bucle/Rutar → Planificar → Simular, cada uno con una breve parada de estado. Ejecutar nunca comienza sin un GO humano explícito después de Simular — o, en modo de un solo paso, después del premortem ligero que sustituye las verificaciones de Analizar/Diseñar-bucle/Planificar/Simular (ver la bifurcación de modo a continuación).
  • Nunca ejecutar automáticamente acciones irreversibles: despliegues de producción, envíos, pagos, rotación de credenciales, eliminación de datos — solo compuertas humanas previas a la acción.
  • Desacoplado del marco de trabajo: resolver enlaces desde ./.looptimal/profile.yaml → ~/.looptimal/profile.yaml → scripts/looptimal-detect.py → valores predeterminados genéricos. Contrato: references/agent-foundry.md.

Ejemplos de línea de activación:

  • Pipeline completo: "Looptimal — enmarcando este objetivo en un bucle de resultado sellado."
  • Ruta rápida de diseño: "Looptimal — creando el plano de este bucle."
  • Un solo paso: "Looptimal — un pase verificado en esto, sin bucle."
  • Invocado sin objetivo: hacer exactamente una pregunta — "¿Qué resultado debería ser cierto cuando hayamos terminado?" — luego la bifurcación de modo a continuación.
  • Objetivo ya dado: reconocer en una línea, luego la bifurcación de modo a continuación.

La bifurcación de modo (antes de Enmarcar — preguntar una vez, de manera económica)

El juicio de valor de bucle de Looptimal es la Compuerta de Decisión (Paso 1 del asistente, a continuación) — pero hoy solo se activa en las profundidades de la Etapa 2, después de que Enmarcar y Analizar ya se hayan ejecutado. Decidir la forma antes de que comience cualquier trabajo:

  • Redacción ya inequívoca — saltar la pregunta:
    • Palabras desencadenantes de ruta rápida de diseño ("diseñar un bucle", "construir un bucle", "plano", "asistente de bucles") → Etapa 2 directamente.
    • Lenguaje explícito de un solo paso que también descarta reintentos útiles ("un solo pase", "un pase cuidadoso", "no se necesita bucle de reintento") → un solo paso directamente.
    • Lenguaje explícito de entrega única con posible trabajo de verificador/reintento ("una sola vez", "solo hacer X una vez", "construir/arreglar/enviar esto una vez") → pipeline completo para que la Compuerta de Decisión pueda elegir misión/ejecución de objetivo frente a un solo paso.
    • Lenguaje explícito de recurrencia/cadencia ("nocturno", "cada PR", "mantener esto actualizado", "en curso") → pipeline completo directamente.
  • De lo contrario — hacer una pregunta estructurada de tres opciones antes de tocar la Etapa 0:
    1. Hacerlo de una vez, probado — un único resultado verificado sin bucle de reintento útil → un solo paso.
    2. Ejecutar una misión o construir un bucle — ya sea limitado (una misión/ejecución de objetivo que itera hasta una compuerta, luego se detiene — correcciones de errores, conformidad con especificaciones, construcciones únicas) o recurrente (se ejecuta en un horario/desencadenante indefinidamente) → pipeline completo (Etapa 0 → 1 → 2; la Compuerta de Decisión elige la ruta/arquetipo — Tarea / Recurrente / Supervisado / Trinquete-persistente / Orquestación, misión/ejecución de objetivo, o rechazo duro).
    3. Solo generar un plano de bucle → ruta rápida de diseño (solo Etapa 2).

Esto presenta la misma llamada de valor de bucle que la Compuerta de Decisión ya hace como el propio juicio del usuario, por adelantado y económico, en lugar de ser solo alcanzable después de que Analizar, Diseñar-bucle y Planificar ya se hayan gastado en la forma incorrecta (Enmarcar se ejecuta independientemente del modo elegido, por lo que nunca se desperdicia). Si la evidencia de la Etapa 0/1 contradice más tarde el modo elegido — un objetivo "de un solo paso" resulta ser claramente recurrente o necesitar iteración hasta una compuerta, o un "sistema recurrente" no sobrevive la Compuerta de Decisión — decirlo claramente y permitir que el usuario redirija. Nunca anular silenciosamente su elección; nunca cumplir silenciosamente con un modo que la evidencia no respalda.

Resolver el enlace (Preámbulo de la Etapa 0)

python3 scripts/looptimal-detect.py          # sondear marcadores; sugerir perfil
# o leer ./.looptimal/profile.yaml → ~/.looptimal/profile.yaml

Proporciona state_dir, dispatch.maker, dispatch.checker, verifier.default, banner opcional. Valores predeterminados genéricos: loops/<slug>/, verificador de shell.


El pipeline de 8 etapas

EtapaNombreTrabajoReferencia
0EnmarcarConvertir el objetivo en un conjunto de aceptación SELLADO con hash fijo. Cada criterio afirma un resultado (no un síntoma) y vincula un oráculo de resultado del dominio. Las entradas no pueden ser escritas por el creador. Emitir acceptance-suite.yaml + acceptance-suite.sha256.references/pipeline.md
1AnalizarProducir un Manifiesto de Capacidades y un inventario de preparación de capacidades locales: dominios, mapa de integración, riesgos, dependencias, habilidades/plugins/conectores/MCPs/agentes/datos disponibles. Delegar el trabajo de definición profunda a esat cuando lo que está en juego lo justifique para una prueba de estrés tri-modelo.references/pipeline.md
2Diseñar-bucle/RutarEjecutar el asistente de diseño de bucles o enrutar el objetivo. Elegir el arquetipo — Tarea (entrega limitada), Recurrente (actualización programada), Supervisado (autónomo dentro de barandillas), Trinquete-persistente (cada pase mejora estrictamente una métrica de resultado), Orquestación (multi-actor/multi-repositorio), misión/ejecución de objetivo, un solo paso — o RECHAZAR solo para casos duros sin verificador/meta-bucle/solo síntomas.references/pipeline.md
3PlanificarConstruir un grafo de tareas de consenso: nodos, dependencias, ganchos de aceptación por tarea vinculados al conjunto sellado, etiquetas de radio de explosión, notas de reversión.references/pipeline.md
4SimularAvanzar el bucle N pasos; modos de fallo de premortem (hackeo de recompensa, fallo silencioso, finalización parcial, deriva del entorno); endurecer el plan. Presentar los hallazgos y cualquier delta al conjunto sellado (re-hash + reconocimiento del usuario).references/pipeline.md
—GO humanoAprobación explícita para ejecutar. Superficiar los principales riesgos, elementos irreversibles, dependencias abiertas. Sin GO → sin Ejecutar.references/pipeline.md
5EjecutarIniciar subagentes expertos en el dominio dinámicos según el perfil de enlace. Creador ≠ verificador en las compuertas de iteración. Pasos reanudables e idempotentes; rutas de reversión para fallos parciales. Compuertas previas a la acción en elementos irreversibles.references/pipeline.md
6Verificar-resultadoUn verificador separado vuelve a ejecutar el conjunto SELLADO contra el estado real. Ignorar el VERDE autoinformado del bucle. Compuerta en un paquete de evidencia.references/pipeline.md
7PersistirEscribir estado duradero: hash del objetivo, hash del conjunto, lo que funcionó/falló, resultados del oráculo, clase de remediación, punteros de reanudación, lecciones para la próxima ejecución.references/pipeline.md

Transiciones de etapa (predeterminado)

  • 0 → 1: el conjunto sellado existe, cada criterio tiene un oráculo, hash registrado.
  • 1 → 2: el Manifiesto de Capacidades cubre todos los dominios materiales, bordes de integración y preparación de capacidades local.
  • 2 → 3: arquetipo o ruta de misión elegida (o RECHAZAR duro emitido con alternativa honesta).
  • 3 → 4: el grafo de tareas es acíclico, cada nodo se engancha a un criterio del conjunto, límites de seguridad establecidos.
  • 4 → GO: informe de simulación entregado; plan endurecido; elementos irreversibles etiquetados.
  • GO → 5: aprobación humana explícita capturada en estado.
  • 5 → 6: el creador declara la iteración completa — solo informativo; el verificador posee la verdad.
  • 6 → 7: paquete de evidencia VERDE; de lo contrario FALLO con clase de remediación y puntero de reanudación.

Reanudación

Si existe una ejecución anterior bajo state_dir y el hash del objetivo coincide, reanudar desde la última etapa incompleta. Si el objetivo cambió materialmente, re-Enmarcar (nuevo hash del conjunto). Nunca reanudar a través de un RECHAZAR duro sin un nuevo Diseñar-bucle/Rutar.


Etapa 2 — Asistente de Diseñar-bucle/Rutar

El asistente impone los cuatro átomos, ejecuta la compuerta de decisión de ruta y luego se ramifica. Las rutas de bucle reutilizable generan el paquete de artefactos completo de LoopPrint. Las rutas de misión/ejecución de objetivo emiten route.md + un paquete de misión (mission.yaml después de la Etapa 3) y continúan a la Etapa 3 Planificar sin andamiaje de bucle reutilizable. Las rutas de un solo paso emiten route.md más el premortem ligero y siguen la ruta de Degradación de un solo paso. Vive en la Etapa 2 del pipeline completo y también se ejecuta de forma independiente como la ruta rápida de diseño.

Entrada del asistente

  • Pipeline completo (llamado desde la Etapa 2): el objetivo es el resultado de la Etapa 0. Saltar al Paso 0.5.
  • Ruta rápida de diseño (invocación directa): abrir con una línea de activación; si no se da ningún objetivo, hacer una pregunta primero.

Paso 0.5 — Resolver el enlace

Ejecutar scripts/loopprint-detect.py (o leer ./.loopprint/profile.yaml → ~/.loopprint/profile.yaml) para obtener state_dir, verifier.default, dispatch, marker_path, runner, banner. Valores predeterminados genéricos: loops/<slug>/, verify.sh. Contrato: references/profiles.md. Nunca codificar convenciones del marco de trabajo.

Paso 1 — Compuerta de Decisión (+ ruta)

Ejecutar la prueba de Nivel 0 en references/decision-gate.md: 4 condiciones + lista de verificación de 30 segundos. Informar la ruta con una línea de razonamiento por condición. La recurrencia sigue siendo la prueba de amortización de bucle reutilizable, no toda la compuerta de orquestación: el trabajo no recurrente pero respaldado por un verificador puede enrutarse a misión/ejecución de objetivo o un solo paso. El RECHAZAR duro sigue siendo obligatorio cuando no hay verificador externo/punto de control humano, cuando el objetivo es autorreferencial/meta-bucle, o cuando el éxito es solo de síntomas sin un ancla conductual.

Ramificarse inmediatamente según la ruta seleccionada:

  • Ruta de bucle reutilizable: continuar a través de los Pasos 2-6, fijar el arquetipo/perfil del bucle, generar loops/<slug>/ y ejecutar loopprint-lint.
  • Ruta de Misión / Ejecución de Objetivo: no continuar con el perfil del bucle o la generación de artefactos. Emitir route.md con el controlador, artefacto de estado, verificador, parada/presupuesto, nivel de autonomía, brechas de preparación y por qué no se está produciendo un plano de bucle reutilizable; luego continuar a la Etapa 3 Planificar, que emite mission.yaml, task-graph.yaml, execute-scope.yaml y looptimal-lint.txt.
  • Ruta de Pase Verificado Único: no continuar con el perfil del bucle o la generación de artefactos. Emitir route.md con el verificador, artefacto de estado, parada, brechas de preparación y un premortem ligero de 3 escenarios; luego seguir la ruta de Degradación de un solo paso en lugar de las Etapas 3/4.
  • Ruta de flujo de trabajo con compuerta humana: emitir route.md con los puntos de control humanos y el verificador externo, luego continuar solo a través de la ruta supervisada que coincida con esas compuertas.
  • RECHAZAR duro: emitir reject.md con la razón no verificable/insegura y una alternativa honesta; detenerse a menos que el usuario reformule el objetivo.

Paso 2 — Refinamiento del objetivo del bucle reutilizable

Hacer 3–5 preguntas específicas (no más):

  1. Objetivo refinado — una oración, comprobable.
  2. Recurrencia / frecuencia — confirma que el bucle reutilizable se amortiza.
  3. Método de verificación — qué señal externa dice que una iteración tuvo éxito.
  4. Riesgos irreversibles — ¿qué no se puede deshacer? (→ punto de control humano)
  5. Nivel de autonomía — totalmente autónomo, con compuerta de verificación o simulación en seco.

Paso 3 — Imposición de primitivas del bucle reutilizable

Forzar un valor concreto para cada átomo. No continuar con ninguno vago:

  • Objetivo — el objetivo de una oración del Paso 2.
  • Estado — ruta del artefacto duradero desde el state_dir del enlace; lo que registra: registro de intentos, lo que falló, hipótesis actual, contexto.
  • Verificador — el comando externo exacto o revisor nombrado. Si la única verificación propuesta es que el mismo agente se autoevalúe, rechazarla y encontrar una compuerta real. Creador ≠ verificador.
  • Parada — criterios de éxito y un límite de seguridad (máximo de iteraciones, presupuesto de token/tiempo, parada explícita). Ningún bucle se envía sin un límite de seguridad.

Paso 4 — Selección de perfil del bucle reutilizable

Fijar el perfil completo del arquetipo — patrón de trabajo (de references/patterns.md) y forma del verificador/parada:

  • MORTY — error específico; verificador = prueba de reproducción; fi

Skills relacionados