Name: Ouroboros
SKU: -

소개

Ouroboros는 AI 코딩 워크플로우를 구조화하고 재현 가능하게 만드는 Agent OS입니다. Q00에서 개발했으며, 인터뷰, 시드, 실행, 평가, 진화의 사이클을 통해 모호한 아이디어를 검증된 코드베이스로 변환합니다. MIT 라이선스로 배포되며, Claude Code, Codex CLI, Gemini CLI 등 14개 이상의 AI 코딩 에이전트와 통합되어 작동합니다.

상세정보

Socratic 인터뷰

사용자의 초기 요청에서 숨겨진 가정을 노출하고 모호성을 점수화하여 명확한 문제 정의를 도출합니다. 예를 들어 “작업 관리 CLI를 만들고 싶다”는 요청에서 12개의 숨은 가정을 찾아내고 모호성 점수 0.19를 산출합니다.

불변 시드 사양

인터뷰 결과를 바탕으로 수락 기준, 온톨로지, 제약 조건을 포함한 변경 불가능한 사양서를 생성합니다. 이 사양은 이후 모든 작업의 계약이 되어 아키텍처 drift를 방지합니다.

3단계 자동 평가 게이트

기계적 검사(무료) → 의미적 검사 → 다중 모델 합의로 구성된 검증 파이프라인을 통해 생성된 코드가 의도와 일치하는지 자동으로 평가합니다. 이는 “보여주기식” 검증을 대체하여 신뢰성을 높입니다.

진화 루프 (Ralph)

평가 결과를 다음 세대의 시드 사양으로 피드백하여 온톨로지 유사도 0.95에 도달할 때까지 반복적으로 개선합니다. 이 과정은 완전히 stateless하며, 머신 재시작 후에도 이어서 실행할 수 있습니다.

다운로드·설치 방법

Windows에서는 PowerShell을 관리자 권한으로 실행하고 다음 명령을 입력하여 설치합니다. 이 스크립트는 Git과 uv가 없을 경우 자동으로 winget을 통해 설치합니다.

irm https://raw.githubusercontent.com/Q00/ouroboros/main/scripts/install.ps1 | iex

설치 후, AI 코딩 에이전트 내에서 ooo setup을 한 번 실행하여 런타임을 구성합니다. 이는 프로젝트당 한 번만 필요합니다.

기본 사용법/명령어

설치 및 초기 설정 후, AI 코딩 에이전트 세션에서 다음 순서로 명령을 실행하여 워크플로우를 시작합니다.

ooo setup

이후, 목표를 설명하는 문장으로 인터뷰를 시작합니다.

ooo interview "작업 관리 CLI를 만들고 싶다"

이 명령은 Socratic 인터뷰를 시작하여 숨겨진 가정을 탐지하고 모호성 점수를 반환합니다. 인터뷰가 완료되면 자동으로 시드 파일이 생성됩니다.

생성된 시드를 실행하려면 다음 명령을 사용합니다.

ooo run seed.yaml

이 명령은 Double Diamond 분해(발견 → 정의 → 설계 → 전달)를 통해 코드를 생성합니다. 실행 후에는 자동으로 3단계 평가 게이트가 트리거됩니다.

평가 결과를 기반으로 다음 세대를 자동으로 진행하려면 다음과 같이 실행합니다.

ooo evolve

이 명령은 MCP를 통해 진화 루프를 실행하며, 온톨로지 유사도가 목표치에 도달할 때까지 반복합니다. 수동으로 루프를 지속적으로 실행하려면 ooo ralph를 사용합니다.

이런 경우에 유용합니다

AI 코딩 에이전트를 사용할 때 프롬프트가 모호하여 예상과 다른 결과가 나오는 경우, Ouroboros의 인터뷰 기능을 통해 사용자의 실제 의도를 명확히 할 수 있습니다. 이는 특히 작업 관리 도구, 웹 스크래퍼, 데이터 처리 스크립트와 같은 일반적인 자동화 작업을 정의할 때 유용하며, 개발자는 여러 번의 시도와 오류를 줄이고 빠르게 검증 가능한 코드베이스를 얻을 수 있습니다.

지원 환경·시스템 요구사항

Ouroboros는 Windows 10 이상, macOS 12 이상, Linux 배포장에서 실행 가능합니다. Windows에서는 네이티브 지원이 실험적이며, 안정적인 사용을 위해 WSL 2에서의 Codex CLI 사용을 권장합니다. 설치는 PowerShell 5.1 이상 또는 pwsh 7+에서 이루어지며, 인터넷 연결이 필요하여 Git과 uv를 자동으로 다운로드합니다. Python 3.12 이상이 필수이며, LiteLLM 기능을 사용할 경우 Python 3.12-3.13 환경이 필요합니다.

제한 사항·확인 사항

네이티브 Windows 지원은 실험적 단계이며, 일부 런타임(예: Codex CLI)은 WSL 2 환경에서만 정상 작동합니다. 설치를 위해서는 관리자 권한이 필요하며, 방화벽 또는 프록시 환경에서는 Git과 uv의 다운로드가 차단될 수 있습니다. 또한, 오프라인 환경에서는 초기 설치가 불가능하며, 모든 런타임은 인터넷 연결을 통해 의존성을 해결해야 합니다.

시스템 요구사항

Python 3.12 이상이 필요하며, LiteLLM 관련 기능은 Python 3.12-3.13에서만 지원됩니다. 설치는 PowerShell 또는 bash 스크립트를 통해 이루어지며, Windows에서는 Git과 uv를 자동으로 설치합니다.

Ouroboros

소개