Archon完全ガイド：AIコーディングエージェントをYAMLで制御するハーネスビルダー

Archon完全ガイド：AIコーディングエージェントをYAMLで制御するハーネスビルダー

published: 2026/07/23 · updated: 2026/07/23

「AIにバグ修正を頼んだら、テストを飛ばして勝手にリファクタリングされた」「同じプロンプトを打っても毎回違う結果が返ってくる」——そんな体験、ありませんか？

Claude CodeやCodexのようなAIコーディングエージェントは確かに優秀ですが、何をどの順番でやるかは毎回モデルの「気分」次第です。計画をスキップすることもあれば、テストを忘れることも、PRの説明文がテンプレートを無視したものになることもあります。

この記事では、そのバラつきを根絶するOSSツール「Archon（アーコン）」を紹介します。読み終わる頃には「自分がArchonを使うべきかどうか」を判断できるだけの情報がそろいます。

この記事でわかること：

  • Archonが何をするツールなのか（仕組みより「何ができるか」を先に）
  • インストールから最初のワークフロー実行まで
  • OpenHandsやLangChain、Continueとの違い
  • 向いている人・向いていない人

---

Archonで「何ができるようになるか」

一言でいえば、AIコーディングエージェントの動きをレールの上に乗せられるようになります。

<cite index="6-1,6-2">Archonは、AIコーディングエージェントのためのワークフローエンジンです。計画・実装・バリデーション・コードレビュー・PR作成といった開発プロセスを、YAMLワークフローとして定義し、すべてのプロジェクトで安定して実行できます。</cite>

具体的には、たとえば次のようなことが自動化できます：

  • 「アイデア → PRまで」を毎回同じ手順で実行する
  • バグ修正のたびに型チェック・テスト・リントを必ずセットで走らせる
  • PRの説明文を決まったテンプレートで統一する
  • 複数のタスクを並列で走らせる（Gitのワークツリー分離で競合なし）

<cite index="2-6">ある報告では、ハーネスなしのLLMコードはPRの受け入れ率が6.7%に留まるが、適切に設計されたハーネスを使うと約70%まで跳ね上がったとされています。</cite> 唯一の違いはハーネスを使ったかどうか、という点が印象的です。

---

Archonの仕組み：「ハーネス」ってなに？

馬に乗るときに使う「馬具（ハーネス）」を思い浮かべてください。馬（AI）は優秀でも、ハーネスなしでは好き勝手に走ります。ハーネスをつけることで、人が決めたコースを安全に走らせられる——Archonはまさにそれです。

<cite index="5-12,5-13">ハーネスビルダーとは、任意のプロセスを包む実行ラッパーを構築するためのツールです。Archonの場合、包まれるプロセスはClaudeやGPT、オープンソースモデルなど、任意のAIエージェントです。</cite>

YAMLワークフローとは

YAML（ヤムル）とは、人間が読みやすい設定ファイルの書き方です。難しい話ではなく、「まず計画を立てる→次にコードを書く→テストを実行する→PRを作る」という手順を文字で書いたものだと思ってください。

<cite index="4-2,4-3">Archonは開発プロセスを「YAMLで書いたDAG（有向非巡回グラフ）」として定義します。DAGとは、ステップを明示的な順序で並べたシーケンスのことです。各ワークフローは独立したGitワークツリーで実行されるため、複数のエージェントが同じリポジトリで作業してもマージ競合が起きません。</cite>

<cite index="6-16,6-17">ワークフローはフェーズ・バリデーションゲート・成果物を定義します。AIは各ステップで知性を発揮しますが、構造は決定論的で、あなたの管理下に置かれています。</cite>

ワークフローを構成する4種類のノード

<cite index="18-7,18-8">Archonのコア抽象は「ワークフロー」であり、YAML定義のDAGは4種類のノードを組み合わせます。そのひとつがAIノードで、Claude CodeやCodexなどのLLMを呼び出すプロンプトベースのタスクです。</cite>他に、bashスクリプトやリンターを実行する「シェルノード」、人間の承認を待つ「ゲートノード」、ループ処理を制御する「ループノード」があります。

