AIコーディングを「運任せ」から「手順書どおり」に変える！YAMLワークフローエンジン — Archon

アーキテクチャ

Archonはプラットフォームアダプター層、オーケストレーター、実行エンジンの3層構造で構成されています。

• プラットフォームアダプター: Web UI、CLI、Telegram、Slack、Discord、GitHub Webhooksに対応
• オーケストレーター: メッセージルーティングとコンテキスト管理を担当
• 実行エンジン: コマンドハンドラー（スラッシュコマンド）、ワークフローエグゼキューター（YAML解釈・実行）、AIアシスタントクライアント（Claude / Codex）

データベース

SQLiteまたはPostgreSQLに対応。7つのテーブル構成:

• Codebases、Conversations、Sessions、Workflow Runs、Isolation Environments、Messages、Workflow Events

ワークフローの仕組み

• DAG（有向非巡回グラフ）ベース: ノード間の依存関係を depends_on で定義
• ノードタイプ: AIノード（prompt指定）と決定論的ノード（bashコマンド）を組み合わせ可能
• ループノード: loop + until 条件でテストが通るまで繰り返し実行
• 人間承認ゲート: interactive: true でワークフロー途中に人間の確認を挟める
• フレッシュコンテキスト: fresh_context: true で各イテレーションごとにAIセッションをリセット

分離環境

各ワークフロー実行は独自のgitワークツリー（worktree）で動作。複数のタスクを同時並行で実行しても互いに干渉しません。

デフォルトワークフロー（17種類）

主な例:

• archon-fix-github-issue: Issue分類→調査→実装→検証→PR→レビュー→自動修正
• archon-idea-to-pr: アイデア→計画→実装→検証→PR→5並列レビュー→自動修正
• archon-smart-pr-review: PR複雑度分類→対象別レビューエージェント→統合レポート
• archon-resolve-conflicts: マージコンフリクト検出→両側分析→解決→検証→コミット
• archon-architect: アーキテクチャ全体の品質改善・複雑度削減

カスタマイズ

• ワークフロー: .archon/workflows/ にYAMLファイルを配置
• コマンド: .archon/commands/ にMarkdownファイルを配置
• デフォルトと同名のファイルを置くとオーバーライド可能
• リポジトリにコミットすればチーム全体で共有される

Web UI機能

• Chat: リアルタイムストリーミングとツールコール可視化
• Dashboard: 実行中ワークフローのモニタリング（プロジェクト・ステータス・日付でフィルタリング）
• Workflow Builder: ドラッグ&ドロップでDAGワークフローを視覚的に作成
• Workflow Execution: ステップごとの進捗ビュー
• サイドバーで全プラットフォーム（CLI、Slack、Telegram等）の会話を一元管理

対応AIアシスタント

• Claude Code
• OpenAI Codex

デプロイメント

• Docker対応
• VPS・本番環境向けセットアップガイドあり
• archon serve コマンドでWeb UIを起動可能

ライセンス

MITライセンス（商用利用を含む自由な利用が可能）

技術スタック

• ランタイム: Bun（JavaScriptランタイム）
• ワークフロー定義: YAML
• コマンド定義: Markdown
• テスト: GitHub Actions CI
• ドキュメント: https://archon.diy

フルセットアップ（約5分）

前提条件: Bun、Claude Code、GitHub CLIが必要です。

# Bunのインストール（macOS/Linux）
curl -fsSL https://bun.sh/install | bash

# GitHub CLIのインストール（macOS）
brew install gh

# Claude Codeのインストール
curl -fsSL https://claude.ai/install.sh | bash

Archonのセットアップ:

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

Claude Codeが起動したら「Set up Archon」と入力するとセットアップウィザードが始まります。

クイックインストール（約30秒）

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

# Homebrew
brew install coleam00/archon/archon

# Windows (PowerShell)
irm https://archon.diy/install.ps1 | iex

使い方

cd /path/to/your/project
claude
# 「Use archon to fix issue #42」と入力