ONEDEV

Archon

AI Agent OrchestrationCLITypeScript

★ 23,441주당 +71조회 4

무엇인가

Archon은 AI 코딩 에이전트가 따르는 개발 절차를 YAML 워크플로로 고정해 실행하는 워크플로 엔진이다. 코드를 직접 생성하는 에이전트가 아니라, 에이전트 위에서 단계 순서와 검증 지점을 강제하는 하네스 계층에 속한다. 인프라의 Dockerfile, CI/CD의 GitHub Actions가 맡던 자리를 AI 코딩 과정에 대응시킨 위치다.

어떻게 동작하나

워크플로는 `.archon/workflows/` 아래에 YAML, 명령, 스크립트를 함께 두는 형태로 저장되고 저장소에 커밋된다. 노드는 두 종류로 나뉜다. bash 스크립트·테스트·git 작업 같은 결정적 노드와 계획·코드 생성·리뷰 같은 AI 노드가 하나의 그래프에 섞이며, AI는 값을 더하는 지점에서만 호출된다. 실행마다 별도의 git worktree가 만들어져 병렬 실행이 서로 충돌하지 않는다. 기본 번들 워크플로는 `archon workflow list`로 확인하고, 같은 이름의 파일을 저장소에 두면 번들 기본값을 덮어쓴다.

무엇과 다른가

에이전트에 자연어 요청만 던지는 방식과 달리 단계 순서와 검증 게이트가 사용자 소유의 파일에 남는다. GitHub Actions가 CI 작업을 YAML로 고정하듯 개발 과정 자체를 고정하고, 각 단계의 판단만 모델에 맡긴다. 워크플로 정의는 CLI, 웹 UI, Slack, Telegram, GitHub 어디에서 실행해도 같은 순서로 동작한다.

어떻게 쓰나

설치는 두 갈래다. 저장소를 클론한 뒤 Claude Code에서 "Set up Archon"이라고 말하면 자격 증명, 플랫폼 연동, 대상 프로젝트로의 스킬 복사를 안내하는 마법사가 실행된다. Claude Code가 이미 있으면 독립 CLI 바이너리나 Homebrew로 설치해 마법사를 건너뛴다. 웹 대시보드는 `archon serve`로 띄우며 Chat, Dashboard, Workflow Builder, Workflow Execution 페이지를 갖추고, 사이드바에서 CLI·Slack·Telegram·GitHub의 대화를 한곳에 모은다. 설정 파일은 `~/.archon/config.yaml`이고, 소스 체크아웃은 `bun run build:web`을 먼저 실행해야 한다.

전제와 한계

전제 조건은 Bun, Claude Code, GitHub CLI다. 컴파일된 바이너리는 Claude Code를 포함하지 않아 `CLAUDE_BIN_PATH` 또는 `assistants.claude.claudeBinaryPath` 지정이 필요하다. macOS/Linux x64 빠른 설치는 AVX2를 요구하므로 AVX2를 가리거나 지원하지 않는 CPU·VM은 소스 설치를 써야 한다. 워크플로는 `.archon/workflows/` 또는 `~/.archon/workflows/`에 있어야 하며, 이전 Python 기반 버전은 `archive/v1-task-management-rag` 브랜치에 보존되어 있다.

유사 도구