Ouroboros

English | 한국어

◯ ─────────── ◯

O U R O B O R O S

◯ ─────────── ◯

Stop prompting. Start specifying.
Specification-first AI coding workflows 를 위한 Agent OS

Quick Start · Why · Results · How It Works · Commands · Philosophy

Claude Code, Codex CLI, OpenCode, 그리고 Hermes 를 통해 모호한 아이디어를 검증된 작동 가능한 코드베이스로 전환하세요.

Ouroboros 는 AI 코딩을 위한 Agent OS 입니다: 비결정론적 (non-deterministic) 에이전트 작업을 재현 가능하고 관찰 가능하며 정책으로 구속되는 실행 계약 (execution contract) 으로 바꾸는 로컬-퍼스트 (local-first) 런타임 레이어입니다. 즉흥적인 프롬프팅을 구조화된 specification-first 워크플로우로 대체합니다: interview, crystallize, execute, evaluate, evolve.

대부분의 AI 코딩은 출력이 아닌 입력에서 실패합니다. 병목 현상은 AI 능력 자체가 아니라 인간의 명확성입니다.

Problem	What Happens	Ouroboros Fix
Vague prompts	AI 가 추측하고, 사용자가 재작업	소크라틱 인터뷰 (Socratic interview) 가 숨겨진 전제를 드러냄
No spec	빌드 중 아키텍처가 산만해짐	불변의 시드 스펙 (immutable seed spec) 이 코딩 전에 의도를 잠금
Manual QA	"좋아 보인다"는 검증이 아님	3 단계 자동화 평가 게이트 (automated evaluation gate)

Install — 하나의 명령어로, 모든 것이 자동으로 감지됩니다:

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

Build — AI 코딩 에이전트를 열고 시작하세요:

> ooo interview "I want to build a task management CLI"

Claude Code, Codex CLI, OpenCode, 그리고 Hermes 와 호환됩니다. 설치 프로그램은 Claude Code, Codex CLI, 및 Hermes CLI 를 자동으로 감지하고 MCP 서버를 등록합니다. OpenCode 의 경우 설치 후 다음 명령어를 실행하세요:

ouroboros setup --runtime opencode

Other install methods

Claude Code plugin only (시스템 패키지 없음):

claude plugin marketplace add Q00/ouroboros && claude plugin install ouroboros@ouroboros

그런 다음 Claude Code 세션 내에서 ooo setup 을 실행하세요.

pip / uv / pipx:

pip install ouroboros-ai # base
pip install ouroboros-ai[claude] # + Claude Code deps
pip install ouroboros-ai[litellm] # + LiteLLM multi-provider
pip install ouroboros-ai[mcp] # + MCP server/client support
pip install ouroboros-ai[tui] # + Textual terminal UI
pip install ouroboros-ai[all] # everything (claude + litellm + mcp + tui + dashboard)
ouroboros setup # configure runtime

Legacy compatibility: ouroboros-ai[dashboard] 는 extras 가 마이그레이션되는 동안 여전히 호환성 별칭 (compatibility alias) 으로 인정됩니다.

런타임 가이드 보기: Claude Code · Codex CLI · Hermes · OpenCode

Uninstall

ouroboros uninstall

모든 설정, MCP 등록, 및 데이터를 제거합니다. 자세한 내용은 UNINSTALL.md 를 참조하세요.

Python >= 3.12 가 필요합니다. 전체 종속성 목록은 pyproject.toml 을 참조하세요.

Ouroboros 사이클의 한 루프를 거치면 모호한 아이디어가 검증된 코드베이스로 바뀝니다:

Step	Before	After
Interview
"Build me a task CLI"
12 개의 숨겨진 전제가 드러나고, 모호성 점수가 0.19 로 감소
Seed
No spec
불변의 스펙으로 수용 기준 (acceptance criteria), 온톨로지 (ontology), 제약조건 포함
Evaluate
수동 검토
3 단계 게이트: Mechanical (무료) -> Semantic