仕組み
1つの目標から、追えるプランまで
6つのステージが、ループになっています。あなたは望むことを伝えます。PO はそれをプランにし、タスクを順序付け、プロジェクトが知っていることを想起し、作業を実行し、確認して、学んだことを保存します。各ステージの下で、技術的な詳細を開けます。
プラン → 順序付け → 想起 → 実行 → 検証 → 学習、そして想起に戻ります。ステージ6が保存したものを、次のプランのステージ3が想起します。
試す:ステージにカーソルを合わせるかフォーカスすると読めます。選ぶと、そこへ移動します
ループ
ループを、ステージごとに
スクロールしてください。各図は、製品の画面のように描かれています。例は、チームの週末合宿です。
ステージ 1 / 6:プラン。読み取り位置 5 / 5:承認済み
望むことを伝えると、プランができる
結果を1文で説明します。アシスタントがそれをタスク付きのプランにします。各タスクにはステップがあり、各ステップには、完了したかを確認する方法が書かれています。
内部の仕組み
結果は、優先度と制約を持つプランとして保存され、タスクに分割されます。各タスクは、何に依存するかを示し、そのステップを列挙します。各ステップには、完了を証明する確認が付いています。
プラン、タスク、ステップは、チャットの自由なテキストではなく、データとして保存されます。画面とランナーは、同じ状態を読みます。
plan(action: "create", title, description, priority: 8, constraints: [{ constraint_type: "performance", … }])task(action: "create", plan_id, title, depends_on: [task_id], steps: [{ description, verification }])- プランの状態:draft, approved, in_progress, completed, cancelled。
- 制約の種類:performance, security, style, compatibility, other。
- code(action: "plan_implementation", auto_create_plan: true) は、コードグラフからプランの下書きを作ります。
試す:位置を選び、矢印で移動するか、再生を押してください。一時停止の後、図はまたスクロールに従います
ステージ 2 / 6:順序付け。読み取り位置 5 / 5:今すぐ実行可能
互いに依存しないタスクは、まとめて動かす
PO はタスクを並べ替えます。タスクが待つのは、必要なタスクだけです。それ以外はすべて、今すぐ同時に始められます。
内部の仕組み
タスクは、依存するものがすべて完了したときにだけ始まります。PO はこれらのつながりをウェーブに変えます。ウェーブ1には、未解決の前提がないタスクがすべて入り、ウェーブ2にはウェーブ1が解放するものが入り、以降も同様です。
同じウェーブのタスクは互いに独立なので、同時に動きます。依存関係の最長の連なり、つまりクリティカルパスが、ウェーブ数の最小値を決めます。
plan(action: "get_waves", plan_id)plan(action: "get_critical_path", plan_id)- plan(action: "get_dependency_graph") は、タスクの DAG を返します。
- task(action: "get_next") は、ブロックされていない次のタスクを、優先度の高い順に返します。
- 実行が再開されると、ウェーブは再計算され、終わったウェーブはスキップされます。
試す:タスクを選ぶと、何を待っていて、何を解放するかがわかります
試す:位置を選び、矢印で移動するか、再生を押してください。一時停止の後、図はまたスクロールに従います
ステージ 3 / 6:想起。読み取り位置 5 / 5:渡された
アシスタントが、プロジェクトがすでに知っていることを調べる
各タスクの前に、アシスタントは当てはまるノートと決定を読みます。そのため、同じ質問を繰り返しません。
内部の仕組み
タスクの前に、アシスタントはプロジェクトのメモリを読みます。ノート(警告、ガイドライン、パターン)、理由付きの決定、そしてコードプロジェクトなら、触れるファイルの周りのコードです。意味による検索が、最も近い一致を先に見つけます。
次に PO は、ノート間のつながりをたどります。質問に一致しなかったノートでも、一致したノートと強くつながっていれば、現れることがあります。つながりは1ステップごとに弱まり、薄れたノートは除外されます。
note(action: "search_semantic", query, project_slug)decision(action: "search_semantic", query)admin(action: "search_neurons", query, max_hops: 2)note(action: "get_context", entity_type: "file", entity_id)- 活性化の拡散のデフォルト:シードノート20個、2ホップ、信号は1ホップごとに半減、結果10件。
- 結果の枠の40%は、シナプスで到達したノートのために確保されます。
- 伝播したスコアは、親のスコア × シナプスの重み × ノートのエネルギー × 減衰です。
試す:ノードを選ぶと、活性化をタスクまでたどれます
Given to the assistant
- The team prefers a quiet place0.91guidelinedirect match
- The weekend is 14 and 15 June0.84decisiondirect match
- Two people need vegetarian meals0.46gotcha1 hop
- Last year the venue was too far from the station0.17guideline2 hops
試す:位置を選び、矢印で移動するか、再生を押してください。一時停止の後、図はまたスクロールに従います
ステージ 4 / 6:実行。読み取り位置 5 / 5:ウェーブ 2 開始
アシスタントが、グループごとにタスクを行う
各タスクは、専用のアシスタントに渡されます。グループ内のタスクは同時に動き、次のグループは待ちます。
内部の仕組み
plan(action: "run") は、専用の git ブランチ上でランナーを起動します。ウェーブごとに、対象となるタスク1つにつき1つのエージェントセッションを起動し、上限(デフォルトは4)まで並列に実行します。
各タスクには、プロジェクトのメモリから組み立てたプロンプトが渡されます。説明、ステップ、制約、それに結び付いたノート、一致するペルソナとスキル、そして以前のウェーブが行ったことの要約です。ガードがセッションの待機時間、繰り返される呼び出し、タイムアウトを監視し、エージェントが脇道にそれるとヒントを送ります。
plan(action: "run", plan_id, cwd, project_slug)plan(action: "run_status", plan_id)- タスクは、タグ、ステップ、ファイルから、simple、complex、creative のいずれかに分類されます。この分類が、制限時間とコスト予算を決めます。
- Simple:600秒と $0.50。Complex:3600秒と $2.00。Creative:1800秒と $1.00。
- 実行は保存されるので、再起動後に再開できます。plan(action: "cancel_run") で実行を止められます。
- 委任するアシスタントは、そのタスクのプロバイダーとモデルを指定できます。plan(action: "delegate_task") は provider、model、task_class を取ります。プロジェクトは、そのプロバイダーを許可している必要があります。
試す:位置を選び、矢印で移動するか、再生を押してください。一時停止の後、図はまたスクロールに従います
ステージ 5 / 6:検証。読み取り位置 5 / 5:完了
グループは、確認に通ったときに完了する
次のグループが始まる前に、PO が作業を確認します。ステップが閉じられていて、機密ファイルが変更に残っていてはなりません。コードプロジェクトでは、PO はビルドが通ることも確認します。
内部の仕組み
ウェーブが終わると、ランナーは次のウェーブが始まる前にそれを検証します。エージェントがコミットを作ったか、すべてのステップが完了またはスキップされたか、プロジェクトがビルドできるか、差分に機密ファイルが含まれていないかを確認します。
実行そのものが、状態機械です。ライフサイクルプロトコルが、approved から executing、post_run へ進み、どの移動にも明示的なトリガーが必要です。エージェントが失敗またはタイムアウトしたタスクは、デフォルトでは、エラーをコンテキストとして1回再試行されます。
protocol(action: "transition", run_id, trigger: "child_completed")step(action: "get_progress", task_id)- ビルド確認:検出した言語に応じて、cargo check、npm run build、go build ./...。
- 拒否される機密ファイル:.env、credentials.json、*.pem、*.key など。
- テストはオプションで、デフォルトではオフです。plan-runner-reviewed は、人のための awaiting_review 状態を加えます。
試す:位置を選び、矢印で移動するか、再生を押してください。一時停止の後、図はまたスクロールに従います
ステージ 6 / 6:学習。読み取り位置 6 / 6:想起に戻る
学んだことは、次回のために保存される
作業が終わると、決めたことと学んだことがプロジェクトのメモリに書き戻されます。次のプランは、それを持って始まります。
内部の仕組み
タスクが完了すると、ランナーはモデルを呼び出さずに書き戻します。コミットをタスクとプランに結び付け、git ログからコンテキストノートを作り、決定を、それが影響するファイルに結び付けます。
アシスタントは、自分だけが知っていることを加えます。代替案付きの決定、警告、パターンです。一緒に使われたノートは近づきます。まったく使われないノートはエネルギーを失い、古くなります。エピソードは、リクエスト、状態をたどった経路、結果を記録します。次のプランは、そのすべてを持って、ステージ3から始まります。
decision(action: "add", task_id, rationale, alternatives)note(action: "create", note_type: "gotcha", content, anchors)episode(action: "collect", run_id, project_id)admin(action: "reinforce_neurons", note_ids)- 陳腐化は、最後の活動からの時間とともに、ノートの種類に応じた速さで進みます。note(action: "confirm") でリセットされます。
- スキルは、強くつながったノートのクラスターから現れます(admin(action: "detect_skills"))。
試す:位置を選び、矢印で移動するか、再生を押してください。一時停止の後、図はまたスクロールに従います
役割
役割分担
仕組みの部分は PO が担うので、アシスタントは作業に集中できます。
PO は、頼まれなくても行う
- タスクをグループに分け、アシスタントを起動します。
- 各グループを確認します:ステップが閉じられていること、機密ファイルがないこと、コードプロジェクトならビルド。
- 変更をタスクに結び付け、起こったことについてのノートを書きます。
- 各実行の変更を、専用の git ブランチに保ちます。
- どのペルソナとスキルが役に立ったかを記録します。
アシスタントは、ツールを通じて行う
- 始める前に、ノートと決定を検索します。
- プラン、タスク、ステップを作り、その状態を更新します。
- 決定を、代替案と影響範囲とともに保存します。
- 警告、ガイドライン、パターンを、それが対象とするものに結び付けて書きます。
- 手順を、ステップごとに先へ進めます。
入り口
ループを始める3つの方法
お使いの AI ツールから
Claude Code、Cursor、または PO につないだほかの AI ツールです。あなたは結果を説明します。ツールはプランを立て、順序付け、想起し、最後に学んだことを保存します。
チャットから
PO に組み込まれたチャットは、同じアシスタントと話します。各メッセージには、一致するスキル、当てはまるノートと決定、進行中のものが付きます。# を入力すると、計画、タスク、ノート、決定を指し示せます。会話ごとにエンジンを選べます。既定は Claude Code で、別のエンジン(アルファ版)も選べます。自動にすると PO がモデルを選びますが、あなたが自分で選んだモデルが置き換えられることはありません。会話の上のタイムラインには、何が実行され、どれだけ時間がかかったかが表示されます。アシスタントが忙しいときに送ったメッセージは、サーバーが保つキューで待つので、会話を切り替えたり再読み込みしたりしても失われません。ネイティブエンジン、Codex、ACP では、サーバーの再起動で中断されたターンは自動で再開します。Claude Code のターンは目に見えるエラーで閉じられ、次に送るメッセージで会話が続きます。
単独で
プランは、誰もいないときでも実行できます。スケジュールや、イベントの発生をきっかけに、2回の開始の間に間隔を置いて始まります。開始の種類は schedule、webhook、event、chat です。
メモリ
PO は、決めたことと学んだことを覚えています
ノート、決定、そしてそれらのつながりは、プロジェクトに結び付いたまま残ります。役に立つ場面で、PO がそれらを見つけ直します。スクロールして、メモリが育つ様子を見てください。
- 1
ファイルが点になります
PO はプロジェクトの中身から始めます。文書、スプレッドシート、ファイル。1つ1つが青い点になります。
- 2
プランとタスクが加わります
プランとタスクも同じ図に加わります。各タスクは、触れるファイルにつながります。
- 3
ノートと決定はつながったままです
学んだことはノートになります。決めたことは決定になります。どちらもファイルや互いにつながったままです。
- 4
関連するものが集まります
同じ話題の項目が近くに寄ります。プロジェクトの主なテーマが一目でわかります。
- 5
PO はつながりをたどって答えを見つけます
質問すると、PO は一致するノート(シアン)を見つけます。続いて、つながりをたどって関連する項目(紫)を探します。言葉が違っていても見つかります。
架空の例:小さなイベントのプロジェクトです。グラフの中の名前は説明用のもので、あなたのデータではありません。色と形は、製品のグラフと同じです。
内部の仕組み:つながりの名前
これらは、製品がグラフ内のつながりに使っている名前です。PO を使うのに知っておく必要はありません。
- CONTAINSプランは、そのタスクを含みます。
- IMPORTSあるファイルが別のファイルを使います。
- AFFECTSタスクがファイルに触れます。
- CO_CHANGEDコードの履歴から見て、よく一緒に変更される2つのファイル。
- SYNAPSEノート、決定、ファイルの間のつながり。誰も使わないつながりは弱まって消えます。
試してみる
アシスタントが PO と作業する様子を見る
リクエストを選んでください。答えは平易な言葉で表示され、裏でアシスタントが PO に対して行う呼び出しも見られます。呼び出しを開くと詳細が表示されます。
Two notes apply: the place must be close to a train station, and last year the menu had nothing vegetarian. I will write the plan around both.
The plan has 3 tasks in 2 waves. The shortlist and the date poll do not depend on each other, so they happen at the same time. Booking waits for both.
試す:自分のリクエストを入力し、呼び出しを開くと詳細が見られます。やり取り全体はコピーできます。
シミュレーションのデモです。応答は台本どおりで、サーバーには接続しません。呼び出しとその引数は実際のものです。
はじめましょう
エージェントにメモリとプランを
オーケストレーターをインストールし、MCP 経由でアシスタントをつなぎます。最初のエージェントは、1行も書かないうちにプロジェクトを読み込みます。
アプリは無料です。支払うのは、すでにお使いの AI の分だけです。たとえば、ご自身の Claude Code のサブスクリプション、または別のモデルのキーなどです。 料金を見る
ターミナルから始める場合
brew install this-rs/tap/project-orchestrator