Context Vault

Archon — 오픈소스 AI 코딩 하네스 빌더

3 min read

Archon — 오픈소스 AI 코딩 하네스 빌더

“Dockerfiles이 인프라에 한 것, GitHub Actions가 CI/CD에 한 것 — Archon은 AI 코딩 워크플로우에 그것을 한다.”

핵심 개념

AI 코딩 에이전트를 위한 워크플로우 엔진. 개발 프로세스를 YAML 워크플로우로 정의하면(기획→구현→검증→코드 리뷰→PR 생성) 모든 프로젝트에서 결정론적으로 실행할 수 있다.

기본 정보

  • ⭐ 14,100+ 스타 | 🍴 2,400+ 포크
  • 언어: TypeScript (Bun 런타임)
  • 라이선스: 커뮤니티 (CONTRIBUTING.md 기반)
  • 최신 릴리즈: v0.3.2 (2026-04-08)
  • 홈페이지: https://archon.diy
  • 설치: curl -fsSL https://archon.diy/install | bash 또는 brew install coleam00/archon/archon

주요 기능

  • YAML 워크플로우: 다단계 개발 프로세스를 YAML로 정의
  • 결정론적 + AI 단계: bash 스크립트, 테스트, 린터와 AI 코드 생성 혼합
  • Git worktree 격리: 모든 워크플로우 실행이 독립 worktree에서 동작 — 5개 fix 병렬 실행 가능
  • Loop 노드: 테스트가 통과할 때까지 반복
  • Human approval gate: 진행 전 리뷰 체크포인트
  • 멀티 플랫폼: CLI, Web UI, Slack, Telegram, Discord, GitHub webhooks
  • 17개 기본 워크플로우: 이슈 수정, PR 생성, 코드 리뷰, 안전한 리팩토링 등

기본 워크플로우

워크플로우설명
archon-assist일반 Q&A, 디버깅, 탐색
archon-fix-github-issue이슈 분류 → 조사/기획 → 구현 → 검증 → PR → 스마트 리뷰 → 자가 수정
archon-idea-to-pr기능 아이디어 → 기획 → 구현 → 검증 → PR → 5개 병렬 리뷰 → 자가 수정

아키텍처

CLI Command → Workflow Engine → AI Assistant Clients (Claude Code, Codex)
  • Claude Code와 네이티브 통합 (설치 마법사 제공)
  • Claude Code skill으로 설치 가능
  • Web 대시보드 제공 (프로젝트 등록, 채팅, 워크플로우 모니터링)

역사

  • v1: Python 기반 task management + RAG 도구 → archive/v1-task-management-rag 브랜치에 보존
  • v2 (현재): TypeScript 완전 재작성 — AI 코딩 워크플로우 엔진으로 전환

관련 노트

Sources

그래프 뷰