Loop Engineering から Graph Engineering へ：AIOS はローカルファーストの Agent Harness¶
クイックアンサー： 「Loop Engineering は死んだ、Graph Engineering は永遠」というのは偽の二択です。Graph Engineering の実践マニュアル自身が最初の鉄則としているのは——グラフを組む前に、まず 1 つのループを安定させよ、です。AIOS はその両方のレイヤーを備えた珍しいローカルファースト Agent Harness です。ループのツールキット（検証器、終了条件、状態ファイル）も、グラフの構成要素（ノード、エッジ、共有状態、失敗ルーティング）も揃っており、まず単一ループを安定させ、仕事が本当に必要になったときにループ同士をグラフに接続できます。
2 週間前の流行語は Loop Engineering、今週は Graph Engineering で、早くも旧語は死んだと叫ぶ人もいます。しかし、どちらかに肩入れする前に、グラフ実践マニュアルの本当の主張を確認してください。最も重要な前提は——安定した単一ループをすでに持っているか、です。持っていなければ、先にグラフを組んではいけません。グラフはループの組織化であって、ループの代替ではありません。
ここがまさに AIOS の立ち位置です。AIOS はローカルファーストの Agent Harness——既存のコーディングクライアント（codex、claude、gemini、opencode、hermes、grok）の下に置くレイヤーで、まず単一の Agent ループを信頼できるものにし、その後、多数のループをグラフに接続するためのプリミティブを提供します。しかもデータはマシンの外に出ません。
レイヤー 1——ループのツールキット：まず 1 つのループを安定させる¶
この記事が総括している、2 年間マルチエージェント協調のてこだったものは次の 3 つです：より良い検証器、より安定した終了条件、よりきれいな状態ファイル。AIOS がグラフの前にまず固めるのも、まさにこの 3 つです。
| Graph Engineering のループツールキット | AIOS が提供するもの |
|---|---|
| より良い検証器 | エビデンスゲート——verification-before-completion、doctor チェック、契約検証つきテストエビデンス。ノードの成果はエージェントが「完了」と言っただけでは完了にならず、決定論的なチェックを通過する必要があります。 |
| 安定した終了条件 | Workflow Policy がリスクに応じて各リクエストを direct / guarded / planned に分類し、aios plan auto-gate が実行時に経路を選びます。ループはルート契約が示す地点で止まり、予算が尽きるまで回り続けません。 |
| きれいな状態ファイル | ContextDB がプロジェクト記憶（memo、checkpoint、検索可能パック）をディスクに保存します。pull-based なので、ループが殺されてもセッション全体を再生することなく中断箇所から再開できます。 |
さらに aios harness run --objective "..." --worktree を重ねれば、中断しても復元できる長時間ループが手に入ります：状態を checkpoint し、最後に受け入れられたエビデンスから再開し、実行中のファイルを git worktree で隔離します。
これが「ループ」の半分であり、多くのチームが実際にいる場所でもあります。彼らはまだグラフを必要としていません——静かにドリフトしない 1 つのループが必要なのです。
レイヤー 2——グラフのツールキット：ループをグラフに配線する¶
仕事が本当に役割に分解でき、真に並列なサブタスクや失敗分岐があるとき、AIOS は Graph Engineering の 4 つの核心構成要素を直接提供します。自分でオーケストレーションフレームワークを組む必要はありません。
| Graph Engineering の構成要素 | AIOS の対応物 |
|---|---|
| ノード——1 ノード = 1 ループ、契約つき | rex-harness ノード：各 Capability が Fact → Capability → Evidence のサイクルを実行し、入出力に境界があります。スキル自体も契約を持ちます。 |
| エッジ——チェック結果でルーティング、気分ではない | Workflow Policy のエッジ：direct / guarded / planned の遷移に加え、aios plan auto-gate --dry-run が構造化されたタスク記述からエッジを選択します。 |
| 共有状態——全員が読み書きする 1 つのデータ | ContextDB：すべてのノードが同じプロジェクト記憶（memo、checkpoint、検索可能パック）を読み書きします。下流ノードが消費するのは、上流ノードがコミットしたフィールドです。 |
| 失敗ルーティング——リトライが尽きたとき制御はどこへ | エビデンスゲートと終端決定：検証失敗は明確な blocked 結果になり、明示的にルーティングされます（再計画、エスカレーション、停止）。静かな無限ループにはなりません。 |
無料で手に入るトポロジー¶
実践マニュアルで最も価値のあるトポロジーは、AIOS では概念ではなくコマンドです。
- ファンアウト / ファンイン（
parallel()） →aios team 3:codex "..."：N 個の独立ノードを一度に派出し、バリアで待ち合わせ、完全な結果セットを収集し、失敗をフィルタします（ここでも.filter(Boolean)は 1 行です）。 - ダイヤモンド：派発 → 還元 → 合成 → team 実行の後にエビデンス還元のマージステップ：HUD がエージェントごとのステータスを報告し、合成ノードは収集されたエビデンスだけを見ます。全員のフルコンテキストを背負うことはありません。
- 対抗的検証 → エビデンス監査：doctor、契約テスト、検証ゲートは、ある「完了」主張が受け入れられる前に、それを反証しようとすることこそが目的です。
- 隔離（
git worktree） →aios harness run --worktree：並列に書き込むエージェントはそれぞれ自分のワークツリーで作業し、互いに踏み込みません。 - モデル階層化 →
model-router：境界があり反復的な作業（抽出、分類）は安価な階層へ、合成ノードは強いモデルを維持——トークンは習慣ではなく判断力に従って使われます。 - 動的ワークフロー（モデルにグラフを描かせる） →
aios plan auto-gate：目標を記述すれば、実行時に経路が選択された計画が返ってきます——これがマニュアルの「自己ルーティング」の一歩です。
ローカルファーストこそが堀¶
どちらのエンジニアリングスタイルもトークンとコンテキストを消費します。AIOS はループもグラフもローカルに保ちます：
- エンジン自体がマシン上で動作（リモートのエージェントクラウドなし）；
- ContextDB の記憶はプロジェクトディレクトリに残る；
- RTK / Caveman / Headroom がプロセス内・ローカルでトークン流を圧縮；
- ブラウザとプライバシーガードもローカルで動作。
グラフが読みやすいのは、それが読み書きする状態が目に見える場所——.aios/context-db/、memo、エビデンスレシート——に置かれ、誰かのリモートセッションログの中にないからです。
結論¶
Loop Engineering は死んでいません。それは Graph Engineering のノード定義になったのです。本当の進化の道筋は：1 つのループを安定させる → 契約を与える → 条件つきのエッジで接続する → 状態を共有する → 失敗をルーティングする、です。AIOS はこの道筋をローカルファーストの Agent Harness として実装しています：aios harness がループを、aios team と aios plan auto-gate がグラフを、ContextDB が共有状態を、エビデンスゲートが失敗ルーティングを担い、すべてはあなたがすでに使っているコーディングクライアントの下で動きます。
まだ「安定していない 1 つのループ」の段階なら、そこから始めてください：aios init --all、そして aios doctor --native --verbose。ループが安定したとき、グラフはまだ元の場所であなたを待っています。
FAQ¶
Loop Engineering は死んだのですか？ いいえ——それは Graph Engineering のノード定義になったのです。グラフ実践マニュアルはグラフを組む前に安定した単一ループを要求しますが、AIOS はまさにそのループを先に固めます（検証器、終了条件、状態ファイル）。
グラフは必要ですか？ タスクが明確な役割に分解でき、真に並列なサブタスクがあり、失敗ルーティングのコストを負担できる場合だけです。それ以外は安定したループの方が安くて速い——しかも AIOS はどちらのレイヤーも提供します。
AIOS はデータをクラウドに送信しますか？ いいえ。エンジン、ContextDB 記憶、トークン圧縮（RTK / Caveman / Headroom）、ブラウザ、プライバシーガードはすべてローカルで動作し、データはマシンの外に出ません。
どう始めればよいですか？
aios init --all を実行し、次に aios doctor --native --verbose を実行します。まず安定したループ 1 つから（aios harness run --objective "..."）、タスクが実際に分解できたらチームを追加します（aios team）。完全な Graph Engineering マッピングはアーキテクチャドキュメントを参照してください。