lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

sistema intermedio mcpclaude-codecodexespecificacion

Ouroboros: convierte una idea en una especificación ejecutable

Aclara requisitos mediante una entrevista y usa un contrato de ejecución para observar, evaluar y retomar el trabajo del agente.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.


Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: prepara el entorno

Comprueba que tienes un arnés compatible operativo y acceso al modelo. Para el núcleo usa Python 3.12–3.14; si eliges extras con LiteLLM, 3.12–3.13. El instalador puede preparar dependencias con uv. Para macOS, Linux o WSL 2, el README ofrece:

curl -fsSL https://raw.githubusercontent.com/Q00/ouroboros/main/scripts/install.sh | OUROBOROS_INSTALL_REF=readme bash

Paso 2: configura la integración

Abre el arnés que detectó el instalador. Dentro del agente, ejecuta en este orden los comandos del README:

ooo setup
ooo interview "Quiero construir una CLI de gestión de tareas"

Sustituye el objetivo por una tarea pequeña. Revisa el Seed (la especificación resultante) y sus criterios. Cuando lo hayas revisado, pide ooo run sobre ese Seed desde el mismo arnés. Consulta ooo status para identificar la ejecución y ooo evaluate para contrastar su resultado con los criterios. La entrevista por sí sola no comprueba la ejecución ni la evaluación que anuncia esta ficha.

Comprobación

Comprueba que el contrato refleja la intención acordada y que la evaluación usa resultados verificables. Revisa cómo se recupera el estado antes de probar interrupciones largas.

Si algo falla

Si la instalación expone otra interfaz de la familia Ouroboros, consulta la tabla de capas del README. No mezcles instrucciones del núcleo con las de repositorios homónimos.

ver en .md ¿Prefieres el recurso entero?

Qué es

Ouroboros es una capa de ejecución para agentes de programación centrada en especificaciones. Su flujo parte de una entrevista y conserva un contrato de trabajo que se puede observar y evaluar.

Para qué te sirve

  • Cuando una idea necesita aclarar alcance y criterios antes de transformarse en código.
  • Cuando quieres separar la intención acordada de los pasos que decide el agente.
  • Cuando necesitas revisar una ejecución y continuar con información persistida.

Cómo funciona

La entrevista cristaliza un Seed que alimenta la ejecución. El sistema contempla evaluación e iteración con límites y políticas. El README actual diferencia un núcleo, aplicaciones de flujo de trabajo y una interfaz de terminal mantenidos en repositorios relacionados.

La integración puede realizarse desde distintos arneses y mediante MCP. El contrato y los registros ayudan a reconstruir decisiones, pero debes comprobar qué componentes instala la ruta que elijas.

Antes de empezar

Selecciona el arnés y la modalidad oficial. El instalador tiene variantes para Unix, WSL y Windows. El núcleo admite Python 3.12–3.14; las rutas con LiteLLM admiten 3.12–3.13. El instalador gestiona sus dependencias con uv cuando corresponde. Necesitas acceso al modelo y herramientas de tu entorno; la instalación del núcleo no resuelve los requisitos de la aplicación que quieras construir.

Límites y alternativas

El puntaje de ambigüedad y la evaluación automática son indicadores del sistema, no pruebas universales de claridad o calidad. Conserva una revisión humana del contrato. Para un cambio breve, una especificación escrita y comprobaciones del proyecto pueden ser suficientes.

Recursos

  • Repositorio y README - 6278 estrellas; licencia detectada por GitHub: MIT.
  • Licencia - Consulta sus condiciones antes de reutilizar el proyecto.