Ouroboros는 AI 코딩을 일회성 프롬프트가 아니라 재생 가능한 실행 계약으로 바꾸려는 로컬 우선 Agent OS다. Claude Code, Codex CLI, OpenCode, Hermes, Gemini, Kiro, Copilot, Pi, Zcode 같은 여러 에이전트 런타임을 지원하고, vague idea를 interview -> crystallize -> execute -> evaluate -> evolve 흐름으로 구조화한다.
스택 구조
Ouroboros는 세 계층으로 설명된다.
| 계층 | 역할 |
|---|---|
| Shell | ourocode TUI로 여러 CLI와 MCP 상태, 결정 UI를 제공 |
| Apps | ouroboros-plugins가 PR, Jira, incident, release 같은 도메인 워크플로를 제공 |
| OS | ouroboros core가 Seed, Ledger, Runtime, MCP, safety boundary를 관리 |
핵심은 모든 행동을 Seed에 묶고 ledger에 기록해, 어떤 모델이 실행하든 작업 흔적과 정책 경계를 남기는 것이다.
명세 우선 워크플로
Ouroboros는 사용자의 막연한 요구를 바로 구현하지 않고, 질문을 통해 Seed를 만들고, Seed를 명세로 결정화한 뒤, 실행과 평가를 반복한다. 이는 agent-harness 관점에서 “프롬프트”를 실행 가능한 하네스 계약으로 끌어올리는 접근이다.
대표 명령은 다음 범주로 나뉜다.
ooo init: 프로젝트 초기화ooo interview: 요구사항 질문ooo crystallize: 명세 생성ooo execute: 에이전트 실행ooo evaluate: 결과 평가ooo status: 실행 상태 추적
언제 볼 만한가
- 여러 AI 코딩 CLI를 한 팀처럼 다루려는 사용자
- 작업 기록, 정책, 재현성을 프롬프트보다 중요하게 보는 팀
- PR, 릴리스, incident 같은 반복 워크플로를 에이전트 앱으로 만들고 싶은 조직
- superpowers나 스킬 기반 워크플로를 더 강한 runtime 계약으로 확장하려는 사용자
관련 문서
- agent-harness — 코딩 에이전트 성능을 좌우하는 하네스 설계
- claude-code — Claude Code 개요
- codex — OpenAI Codex 개요
- mcp — 외부 도구와 에이전트를 연결하는 프로토콜
- pro-workflow — Claude Code 자기교정 워크플로 스택
참고 자료
- Q00/ouroboros — GitHub 공식 저장소