ArchonはYAMLワークフローでAIコーディングの手順を固定する

AIコーディングエージェント向けYAMLワークフロー

ArchonはAIコーディングエージェント向けのワークフローエンジンです。開発プロセスはYAMLワークフローとして定義され、計画、実装、検証、コードレビュー、プルリクエスト作成の各段階をノードにできます。ワークフローエンジンはプロジェクトをまたいで同じ順序を実行し、AIは各ステップで知性を補完しますが、構造は決定論的でユーザーが制御します。リポジトリの説明は、これをAIコーディングのための最初のオープンソースのハーネスビルダーと呼び、AIコーディングを決定論的かつ反復可能にすることを目的としています。READMEではハーネスという用語をこれ以上定義していません。

プロセスをエンコードする理由：エージェントに任せない

READMEの根拠は具体的な問題から始まります。AIエージェントにバグ修正を頼むと、実行ごとに異なる振る舞いになることがあります。計画を飛ばしたり、テストを忘れたり、PRテンプレートを無視したりするかもしれません。Archonはプロセスをフェーズ、検証ゲート、成果物を持つワークフローにすることでこれに対処します。AIはノード内の行動を決めますが、順序とゲートは固定されています。READMEは5つの特性を挙げています。反復可能、隔離（各実行は独自のgit worktreeを持つ）、実行して放置、合成可能（bashスクリプトやテストなどの決定論的ノードとAIノードを混在）、移植可能（ワークフローは.archon/workflows/に置き、CLI、Web UI、Slack、Telegram、GitHubから実行）です。

ワークフロー例：計画、実装、検証、承認、PR

READMEはbuild-feature.yamlというYAMLワークフローを示しています。計画ノード、すべてのタスクが完了するまでループする実装、bashコマンドでテストを実行、変更のレビュー、対話的な承認ゲート、プルリクエスト作成が含まれます。ループノードにはfresh_contextフラグがあり、各反復は新しいセッションで始まります。承認ノードは人間の入力を待って一時停止します。例では決定論的テストコマンドとしてbun run validateを使います。これはワークフローで示されている唯一のコマンドであり、他のワークフローがどの検証を使うかはREADMEには書かれていません。

2つのセットアップ方法：フルセットアップとクイックインストール

2つのインストール経路が文書化されています。フルセットアップにはBun、Claude Code、GitHub CLIが必要です。git clone、リポジトリへのcd、bun install、そしてclaudeの順に進め、ユーザーはClaude CodeにArchonをセットアップするよう指示します。セットアップウィザードは認証情報、プラットフォーム統合を設定し、Archonスキルを対象プロジェクトにコピーします。クイックインストールはすでにClaude Codeを持っているユーザー向けです。macOSとLinuxではcurlスクリプト、WindowsではPowerShellスクリプト、Homebrewフォーミュラがあります。クイックインストールのバイナリにはClaude Codeがバンドルされていないため、CLAUDE_BIN_PATH環境変数または~/.archon/config.yamlのassistants.claude.claudeBinaryPath設定が必要です。READMEはまた、x64クイックインストールにはAVX2サポートが必要で、古いCPUはソースインストールガイドを使うべきだと述べています。

Webダッシュボードとオプションのチャットプラットフォーム

Webダッシュボードには、リアルタイムストリーミングとツール呼び出しの可視化を備えたチャットページ、実行中のワークフローを監視しプロジェクト・ステータス・日付で履歴をフィルタできるダッシュボード、ループノードを持つDAGワークフローを作成するビジュアルなドラッグ＆ドロップワークフロービルダー、実行中または完了したワークフローのステップバイステップの進行状況を表示するワークフロー実行ビューが含まれます。サイドバーにはWebだけでなく、Slack、Telegram、GitHubなどすべてのプラットフォームの会話が表示されます。READMEにはオプションのプラットフォームアダプタの設定時間が記載されています。Telegramは5分、Slackは15分、GitHub Webhooksは15分、Discordは5分です。CLIとWeb UIはこれらのアダプタなしで動作します。

19のデフォルトワークフローとカスタムYAML

Archonには19のデフォルトワークフローが含まれています。テーブルには、GitHub issueの修正、issueの作成、PRのレビュー、機能の構築、PRDの生成、コンフリクト解決、Remotionビデオ構成の生成などのタスクがリストされています。READMEでは、archon workflow listを実行するか、タスクを説明するとルーターが選択するとあります。カスタムワークフローは.archon/workflows/内のYAMLファイル、コマンドは.archon/commands/内のマークダウンファイルです。ユーザーのリポジトリにある同じ名前のファイルはバンドルされたデフォルトを上書きするため、チームは同じプロセスをコミットできます。

アーキテクチャとストレージ

アーキテクチャ図では、最上位にプラットフォームアダプタ、中央にメッセージルーティングとコンテキスト管理を行うオーケストレータ、その下にスラッシュコマンドを処理するコマンドハンドラ、YAMLを実行するワークフロー実行器、Claude、Codex、Pi用のAIアシスタントクライアントがあります。データはSQLiteまたはPostgreSQLに保存され、14のコアテーブルがコードベース、会話、セッション、ワークフロー実行、隔離環境、メッセージ、ワークフローイベント、ユーザー、関連設定をカバーします。READMEにはパフォーマンスベンチマークやスケーリングの数値はありません。

テレメトリとライセンス

テレメトリはオプションで、CI環境ではデフォルトで無効です。archon_started、workflow_invoked、workflow_completed、chat_turn_handledなどの匿名イベントを送信し、バンドルされたワークフローのワークフロー名（カスタムワークフローはcustomとラベル付け）、実行結果、ノードタイプ、プロバイダIDとモデルID、期間、トークン数、コストなどのカテゴリデータを含みます。READMEは、コード、プロンプト、メッセージ、カスタムワークフロー名、gitリモート、ファイルパス、ユーザー名、トークン、AI出力、エラーテキスト、IPアドレス、地理的位置は収集しないと述べています。無効化はARCHON_TELEMETRY_DISABLED、DO_NOT_TRACK、またはPOSTHOG_API_KEY=offで可能です。MITライセンスは、使用、コピー、変更、マージ、公開、配布、サブライセンス、販売の権利を許可し、ソフトウェアは保証なしで現状のまま提供されると述べています。

編集部の結論

ArchonはAIコーディングの工程をYAMLで再利用したい開発者に向きます。フルセットアップとクイックインストールの差、19個の標準ワークフロー、Webダッシュボードの保存先を先に確認してください。READMEには性能測定とセキュリティ保証がないため、最初に自分のリポジトリで承認前後の生成物を確認する必要があります。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes