AWRとは — AWR

AWRは、人とAIのためのオープンソースのプロジェクトデリバリープラットフォームです。 ゴール、ワークストリーム、依存関係、コンテキスト、受け入れを1つのプロジェクトデリバリーワークフローにつなぎ、作業が複数のエージェント、セッション、コラボレーターに分散していても、プロジェクトが合意されたゴールから検証済みのデリバリーまで前進できるようにします。

AWRは、根底にある問題が同じである2つの状況のために作られています。

一人の人が複数のエージェントを調整する複雑なプロジェクト。
チームが共有プロジェクトをデリバリーする場面。まず複雑なソフトウェアプロジェクトから始まります。

どちらの場合も、人が方向を定めて成果をレビューし、エージェントが作業を行います。 AWRはCLIとMCPサービスを通じて、彼らの作業を同じプロジェクト状態につなぎます。

AWRが解決する問題

AIコーディングエージェントと作業する場合、プロジェクトの知識は通常エージェントの非公開の会話の中に存在します。セッションが終了したり、モデルが変わったり、別の人やエージェントが作業を引き継いだりすると、そのコンテキストは失われます。並行して進む作業は互いにずれていき、「完了」は最後のエージェントが言った意味でしかなくなります。

AWRは、本来あるべき姿を中心に設計されています。

セッション、モデル、コラボレーターが変わってもプロジェクトは保持されます。 ゴール、制約、検証済みの進捗はハンドオフを越えて残ります。後続者は現在のタスクに必要なコンテキストとそのチェックポイントを受け取るため、プロジェクトはセッションやエージェントを越えて継続できます。
並行作業には明確なオーナーシップとハンドオフがあります。 独立したワークストリーム（例えばフロントエンド、バックエンド、テスト）は、プロジェクトの制約を共有しながら、それぞれ独自のタスク、コンテキスト、オーナーシップを保持します。
「完了」は検証可能です。 完了の申告はバージョンに紐付けられた証跡につながります。実装、検証、マージ、リリースは1つの申告にまとめられず、個別の事実として追跡されます。
労力が可視化されます。 どの段階でも、何が準備完了で、何が待機中で、何が検証済みで、労力がどこに使われたかが分かります。

要するに、AWRは有限のコンテキストウィンドウを越えたプロジェクトの継続性を保持します。エージェントのコンテキストウィンドウには限界があり、コンパクション（ホストが会話を収まるように短縮すること）はホストの役目です。AWRのチェックポイントが、記録されたプロジェクトの事実を代わりに前方へ運びます。

仕組み: ファイルが信頼できる唯一の情報源であり続ける

AWRのアーキテクチャは3つの部分から成ります。

あなたのファイルが意図を保持します。 プロジェクト内のMarkdownとYAMLファイルが、ゴール、計画、作業、制約、決定を記述します。AWRはこれらのソースを黙って置き換えることなくインデックスします。
AWRが継続性を維持します。 ローカル状態（SQLiteプロジェクト）が、それらのソースのプロジェクションに加えて、セッション、クレーム、チェックポイント、証跡を保持します。コンテキストのコンパイル —— 現在のタスクに関連するゴール、ルール、依存関係、証跡を組み立てる処理 —— はローカルで実行され、モデル呼び出しは一切行いません。リビジョンチェックが古い状態からの書き込みを防ぎます。
人とエージェントが作業を行います。 CLIとMCPサービスが、プロジェクトの事実をあなたが使う任意のホストにつなぎます。エージェントは自分のモデル、ツール、会話を持ち込み、レビュー済みの変更と進捗がプロジェクトのソースに戻ります。

記録されたチェックポイントは記録された事実のみを運ぶため、エージェントの記録されていない会話履歴を再構成することはありません —— それは引き続きホストの責任です。

構成要素とその関係

AWRには2つのエントリーポイントがあり、どちらも同じパッケージからインストールされます。

awr CLI —— プロジェクトを初期化し、状態を確認し、明示的なセッションワークフローを駆動します。作業単位にクレームを取り、焦点を絞ったコンテキストを取得し、停止する前にチェックポイントを保存します。シェルコマンドを実行できるエージェントならどれでも利用できます。
awr-mcp MCPサービス —— 同じプロジェクト状態をMCPツールとして公開します（MCP、 Model Context Protocolは、AIクライアントが外部ツールを呼び出すための仕組みです）。クライアントは、 stdio経由で単一のプロジェクトに接続するか、複数のクライアントとプロジェクトに対応する共有HTTP MCPサービスに接続します。

これらの上に、AWRはあなたがすでに使っているエージェントをサポートします。統合は層状になっています。

汎用コントラクト（デフォルト、完全サポート）。 CLIを実行できる、またはMCPを話せる任意のホストが、共有セッションワークフローを通じて同じプロジェクト状態を使います。これにはClaude Code、Cursor、 Windsurfなどのホストが含まれ、特別なインストーラーは不要です。
ホストノート。 一部のホスト（Cursor、Kimi Code、Grok Build）については、AWRが正確な設定マージパスとネイティブのセッションフラグを文書化しており、日付付きのホストバージョンで検証済みです。これらのノートはランタイム機能を追加しません。
オプションのライフサイクルアダプター。 ホストのネイティブライフサイクルフックが安定している場合、アダプターがホストイベントからAWRのチェックポイントを駆動できます。現在これはCodex向けに存在します。アダプターがAWRをそのホストのランタイムに変えることは決してありません。

複数のエージェントを調整する一人の人にとっても、より大きなチームと同じ依存関係、レビュー、会計の規律が適用されます —— これは1つのプロジェクトモデルであり、2つの製品ではありません。

AWRではないもの

AWRは意図的にスコープを絞っています。ホスト非依存のワークランタイムであり、製品境界は共有の CLI/MCPコントラクトです —— 特定のエディターやエージェントではありません。

AWRはAIエージェントではありません。 コーディングエージェントの選択、起動、設定は行いません。エージェントは自分のモデル、ツール、会話を持ち込みます。AWRが保存するプロバイダーとモデルの文字列は表示用のラベルにすぎません。
AWRはエディター、チャットUI、モデルプロバイダーではありません。 エージェントのUI、ネイティブの会話ID、コンパクションはホストに属します。
AWRはプロジェクトファイルを置き換えません。 Markdown/YAMLのソースが引き続き権威であり、 AWRのローカル状態はインデックスと継続性の記録です。あなたのソースを黙って置き換えることは決して許されません。
AWRは特定のトランスポートに縛られません。 MCPがstdio、HTTPで動くか、あるいは存在しないかはホストの選択です。ホストにネイティブフックがない場合は、CLIから手動でチェックポイントを取ります。
AWRはワークストリームを物理的に分離しません。 ワークストリームの分離はプロジェクト状態とサポートされる操作を対象とし、プロセスの物理的な分離は実行ホストに依存します。

現在のスコープ: 公開リリースと開発中の機能

AWRは、出荷済みのものと構築中のものを正直に区別しています。公開された0.5.1のCLI/MCPパッケージが提供するものは以下の通りです。

ソースに裏付けられたゴールとタスク、依存関係ナビゲーション付き
現在のタスク向けの焦点を絞ったコンテキストのコンパイル
セッションのクレームとチェックポイント
バージョンに紐付けられた証跡
複数のクライアントとプロジェクト向けの共有HTTP MCPサービス
Personal Workspaceのファイル交換
個人ワークストリームの基盤: ローカルSQLiteプロジェクトにおける明示的なソースオーナーシップ、セッションの帰属、スコープ付きコンテキスト

このリリースは、認証付きのTeamサービスや完全なマルチクライアント分離を提供しません。 mainで開発中のもの:

バージョン管理されたワークストリーム間デリバリー採用（下流の作業を受け入れ済みの成果物とコントラクトバージョンに紐付け、変更時にコンシューマーを再チェックする）
チームコラボレーションとデリバリーレビュー（明示的なレビュアーと承認記録）
ワークストリームの使用量、時間、ETAの会計

公開された各バージョンのリリースノートが、実際のパッケージ境界を定義します。

あなたにとっての意味

AWRを評価している場合: 現在のエージェントと現在のファイルはそのまま使えます。プロジェクトでAWRを初期化し、エージェントに作業協定を与えれば、それ以降すべてのセッションはゼロからではなく、記録されたゴール、ルール、依存関係、チェックポイントから始まります。進捗はいつでも確認できます。

チームで採用する場合: 同じCLI/MCP基盤が、それらの機能の出荷に合わせて共有デリバリーとレビューへ拡張されます —— 公開リリースはすでにシングルユーザーおよびマルチエージェントのコアを提供しています。

次に読むべきもの

クイックスタート —— AWRをインストールし、プロジェクトを接続し、最初のセッションを実行します。
コンセプト —— プロジェクトモデルの詳細: ゴール、ワークストリーム、セッション、クレーム、チェックポイント、証跡。
CLIとMCPサービス —— 2つのエントリーポイントの詳細。
エージェント統合 —— すでに使っているエージェントを接続します。