상위 노트 — Archon 도구 개요·아키텍처는 2026-04-30-archon-harness-builder. 이 페이지는 그 도구가 기본 제공하는 워크플로우 카탈로그다. 유사 도구: 2026-03-21-gstack, 적대적 개발 패턴은 2026-03-29-ai-agent-debate-pattern 참고.
Archon은 AI 코딩 어시스턴트(Claude, Codex 등)를 자동으로 단계별 실행해 주는 도구입니다. 각 워크플로우는 여러 개의 “노드(단계)“로 구성되며, 대부분 격리된 git worktree에서 안전하게 실행됩니다.
실행 방법
bun run cli workflow run <워크플로우-이름> "원하는 작업 설명"
# 예시
bun run cli workflow run archon-assist "이 함수가 무슨 일을 하는지 알려줘"
bun run cli workflow run archon-idea-to-pr "다크모드 추가해줘"기타 명령:
bun run cli workflow list # 사용 가능한 워크플로우 목록
bun run cli workflow status # 실행 중인 워크플로우 확인
bun run cli workflow resume <id> # 실패한 워크플로우 재개💬 1. 기본 — 만능 도우미
archon-assist
- 언제? 다른 워크플로우에 딱 맞지 않는 모든 요청 (질문, 디버깅, 코드 탐색, 일회성 작업, 설명, CI 실패 분석 등)
- 특징: 단일 노드, Claude의 모든 기능 사용 가능, worktree 비활성화(현재 작업 폴더에서 바로 실행)
- 라우터가 적절한 워크플로우를 못 찾으면 자동으로 여기로 연결됨
🚀 2. 아이디어/계획 → PR (개발 자동화)
archon-idea-to-pr ⭐
- 언제? “다크모드 추가해줘”처럼 아이디어만 있을 때
- 자연어 아이디어/PRD → 계획 수립 → 구현 → 검증 → PR 생성 → 5개 리뷰 에이전트 병렬 검토 → 수정
- 8단계 파이프라인 (계획 생성 → 셋업 → 구현(Opus) → 검증 → PR → 리뷰 → 수정 → 요약)
- 5개 병렬 리뷰: 코드 / 에러 처리 / 테스트 커버리지 / 주석 품질 / 문서 영향도
archon-plan-to-pr
- 언제? 계획 파일이 이미 있을 때
idea-to-pr와 거의 같지만 계획 생성 단계를 건너뛰고 바로 구현부터 시작
archon-feature-development
- 언제? 계획 파일이나 GitHub 이슈의 계획대로 기능 구현
- 가장 가벼운 “구현 + PR” 조합 (구현 → PR 생성 → PR base 브랜치 검증)
🔍 3. PR / 코드 리뷰
archon-comprehensive-pr-review
- PR을 main과 동기화 → 5개 전문 리뷰 에이전트 병렬 실행 → 결과 종합 → CRITICAL/HIGH 이슈 자동 수정
- 항상 5개 에이전트를 모두 실행하는 “풀코스” 리뷰
archon-smart-pr-review ⭐
- PR 복잡도를 먼저 분류 → 필요한 리뷰 에이전트만 골라 실행 → 종합 → 자동 수정
- 오타 수정 같은 사소한 PR은 테스트/문서 리뷰를 건너뛰어 효율적
- 설정 시 ntfy 푸시 알림 가능
archon-validate-pr
- main 브랜치(버그 있음)와 feature 브랜치(버그 수정됨)를 둘 다 실제로 테스트해서 비교
- 빈 포트 자동 할당 → 병렬 코드 리뷰 → E2E 테스트(main에서 버그 재현, feature에서 수정 확인) → 최종 판정
🐛 4. GitHub 이슈 처리
archon-fix-github-issue ⭐
- 언제? “이슈 #123 고쳐줘”
- 이슈 번호 추출 → 분류 → 웹 리서치 → (버그면 원인분석 / 기능이면 계획) → 구현 → PR → 리뷰 → 자동 수정 → 이슈에 결과 댓글
archon-issue-review-full
- 조사 → 구현 → 5개 에이전트 종합 리뷰 → 리뷰 수정 → 최종 요약
fix-github-issue보다 리뷰에 더 집중한 버전
archon-create-issue
- 문제 영역 분류 → 컨텍스트 수집 → 코드 조사 → 실제로 버그 재현 → 재현 성공해야 이슈 생성
- 재현 실패 시 이슈를 만들지 않고 그 사실을 보고 (증거 기반 이슈)
archon-resolve-conflicts
- 최신 base 브랜치 fetch → 충돌 분석 → 간단한 건 자동 해결 → 커밋·푸시
- 복잡한 충돌은 선택지를 제시
📐 5. 설계 / 리팩터링 (코드 건강)
archon-architect
- 코드베이스 지표 측정 → 아키텍처 분석 → 단순화 계획 → 자가 검토 루프(hooks)로 실행 → 검증 → PR
- 파일 크기·의존성·함수 길이 등 핫스팟을 찾아 복잡도 감소
- 매 편집 후 자동 type-check를 강제하는 hook이 특징
archon-refactor-safely
- 범위 스캔 → 읽기 전용 영향 분석 → 순서대로 작업 계획 → 편집마다 type-check hook → 전체 검증 → 동작 보존 확인 → PR
- 분석/검증 단계는 읽기 전용이라 안전, 동작이 바뀌지 않았는지 확인
📝 6. 기획 / 대화형 (사람이 개입)
archon-interactive-prd
- 가이드 대화를 통해 PRD(제품 요구사항 문서) 작성
- 3개의 승인 게이트: 기초 질문 → 심화 질문 → 범위 질문
- 단계마다 사용자가 답하고, 마지막에 코드베이스 대조 검증
archon-piv-loop
- 탐색(Explore) → 계획(Plan) → 구현(Implement) → 검증(Validate)을 사람과 함께 반복
- 탐색 단계에서 4~6개 질문, 계획 승인 게이트, 검증 단계에서 사람 피드백 반영
🔁 7. 고급 / 실험적 루프
archon-adversarial-dev
- 세 역할이 대결하며 앱을 처음부터 구축 (GAN 영감)
- Planner(스펙·스프린트 작성) → Generator(코드 생성) ↔ Evaluator(코드 공격·점수 매김)
- 평가자는 소스 수정 불가, 테스트만 가능. 7/10 점수 기준 통과/실패 (최대 60회 반복)
archon-ralph-dag
- 입력(prd.json / prd.md / 아이디어) 감지 → 필요시 PRD 생성 → 검증 → Ralph 루프(스토리 하나씩 구현·테스트·커밋) → PR
- 매 반복마다 fresh context로 스토리를 하나씩 완성
🎬 8. 특수 목적
archon-remotion-generate
- Remotion(React 기반 영상) 코드 작성 → 미리보기 스틸 3장 렌더 → 전체 MP4 렌더 → 요약
useCurrentFrame(),interpolate(),spring()등 애니메이션 활용
archon-workflow-builder 🛠️
- 코드베이스 스캔 → 의도 추출(JSON) → YAML 생성 → 검증 →
.archon/workflows/에 저장 - “나만의 워크플로우”를 자동으로 생성
archon-test-loop-dag
- 카운터를 3까지 올리는 단순 루프 — DAG 안의 loop 노드 동작 확인용 예제/테스트
🗂️ 한눈에 보기
| 분류 | 워크플로우 | 한 줄 요약 |
|---|---|---|
| 기본 | archon-assist | 만능 도우미 (질문·디버깅·탐색) |
| 개발 | archon-idea-to-pr | 아이디어 → PR (5에이전트 리뷰) |
archon-plan-to-pr | 계획 → PR | |
archon-feature-development | 계획 구현 + PR | |
| 리뷰 | archon-comprehensive-pr-review | 종합 PR 리뷰 (항상 5에이전트) |
archon-smart-pr-review | 적응형 리뷰 (필요한 것만) | |
archon-validate-pr | 버그 재현 기반 검증 | |
| 이슈 | archon-fix-github-issue | 이슈 해결 풀 파이프라인 |
archon-issue-review-full | 이슈 + 종합 리뷰 | |
archon-create-issue | 재현 기반 버그 이슈 등록 | |
archon-resolve-conflicts | 머지 충돌 해결 | |
| 설계 | archon-architect | 아키텍처 정비 |
archon-refactor-safely | 안전한 리팩터링 | |
| 기획 | archon-interactive-prd | 대화형 PRD 작성 |
archon-piv-loop | Plan-Implement-Validate 루프 | |
| 고급 | archon-adversarial-dev | 적대적(GAN) 개발 |
archon-ralph-dag | 스토리 단위 자동 구현 | |
| 특수 | archon-remotion-generate | AI 영상 생성 |
archon-workflow-builder | 워크플로우 자동 생성 | |
archon-test-loop-dag | 루프 테스트 예제 |
💡 추천 시작점
처음 쓴다면 다음 세 가지부터:
archon-assist— 아무 질문이나archon-idea-to-pr— 기능 개발archon-smart-pr-review— 코드 리뷰
참고: 워크플로우의 구성 요소
- 노드 타입:
prompt(인라인 프롬프트),command(명령 파일),bash(셸 스크립트),script(TS/Python),loop(반복 AI 프롬프트),approval(사람 승인 게이트) - DAG 구조:
depends_on엣지로 노드 연결, 같은 단계의 독립 노드는 병렬 실행 - 격리: 기본적으로 git worktree 자동 생성 (
--no-worktree로 해제 가능) - provider:
.archon/config.yaml에서 상속, 워크플로우/노드별로provider·model재정의 가능 - 워크플로우 정의 위치:
.archon/workflows/defaults/*.yaml(기본),.archon/workflows/*.yaml(프로젝트),~/.archon/workflows/*.yaml(전역)
관련 노트
- 2026-04-30-archon-harness-builder — Archon 도구 개요·아키텍처·노드 타입(YAML 워크플로우 빌더). 이 카탈로그의 상위 노트.
- 2026-03-21-gstack — Garry Tan의 Claude Code 기획·리뷰·QA·배포 시스템. 유사한 단계형 코딩 워크플로우.
- 2026-03-29-ai-agent-debate-pattern —
archon-adversarial-dev(Planner↔Generator↔Evaluator)의 기반인 멀티 에이전트 토론·대결 패턴. - harness · codex — Archon이 구동하는 코딩 하네스·백엔드.
- moc-ai-agents-orchestration — MOC: 오케스트레이션 & 워크플로우.