Archon - AI 코딩 하네스 빌더

AI 코딩을 결정론적이고 반복 가능하게 만드는 최초의 오픈소스 하네스 빌더. YAML로 개발 프로세스를 정의하고 모든 프로젝트에서 일관되게 실행.

“Dockerfiles = Infrastructure, GitHub Actions = CI/CD, Archon = AI Coding Workflows”

핵심 개요

항목	값
Stars	20,228
Forks	3,094
언어	TypeScript (98.0%)
라이선스	MIT
Latest	v0.3.10 (2026-04-29)
생성일	2025-02-07
Homepage	archon.diy
Contributor	30명

핵심 아이디어

AI 에이전트에게 “이 버그 고쳐줘” 라고 할 때마다 다른 결과가 나오는 문제를 해결:

모델 기분에 따라 계획 스킵
테스트 실행 까먹음
PR 템플릿 무시

→ 워크플로우로 개발 프로세스를 인코딩하여 구조는 결정론적으로, 지능은 AI가 각 단계에서 채움.

워크플로우 예시

# .archon/workflows/build-feature.yaml
nodes:
  - id: plan
    prompt: "Explore the codebase and create an implementation plan"
 
  - id: implement
    depends_on: [plan]
    loop:
      prompt: "Read the plan. Implement the next task. Run validation."
      until: ALL_TASKS_COMPLETE
      fresh_context: true  # 매 이터레이션 fresh session
 
  - id: run-tests
    depends_on: [implement]
    bash: "bun run validate"  # 결정론적 - AI 없음
 
  - id: review
    depends_on: [run-tests]
    prompt: "Review all changes against the plan. Fix any issues."
 
  - id: approve
    depends_on: [review]
    loop:
      prompt: "Present the changes for review. Address any feedback."
      until: APPROVED
      interactive: true  # 인간 입력 대기
 
  - id: create-pr
    depends_on: [approve]
    prompt: "Push changes and create a pull request"

주요 특징

특징	설명
Repeatable	같은 워크플로우 → 같은 순서, 매번 동일
Isolated	각 실행 = 자체 git worktree, 병렬 실행 가능
Fire and Forget	워크플로우 시작 후 다른 작업 수행 가능
Composable	결정론적 노드(bash, test, git) + AI 노드(plan, code, review) 혼합
Portable	`.archon/workflows/`에 정의, CLI/Web/Slack/Telegram/GitHub 동일 동작

워크플로우 노드 타입

AI 노드: prompt 필드, loop + until 패턴 지원
Bash 노드: bash 필드, 결정론적 실행
인터랙티브 노드: interactive: true, 인간 승인 대기

실행 예시

You: archon으로 설정 페이지에 다크모드 추가해줘

Agent:
  → 격리된 worktree 생성 (branch archon/task-dark-mode)
  → Planning...
  → Implementing (task 1/4)...
  → Implementing (task 2/4)...
  → Tests 실패 → iterating...
  → Tests 통과 (2회 시도)
  → Code review 완료 - 0 issues
  → PR 준비 완료: https://github.com/you/project/pull/47

아키텍처: n8n for Software Development

n8n이 비즈니스 자동화를 하는 것처럼, Archon은 소프트웨어 개발 워크플로우를 자동화.

보강된 운영 메모

이 노트는 2026-04-10 버전의 내용을 흡수했다.

Claude Code 네이티브 통합: 설치 마법사를 제공하고, Claude Code skill로도 설치 가능
기본 워크플로우: archon-assist, archon-fix-github-issue, archon-idea-to-pr 등 18종 이상 기본 제공 → 전체 목록·설명은 archon-workflows 카탈로그 참고
초기 버전 역사: v1은 Python 기반 task management + RAG 도구였고, 현재 v2는 TypeScript 재작성본
배포 형태: CLI, Web UI, Slack, Telegram, Discord, GitHub webhooks 지원

출처

GitHub: https://github.com/coleam00/archon
Homepage: https://archon.diy
이전 버전: archive/v1-task-management-rag (Python 기반)

LLM Wiki

탐색기

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