Archon とは？AI コーディングを再現可能にするワークフローエンジンの使い方

Archon とは

Archon は、AI コーディングエージェントの実行結果を再現可能かつ決定論的にするオープンソースのワークフローエンジンです。開発プロセスを YAML ワークフローとして定義し、計画・実装・テスト・レビュー・PR 作成といった段階を自動化します。

GitHub リポジトリ（2026年10月5日時点で累計⭐23,622）では、Archon を「インフラストラクチャの Docker ファイルや CI/CD の GitHub Actions のように、AI コーディングワークフロー向けの標準化ツール」と位置づけています。

通常、AI エージェントに「このバグを修正して」と指示すると、実行するたびに異なる結果が返ります。計画をスキップしたり、テストを忘れたり、PR テンプレートを無視したりする可能性があります。Archon はこの問題を、開発プロセスを事前に構造化することで解決します。

主な特徴

再現可能なワークフロー実行

Archon で定義したワークフローは、毎回同じ順序と同じ検証ゲートで実行されます。AI が各ステップで判断を下しますが、全体の流れはあなたが管理するため、ばらつきがなくなります。

分離された実行環境

ワークフローの実行ごとに独立した Git ワークツリーが作成されるため、複数のタスクを並行実行しても競合が起きません。

ノードの組み合わせ

AI ノード（計画、コード生成、レビュー）と決定論的ノード（bash スクリプト、テスト実行、Git 操作）を自由に組み合わせられます。AI が価値を追加する部分のみに集中できます。

複数のプラットフォーム対応

ワークフローは .archon/workflows/ に YAML として保存され、Git リポジトリに直接コミットできます。CLI、Web UI、Slack、Telegram、GitHub など複数のインターフェースで同じワークフローを実行できます。

ワークフロー定義の例

Archon のワークフローは以下のような 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

  - id: run-tests
    depends_on: [implement]
    bash: "bun run validate"

  - 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"

このワークフローでは、計画 → 実装ループ（テストが通るまで反復） → テスト実行 → レビュー → 人間による承認 → PR 作成という流れが自動化されます。

料金・ライセンス

Archon はMIT ライセンスで公開されており、無料で利用できます。商用利用も可能です。ただし Claude Code（Anthropic の AI コーディングツール）と組み合わせて使用するため、Claude Code の利用に関する規約を確認してください。

導入方法

クイックインストール（推奨）

macOS / Linux

curl -fsSL https://archon.diy/install | bash

Windows (PowerShell)

irm https://archon.diy/install.ps1 | iex

Homebrew (macOS / Linux)

brew install coleam00/archon/archon

フルセットアップ（5分、推奨）

GitHub リポジトリをクローンしてセットアップウィザードを実行することで、認証情報、プラットフォーム統合、Archon スキルのインストールが自動化されます。

前提条件：

Bun（bun.sh↗）
GitHub CLI（cli.github.com↗）
Claude Code（claude.ai/code↗）

セットアップ手順：

git clone https://github.com/coleam00/Archon
cd Archon
bun install
claude

設定ウィザードが起動され、CLI インストール、認証、プラットフォーム選択、対象リポジトリへの Archon スキルコピーが実行されます。

詳細は GitHub README↗ と公式ドキュメント↗を参照してください。

活用シーン

バグ修正の自動化

「このバグを修正して」という指示に対し、Archon ワークフローが計画から PR 作成まで自動化します。テスト実行やコードレビューのステップが必ず実行され、品質が担保されます。

機能追加の実装管理

複数のタスクを計画段階でリスト化し、各タスクを実装→テスト→レビューのループで進めることで、漏れなく実装できます。

並行タスク処理

分離されたワークツリーにより、複数のワークフローを同時に実行してもコード競合が発生しません。

開発プロセスの標準化

ワークフローをリポジトリに保存するため、チーム全体が同じプロセスを守ることができます。

デメリット・注意点

Claude Code への依存

Archon 単体では動作せず、Claude Code（Anthropic の AI コーディングツール）が必須です。そのため、Anthropic の API 利用に関する規約と料金体系を確認する必要があります。

YAML ワークフロー定義の学習コスト

ワークフローを効果的に設計するには、Archon の概念（ノード、ループ、依存関係、AI ノードと決定論的ノードの使い分け）を理解する必要があります。

x64 CPU の AVX2 対応要件

クイックインストール（macOS/Linux）は、x64 CPU の AVX2 対応を前提としています。古い Intel/AMD CPU や AVX2 をマスクされた仮想マシン環境では、ソースからのインストールが必要です。ARM64 環境は対象外です。

ワークツリーのディスク容量

ワークフロー実行ごとに Git ワークツリーが作成されるため、大規模プロジェクトで複数の並行実行を行う場合はディスク容量を確認してください。

よくある質問

Archon と n8n の違いは何ですか？

Archon は「AI コーディングワークフロー専用」のツールであり、計画→実装→テスト→レビュー→PR といった開発プロセスに特化しています。一方 n8n は「業務プロセス全般の自動化」向けの汎用ワークフローエンジンで、より幅広い用途に対応しています。

Archon だけで AI コーディングが完結しますか？

Archon はワークフローの「構造」を定義するツールであり、AI の判断自体は Claude Code によるものです。Archon は「どの順序で何を実行するか」を管理し、AI は「各ステップで何をするか」を決定します。

既存のプロジェクトに導入できますか？

はい、新規、既存プロジェクト両方に対応しています。フルセットアップウィザードで対象プロジェクトを指定すると、Archon スキルがコピーされます。

Windows でも使えますか？

はい、PowerShell 用のインストールスクリプトが提供されており、Windows での利用をサポートしています。

まとめ

Archon は、AI エージェントによるコーディングを「再現可能で管理可能」にするワークフローエンジンです。開発プロセスを YAML で定義することで、毎回同じ品質で自動化できます。

Claude Code の導入とセットで、計画から PR 作成までの開発サイクルを大幅に短縮できる可能性があります。一方、Claude Code への依存やワークフロー設計の学習コストを考慮した上で導入を判断してください。

詳細は GitHub リポジトリ↗、公式ドキュメント↗、リリースノート↗を参照してください。