<cite index="11-6">Archonは、確定的なステップ（bash/スクリプト）とAIエージェント（Claude Code SDK・Codex SDKなど）を組み合わせたマルチステップワークフローを実行し、人間の承認ゲートと完全な監査ログを持ちます。SlackやTelegram、GitHub、Discord、WebUI、CLIからリモートで操作できます。</cite>

---

Archonの主要機能まとめ

機能詳細
YAMLワークフロー計画・実装・テスト・レビュー・PRを定義ファイルで管理
デフォルトワークフローすぐ使えるテンプレートが19本付属（公式READMEより）
Gitワークツリー分離タスクごとに独立した環境で実行、コンフリクトなし
マルチモデル対応Claude Code・Codex・Ollama（ローカル）など切替可能
Web UI + CLIブラウザのダッシュボードとターミナルの両方に対応
チャット連携Slack・Telegram・Discord・GitHubからワークフロー起動
ワークフローマーケットコミュニティ製YAMLを検索・インストールできる
MITライセンス完全オープンソース・商用利用も無料

<cite index="37-4">Archonには19本のデフォルトワークフローが同梱されており、archon workflow listで一覧表示できるほか、やりたいことを説明するとルーターが適切なワークフローを自動選択してくれます。</cite>

<cite index="5-16,5-17">ArchonはClaude（Anthropic）、GPT-4（OpenAI）、OllamaなどのAPIでアクセスできるオープンソースモデルを含む、標準APIで利用可能な任意のモデルをサポートしています。モデルの選択はワークフローYAML内で設定でき、同一ワークフロー内の異なるエージェントに異なるモデルを使うことも可能です。</cite>

---

インストールと最初のワークフロー実行

前提条件

<cite index="15-6">インストールに必要なのは「Bun（JavaScriptランタイム）」「Claude Code」「GitHub CLI」の3つです。</cite>順番にインストールしましょう。

Bun（バン：高速なJavaScriptランタイム）のインストール

# macOS / Linux
curl -fsSL https://bun.sh/install | bash

# Windows（PowerShell）
irm bun.sh/install.ps1 | iex

GitHub CLI（ghコマンド）のインストール

# macOS
brew install gh

# Windows（winget経由）
winget install GitHub.cli

# Ubuntu / Debian系Linux
sudo apt install gh

Claude Code（AIコーディングエージェント本体）のインストール

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows（PowerShell）
irm https://claude.ai/install.ps1 | iex

Claude Codeの料金・利用条件についてはClaude Code (MCPサーバーとして)の解説ページも参考にしてください。

Archon本体のインストール（クイック版・30秒）

<cite index="27-3,27-4,27-5">すでにClaude Codeをセットアップ済みであれば、スタンドアロンCLIバイナリをインストールするだけです。macOS/Linuxの場合は次のコマンドを実行します。</cite>

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

# Windows（PowerShell）
irm https://archon.diy/install.ps1 | iex

# Homebrewの場合
brew install coleam00/archon/archon

インストール後の確認

archon --version
archon workflow list

ソースからインストールする場合（フルセットアップ）

<cite index="15-4,15-5">リポジトリをクローンし、セットアップウィザードを使う方法もあります。ウィザードは認証情報の設定・プラットフォーム連携の構成・Archonスキルの対象プロジェクトへのコピーを行います。</cite>

git clone https://github.com/coleam00/Archon
cd Archon
bun install
claude  # ← セットアップウィザードが起動します

最初のワークフローを動かしてみる

プロジェクトのルートディレクトリで、Claude Codeに話しかけるだけです。

# Claude Codeのチャット画面で
Use archon to add dark mode to the settings page

# または直接CLIから
archon workflow run archon-idea-to-pr "設定ページにダークモードを追加したい"

<cite index="24-2,24-3,24-4,24-5">デフォルトのワークフローは.archon/workflows/defaults/からコピーしてカスタマイズできます。ワークフローはYAMLファイル（.archon/workflows/）、コマンドはMarkdownファイル（.archon/commands/）です。同名のファイルをリポジトリに置けばデフォルトを上書きでき、コミットすればチーム全員が同じプロセスで動きます。</cite>

