정의
Ordewell(ordewell/ordewell)은 하나의 개발 목표를 받으면 저장소를 읽고 모호한 점을 질문한 뒤, 작업 의존 그래프(plan) 로 분해하고 각 작업에 실행할 코딩 에이전트(runner), 모델, 추론 수준(thinking effort), 모드(mode)를 지정해 Claude Code·Codex·OpenCode에 배분·실행하는 멀티 에이전트 오케스트레이터다. 단독 코딩 에이전트를 감싸는 하네스(harness)보다는, 여러 에이전트를 계획 → 편집 → 실행 → 완료 검증 흐름으로 묶는 오케스트레이션 레이어에 가깝다.
핵심 특징:
- 계획 담당(planner) 에이전트가 저장소를 읽고 필요한 질문을 사람에게 던진 뒤, 작업 그래프 형태의 계획을 반환한다. 계획 확정 전에는 작업을 추가·삭제하거나 담당 모델·작업 간 의존 관계를 직접 수정할 수 있다.
- 실행 담당(runner) 에이전트가 실제 코드 수정을 수행한다. 복잡한 코드 수정과 간단한 문서 작업에 서로 다른 모델/추론 수준을 배정할 수 있다.
- 쓰기 불가 플래너: 플래너는 저장소를 읽고 묻고 계획만 한다. 저장소를 바꾸는 명령은 거부된다.
- 병렬성: 독립 작업은 병렬로(기본 동시 3개), 선행 결과가 필요한 작업은 순서대로 실행한다. 각 작업은 새 에이전트 세션과 자기 브랜치·git worktree에서 실행되고, 선행 작업의 결과를 넘겨받는다.
- 완료 검증: 프로세스가 종료됐다는 이유만으로 완료 처리하지 않고, 출력에 지정된 완료 표식(completion marker)이 있는지 확인하며 없으면 실패로 처리한다. 모델이 자기 작업을 스스로 평가한 의견은 판정에 쓰지 않고, 종료 코드는 보조 증거로만 남긴다.
- 착륙과 인계: 통과한 작업은 계획 순서대로 실행별 통합 브랜치에 머지된다. 충돌하면 작업에 해결 기회를 한 번 주고, 실패하면 충돌 파일을 명시한 채 사람을 기다린다. 실행이 끝나면 diff를 검토한 뒤 머지·폐기·worktree 정리를 고른다(
ordewell handoff review/handoff merge). - 지속성: 진행 상태를 로컬에 자동 저장하고, 완료한 작업을 유지한 채 계획을 변경하거나 세션을 다시 불러올 수 있다.
- 계획 보강(augmentation): 요구사항을 구체화하는 질문, 제품 요구사항 문서(PRD) 작성, 테스트 주도 개발(TDD) 지침을 계획에 추가할 수 있다.
- 인터페이스: VS Code 확장, 터미널 UI(TUI), CLI를 제공하며, 기존 코딩 에이전트의 인증을 이용하면 별도 API 키 없이 시작할 수 있다(25개 제공자의 API 키도 사용 가능). 세 인터페이스와 로컬 API가 하나의 코어를 공유한다.
- 스택: TypeScript/Node.js 기반, Apache-2.0 라이선스. VS Code 확장 마켓플레이스 배포 + npm 설치(
npm install -g ordewell, 배지 표기 패키지는@ordewell/cli). Claude Code, Codex, OpenCode를 즉시 지원.
관련 도구와의 위치
멀티 에이전트 코딩 오케스트레이션 지형에서 Ordewell은 계획 → 검토 → 실행의 중간에 사람이 개입하는 형태를 강조한다. 비슷한 층위의 도구와 비교하면:
| 도구 | 강조점 | 사람 개입 지점 |
|---|---|---|
| harnessrouter | 여러 하네스를 하나의 Console+API로 통합 운영 (UHP 구현, OpenAI Responses 호환) | 콘솔/API 운영 |
| 2026-08-02-herdr-agent-multiplexer / 2026-09-24-herdr-projects | tmux for AI agents + 코디네이터 플러그인, 병렬 스레드 제안·상태 집계 | 대화창 기반 스레드 관리 |
| 2026-05-02-ruflo | Claude Code용 멀티 에이전트 오케스트레이션 (Claude Flow 후속) | Claude Code 생태계 내 오케스트레이션 |
| Ordewell | 목표 → 계획(질문 포함) → 사람이 계획 검토·수정 → 에이전트에 배분·실행·완료 검증 | 계획 확정 전 검토/편집 |
Ordewell의 차별점은 “계획을 사람이 읽고 고친 뒤 실행”하는 흐름과, 완료 표식 기반 검증, 그리고 Claude Code·Codex·OpenCode를 한 계획 안에서 섞어 쓸 수 있는 점이다.
기술적 맥락
-
CLI 흐름:
ordewell plan --goal "…"→ (계획 편집:task-runner 2 opencode,task-model 3 sonnet,task-deps 3 1,2) →ordewell run→handoff review→handoff merge. -
Node.js 20+, git(worktree 기반 작업 격리), tmux(TUI용) 필요. Windows에서는 WSL 하에서 TUI 실행.
-
각 작업은 별도 git worktree에서 실행되어 여러 저장소 워크스페이스도 한 task가 모든 저장소의 worktree를 갖고 착륙(landing)하도록 설계됨.
-
아키텍처 결정 기록(ADR)을
docs/adr에 유지하며, 설계에서 기각된 선택지도 기록해 둔다. -
grilling/spec/architecture 스킬과 TDD task augmentation은 Matt Pocock의 스킬(MIT)에서 차용.
참고
- 공식 사이트: https://ordewell.ai
- 문서: https://ordewell.ai/docs
- npm: https://www.npmjs.com/package/@ordewell/cli
- VS Code Marketplace: https://marketplace.visualstudio.com/items?itemName=ordewell.ordewell
- 저장소: https://github.com/ordewell/ordewell
- GeekNews #34290 (2026-09-26): https://news.hada.io/topic?id=34290 — 댓글에서 “프로세스는 정상 종료됐는데 실제로 한 일은 없는” 경우를 완료 표식으로 거르는 점이 가장 호평받음
관련 노트
- moc-ai-coding — AI 코딩 운영면 상위 MOC
- moc-ai-coding-ops-console — 여러 코딩 에이전트 세션·관측·재개·오케스트레이션 MOC
- moc-ai-coding-catalog — AI 코딩 도구·스킬·런타임 상세 카탈로그
- moc-ai-agents-orchestration — 여러 에이전트 조율·통신·협업 MOC
- harnessrouter — 여러 코딩 에이전트 하네스를 하나의 Console+API로 통합 운영하는 플랫폼
- 2026-08-02-herdr-agent-multiplexer — tmux for AI agents
- 2026-09-24-herdr-projects — Herdr용 코디네이터 플러그인
- 2026-05-02-ruflo — Claude Code용 멀티 에이전트 오케스트레이션
- 2026-09-12-claude-code-codex-multitool-strategy — Claude Code ↔ Codex 멀티툴 전략과 핸드오프 패턴
- frontier-development — 에이전트가 계획·실행·검증까지 자율 수행하는 AI 네이티브 개발 방식