coleam00/Archon

The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.

Archon – 결정적 AI 코딩 워크플로우

정의 – Archon은 AI 지원 소프트웨어 개발 작업(버그 수정, 기능 구현, 코드 검토, PR 생성 등)을 반복 가능하고 격리되며 구성 가능한 방식으로 오케스트레이션할 수 있는 오픈소스 워크플로우 엔진입니다. 개발 프로세스를 YAML 워크플로우로 설명합니다. Archon은 단계를 실행하며 지능이 필요한 곳에서만 LLM을 호출하고 나머지(bash 스크립트, 테스트, Git 작업)는 결정적으로 유지합니다.

주요 아이디어

결정적 실행 – 동일한 워크플로우는 항상 동일한 시퀀스를 따르므로 "모델 기분" 문제를 제거합니다.
격리 – 각 실행에는 자체 Git 워크트리가 있어 충돌 없이 병렬 실행이 가능합니다.
인간 개입 루프 – 루프는 승인 또는 피드백을 위해 일시 중지할 수 있으며 AI와 수동 단계를 혼합합니다.
이식성 – 워크플로우는 프로젝트의 .archon/workflows/ 폴더에 있으며 CLI, 웹 UI 또는 채팅 플랫폼(Slack, Telegram, Discord, GitHub webhooks)에서 트리거할 수 있습니다.

일반적인 워크플로우(단순화):

nodes:
  - id: plan        # AI가 계획 생성
    prompt: "Explore the codebase and create an implementation plan"
  - id: implement   # AI가 작업이 완료될 때까지 반복
    depends_on: [plan]
    loop:
      prompt: "Read the plan. Implement the next task. Run validation."
      until: ALL_TASKS_COMPLETE
      fresh_context: true
  - id: run-tests   # 결정적 bash 단계
    depends_on: [implement]
    bash: "bun run validate"
  - id: review      # AI가 변경 사항 검토
    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   # AI가 PR 생성
    depends_on: [approve]
    prompt: "Push changes and create a pull request"

이슈에서 archon-ship을 실행하면 자동으로:

격리된 브랜치/워크트리 생성
계획, 구현(테스트가 통과할 때까지 루프), 검토, 인간 승인 대기, 마지막으로 PR 열기.

설치 및 시작

전체 설정(약 5분) – 리포지토리를 클론하고 bun install을 실행하고 Claude Code를 설치한 다음 archon을 실행하고 대화형 마법사를 따릅니다(자격 증명 설정, Archon 스킬을 대상 리포지토리에 복사 등).
빠른 설치(약 30초) – Claude Code가 이미 설치된 경우 사전 컴파일된 바이너리를 가져올 수 있습니다:
```
curl -fsSL https://archon.diy/install | bash   # macOS/Linux
# 또는 Windows의 PowerShell
irm https://archon.diy/install.ps1 | iex
```
(Homebrew 포뮬러도 사용 가능합니다.)
워크플로우 실행 – 프로젝트 디렉토리 내에서: archon workflow run archon-ship 또는 간단히 어시스턴트에게 Use archon to fix issue #42라고 요청합니다.

웹 UI – archon serve는 콘솔을 시작하여 실행을 탐색하고 워크플로우 그래프를 보고 어시스턴트와 채팅하고 프로젝트를 관리할 수 있습니다. Slack, Telegram, Discord, GitHub webhooks용 어댑터를 통해 이러한 플랫폼에서 실행을 트리거할 수 있습니다.

내장 워크플로우 팩 – sdlc 팩에는 다음과 같은 준비된 워크플로우가 포함되어 있습니다:

archon-ship – 엔드투엔드 이슈 → PR
archon-triage, archon-investigate, archon-plan, archon-implement, archon-review, archon-validate, archon-upkeep archon workflow list로 나열할 수 있으며 자신만의 YAML 워크플로우를 사용자 정의하거나 작성할 수 있습니다.

아키텍처 스냅샷

Platform adapters (Web UI, CLI, Slack, …) → Orchestrator →
   Command handler, Workflow executor, AI assistant clients (Claude, Codex, Pi)
   ↕
   SQLite / PostgreSQL persistence (runs, projects, sessions, etc.)

텔레메트리 – Archon은 익명 사용 이벤트(워크플로우 이름, 결과, 노드 수, 공급자/모델 ID, 비용 등)를 보내지만 코드, 프롬프트 또는 개인 데이터는 절대 보내지 않습니다. 텔레메트리는 ARCHON_TELEMETRY_DISABLED=1 또는 표준 DO_NOT_TRACK으로 비활성화할 수 있습니다.

사용 대상 – 코드 생성에 LLM을 의존하고 재현 가능한 CI와 같은 파이프라인을 원하는 개발자; 감사 가능성과 반복성을 희생하지 않고 기존 개발 워크플로우에 AI 어시스턴트를 통합하려는 팀.

TL;DR – Archon은 AI 지원 개발 단계를 YAML로 스크립트화하고 CLI 또는 채팅 플랫폼에서 실행하며 "AI가 버그를 수정하게" 할 때 일반적으로 따르는 무작위성 없이 신뢰할 수 있는 PR을 얻을 수 있는 결정적이고 Git 인식 워크플로우 엔진입니다.

coleam00/Archon

Archon – 결정적 AI 코딩 워크플로우

관련