coleam00/Archon

The first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.

Archon – 決定的な AI コーディングワークフロー

概要 – Archon は、AI 支援ソフトウェア開発タスク（バグ修正、機能実装、コードレビュー、PR 作成など）を再現可能で分離された、構成可能な方法でオーケストレーションできるオープンソースのワークフローエンジンです。開発プロセスを YAML ワークフローとして記述します。Archon はステップを実行し、インテリジェンスが必要な場所でのみ LLM を呼び出し、残り（bash スクリプト、テスト、Git 操作）は決定的に保ちます。

主要なアイデア

決定的な実行 – 同じワークフローは常に同じシーケンスに従い、「モデルの気分」問題を排除します。
分離 – 各実行には独自の Git ワークツリーがあり、競合なしで並列実行が可能です。
ヒューマンインザループ – ループは承認やフィードバックのために一時停止でき、AI と手動ステップを混在させます。
移植性 – ワークフローはプロジェクトの .archon/workflows/ フォルダに存在し、CLI、Web UI、またはチャットプラットフォーム（Slack、Telegram、Discord、GitHub webhooks）からトリガーできます。

典型的なワークフロー（簡略化）：

nodes:
  - id: plan        # AI が計画を生成
    prompt: "Explore the codebase and create an implementation plan"
  - id: implement   # AI がタスクが完了するまで反復
    depends_on: [plan]
    loop:
      prompt: "Read the plan. Implement the next task. Run validation."
      until: ALL_TASKS_COMPLETE
      fresh_context: true
  - id: run-tests   # 決定的な bash ステップ
    depends_on: [implement]
    bash: "bun run validate"
  - id: review      # AI が変更をレビュー
    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   # AI が PR を作成
    depends_on: [approve]
    prompt: "Push changes and create a pull request"

issue で archon-ship を実行すると、自動的に：

分離されたブランチ/ワークツリーを作成
計画、実装（テストが通るまでループ）、レビュー、人間の承認を待ち、最後に PR を開きます。

インストールと開始

フルセットアップ（約 5 分） – リポジトリをクローンし、bun install を実行し、Claude Code をインストールし、archon を実行してインタラクティブウィザードに従います（資格情報の設定、Archon スキルをターゲットリポジトリにコピーなど）。
クイックインストール（約 30 秒） – Claude Code がすでにインストールされている場合、プリコンパイル済みバイナリを取得できます：
```
curl -fsSL https://archon.diy/install | bash   # macOS/Linux
# または Windows の PowerShell
irm https://archon.diy/install.ps1 | iex
```
（Homebrew フォーミュラも利用可能です。）
ワークフローの実行 – プロジェクトディレクトリ内で：archon workflow run archon-ship または単にアシスタントに Use archon to fix issue #42 と尋ねます。

Web UI – archon serve はコンソールを起動し、実行の閲覧、ワークフローグラフの表示、アシスタントとのチャット、プロジェクトの管理ができます。Slack、Telegram、Discord、GitHub webhooks 用のアダプタにより、これらのプラットフォームから実行をトリガーできます。

組み込みワークフローパック – sdlc パックには、次のような既製のワークフローが含まれています：

archon-ship – エンドツーエンドの issue → PR
archon-triage、archon-investigate、archon-plan、archon-implement、archon-review、archon-validate、archon-upkeep archon workflow list で一覧表示でき、独自の YAML ワークフローをカスタマイズまたは作成できます。

アーキテクチャのスナップショット

Platform adapters (Web UI, CLI, Slack, …) → Orchestrator →
   Command handler, Workflow executor, AI assistant clients (Claude, Codex, Pi)
   ↕
   SQLite / PostgreSQL persistence (runs, projects, sessions, etc.)

テレメトリ – Archon は匿名の使用イベント（ワークフロー名、結果、ノード数、プロバイダー/モデル ID、コストなど）を送信しますが、コード、プロンプト、個人データは決して送信しません。テレメトリは ARCHON_TELEMETRY_DISABLED=1 または標準の DO_NOT_TRACK で無効にできます。

誰が使うか – コード生成に LLM を頼り、再現可能な CI のようなパイプラインを望む開発者。監査可能性と再現性を犠牲にせずに AI アシスタントを既存の開発ワークフローに組み込みたいチーム。

TL;DR – Archon は、AI 支援開発ステップを YAML でスクリプト化し、CLI やチャットプラットフォームから実行し、「AI にバグを修正させる」ときに通常伴うランダム性なしに信頼性の高い PR を得ることができる、決定的で Git 対応のワークフローエンジンです。

coleam00/Archon

Archon – 決定的な AI コーディングワークフロー

関連