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 | | |