Web UIでのモニタリング

<cite index="12-3">Archonにはコーディングエージェントとチャットしたり、ワークフローを実行したり、進捗を監視したりするためのWebダッシュボードが含まれています。</cite>

archon serve  # Web UIを起動

<cite index="38-1,38-2">サイドバーにはWebだけでなく、CLI・Slack・Telegram・GitHubなどすべてのプラットフォームからのやり取りが一覧表示されます。</cite>

---

類似ツールとの違い：どれを選ぶべきか

Archonは「AIコーディングエージェントを制御する層」にあるユニークなポジションです。よく比較される類似ツールと整理しましょう。

ツールカテゴリArchonとの関係
Claude CodeAIコーディングエージェントArchonが制御・呼び出す対象
Codex CLIAIコーディングエージェントArchonが制御・呼び出す対象
Gemini CLIAIコーディングエージェントArchonから呼び出し可能
OpenCodeAIコーディングエージェントArchonから呼び出し可能
OpenHands自律型コーディングエージェント自律的に動く。Archonは「制御層」
ContinueIDE拡張（コーディング補助）エディタ内のアシスタント。層が異なる
LangChainLLMオーケストレーション基盤Python/JS向け汎用フレームワーク
FlowiseノーコードLLMワークフローGUI操作。コーディング特化でない

Archon vs OpenHands

<cite index="30-5,30-6">OpenHandsはDevinコンセプトのオープンソース版の系譜を汲むツールで、PythonSDK・CLI・デスクトップGUI・クラウドプラットフォームの4つのインターフェイスを提供します。</cite>OpenHandsは「自分でGitHubのIssueを解決するまで自律的に動く」エージェントです。一方Archonは、Claude CodeやCodexなどの既存エージェントをあなたが定義した手順で動かす制御層です。「エージェントに任せたい」ならOpenHands、「エージェントを手順通りに動かしたい」ならArchonと考えてください。

Archon vs LangChain

<cite index="28-1,28-2,28-3">LangChainはグラフベースのアーキテクチャを採用した汎用エージェントフレームワークで、各ノードがプロンプトやサブタスクを処理し、エッジがデータフローと遷移を制御します。複雑なマルチステップタスクで細かい分岐やエラーハンドリングが必要な場合に向いています。</cite>LangChainは「AIアプリをゼロから作る」ためのフレームワークで、Pythonコードを書く必要があります。Archonは「今使っているClaude Codeの動きを整える」のが目的で、YAMLを書くだけです。

Archon vs Flowise / n8n

FlowiseはノーコードでLLMワークフローをGUIで組める優れたツールですが、コーディング特化ではなく汎用のLLMパイプライン向けです。Archonは「ソフトウェア開発の工程そのもの」に特化しており、Gitワークツリーの管理やPR作成など、開発固有の機能が組み込まれています。

---

こんな人に向く・向かない

✅ Archonが向いている人

  • Claude CodeやCodexをすでに使っていて、毎回の出力のバラつきに困っている
  • 同じ手順（計画→実装→テスト→PR）を毎回同じように自動化したい
  • チームで開発していて、「AIが何をしたか」の監査ログや一貫性を重視する
  • YAMLを書くことに抵抗がない（ExcelのVBAより簡単なレベル）
  • 完全無料・自社サーバー管理で使いたい
  • 複数プロジェクトで同じワークフローを使い回したい

❌ Archonが向いていない人

  • まだClaude CodeやCodexを使っていない（まず本体を使いこなすことを優先しましょう）
  • コードを一行も書かず、会話だけでアプリを作りたい（FlowiseやLibreChatが向いているかもしれません）
  • GUIのみで操作したい（ArchonはCLIとWeb UIの両方ありますが、設定にはある程度のターミナル操作が必要です）
  • 小規模な「1回限り」のタスクにAIを使いたいだけ（ワークフロー管理はオーバースペックになります）
  • 完全にコードを書かないワークフロー自動化が目的（Browser UseやAwesome LLM Appsで別のアプローチを探してみてください）

