DanMcInerney/architect-loop

architect‑loop – 自律的なLLM駆動型ソフトウェアファクトリー

概要 – architect-loop は、大規模言語モデルエージェント（設計・レビューにはClaude、コード生成にはCodex）によって駆動される完全自動化された開発パイプラインを実行できるコマンドラインオーケストレーターです。高レベルな製品リクエストを受け取り、それを個別の課題に分解し、各課題を新しいGit worktreeで実装する「builder」エージェントを起動し、テストを実行して、最終的に人間の承認なしで単一のPR（またはローカルの完了記録）を作成します。

仕組み

• オーケストレーター (Orchestrator) – 起動したセッション（/architect、/architect‑fast、または /architect‑research）がマスタープロセスとなります。仕様書を起草するストラテジスト (strategist) サブエージェントを作成し、各課題を処理するbuilder エージェントを生成します。
• 型付きエビデンスとウォッチドッグ (Typed evidence & watchdog) – 各builderは、JSONメタファイル、ハートビート、終了ステータスを書き込むラップされたCLIジョブ内で実行されます。ウォッチドッグは型付きエビデンスを記録するだけで、ジョブを強制終了することはありません。スタックしたジョブは kill-job で手動で終了させます。
• トラッカー (Tracker) – 状態はGitHub（issue/PR経由）またはローカルの docs/issues/<run>/ 下のmarkdownファイルに保存されます。すべての実行メタデータは docs/runs/<run>/ 下に存在します。
• 決定論的ゲート (Deterministic gates) – builderが実行される前にフリーズチェックがコミットされます。最終レビューはストラテジストによる読み取り専用のパスであり、統合するか修正課題を作成するかを決定します。
• ファストレーン (Fast lane) – /architect‑fast は、実行を3つ以下のbuilder課題と約400行の変更に制限し、ストラテジスト段階とフリーズチェックをスキップして、迅速かつ限定的な変更を行います。
• リサーチレーン (Research lane) – /architect‑research は構造化された文献調査を行い、出典付きのレポートを作成します。

主要コマンド

/architect-research <topic>   # トピックレベルの研究、回答優先レポート
/architect <hours+ request>   # 完全な数時間規模のファクトリー実行
/architect-fast <small change># 迅速で限定的な変更レーン

ランタイムヘルパーには run-job.sh|ps1、kill-job、status.sh|ps1、およびクリーンアップ用の sweep‑deferred が含まれます。

インストール

git clone https://github.com/DanMcInerney/architect-loop
cd architect-loop && ./install.sh        # Windows: .\install.ps1
npm i -g @openai/codex@latest            # オプションのbuilderバックエンド

インストーラーは skills/ ディレクトリを適切なClaudeおよびCodexのスキル場所にコピーします。--project を使用すると、ユーザープロファイルではなく現在のリポジトリにスキルがインストールされます。

設定 (オプション, ~/.architect/config または .architect/config)

strategist = claude/best       # 設計/レビューエージェント
builders   = codex/best        # コード生成エージェント
tracker    = markdown          # または github

設定により、モデルファミリーの切り替え、努力レベルの固定、トラッカーモードの変更が可能です。

検証とテスト

uv run --no-project python tests/validate_skills.py

バリデーターは、スキルの定義、ラッパー、契約がプロジェクトのアーキテクチャ不変条件に準拠しているかを確認します。

ライセンス – MIT。

---

結論 – architect-loop は、LLMでオーケストレーションされた自己完結型の開発フレームワークであり、仕様からPRまでのサイクル全体を自動化します。フル機能レーンと軽量なファストレーンの両方を備え、GitHubまたは純粋なmarkdownによる課題追跡をサポートしています。