정의

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-projectstmux for AI agents + 코디네이터 플러그인, 병렬 스레드 제안·상태 집계대화창 기반 스레드 관리
2026-05-02-rufloClaude 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)에서 차용.

참고

관련 노트