---

Archonの背景：どこから来たツールか

<cite index="18-1,18-2">2026年4月7日、Cole Medin氏（GitHub: coleam00）が完全な書き直しを発表しました。Pythonベースのコードベースはアーカイブされ、ArchonはTypeScriptによるAIコーディングエージェント向けワークフローエンジンとして生まれ変わりました。コンセプトも「エージェントを作るエージェント」から「エージェントを信頼できるものにするハーネス」へとシフトしています。</cite>

<cite index="8-4">GitHubスター数は急速に伸び、注目を集めています（AgentConn調べ、2026年4月時点）。</cite>Hacker Newsのフロントページにも登場し、AI開発コミュニティで大きな話題となりました。

ArchonはMITライセンスのオープンソースソフトウェアであり、ツール本体は無料で使えます。ただし内部でClaude CodeやOpenAI Codexを呼び出すため、それらのAPIや利用料が別途かかる点には注意が必要です（各ツールの公式サイトで料金を確認してください）。

---

よくある質問

Q. Archonを使うのにプログラミングの知識は必要ですか？

YAMLの読み書き、ターミナルへのコマンド入力ができれば基本的な導入は可能です。ただし、デフォルトのワークフローをカスタマイズしたり、独自の手順を定義したりするには、GitやCLIツールの基礎知識があると圧倒的にスムーズです。「コードは書けないがターミナルは触れる」というレベルなら、デフォルトワークフローを使うだけでも十分な価値があります。

Q. Claude Code以外のAIエージェントでも使えますか？

はい。<cite index="5-16">ArchonはClaude（Anthropic）、GPT-4（OpenAI）、OllamaなどのAPI経由で使えるオープンソースモデルなど、標準APIでアクセスできる任意のモデルをサポートしています。</cite>同じワークフロー内の異なるステップで、異なるモデルを使い分けることも可能です。たとえば「計画はClaude、コーディングはCodex」といった使い方ができます。

Q. 旧バージョンのArchon（Python版）とは別物ですか？

<cite index="20-3,20-4,20-5">以前のPythonベースのArchon（タスク管理＋RAGツール）はアーカイブされています。コードベースはarchive/v1-task-management-ragブランチで保存されており、削除はされていません。</cite>現在のArchonはTypeScript製のまったく別のツールで、同じ名前・同じリポジトリを引き継いでいます。旧版を使っていた方は、新版は仕組みが根本的に異なるため、改めて導入手順をたどる必要があります。

Q. ワークフローのテンプレートはどこで入手できますか？

<cite index="10-1">Archonはワークフローマーケットプレイスを持っており、コミュニティが作成したYAMLワークフローをブラウズ・インストール・実行できます。</cite>また、<cite index="24-2">本体に同梱されているデフォルトワークフローを.archon/workflows/defaults/からコピーして独自にカスタマイズするのが最も手軽なスタート方法です。</cite>公式ドキュメントは archon.diy で公開されています（公式サイト参照）。

---

まとめ：Archonで「AIの気まぐれ」を卒業しよう

Archonは、AIコーディングエージェントを「道具として使いこなす」ための次のステップです。

<cite index="15-20,15-21">ワークフローはフェーズ・バリデーションゲート・成果物を定義します。AIは各ステップで知性を発揮しますが、構造はあなたが所有する決定論的なものです。</cite>これこそが、Archonの本質です。

次のアクション：

  1. まずClaude Codeがまだなら → Claude Code (MCPサーバーとして)でセットアップ
  2. AIコーディングエージェントの全体像を把握したいなら → Codex CLI・Gemini CLI・OpenCodeも比較検討
  3. Archonのインストールは → curl -fsSL https://archon.diy/install | bash
  4. まずデフォルトワークフローを試す → archon workflow list
  5. ワークフローを応用例で学びたいなら → Awesome LLM Appsで関連プロジェクトも参考に

Archonのリポジトリ（github.com/coleam00/Archon）はMITライセンスで公開されています。スターをつけてウォッチしておくと、マーケットプレイスの新ワークフロー追加やアップデートをいち早くキャッチできます。