プロジェクトガイド

ユーザーの目標

専用のプロジェクトワークスペースを確立して、コンテキストメモリを整理し、運用上の決定とアクティブなタスクを追跡し、接続されたエージェントで焦点を絞ったプロジェクトコンテキストを取得し、プロジェクトの関連付けを削除してもコアの個人メモリが無傷のまま残ることを確認します。

利用資格と前提条件

プロジェクトワークスペースは、Memory Console (https://xmemo.dev/me#projects) およびサポートされている MCP クライアントプロファイルを通じて、すべての個人アカウントで利用できます:

• 個人の境界: 現在、プロジェクトは厳密に個人専用です。team_id を指定してプロジェクトを作成しようとすると、サーバーによって拒否されます (HTTP 400)。ドキュメントにはチームプロジェクトの保証はありません。
• 上限なしのクォータ: ワークスペースの作成は、数値プランのクォータや人為的なプロジェクト制限によって制約されません。アカウントは必要に応じてワークスペースをプロビジョニングします。
• パーティション化されたビュー: "対応が必要" (Attention Needed) ビューおよび Knowledge メモリ対 Working メモリのパーティションは、アカウントで有効化されている場合に動作します (収束評価モードはデフォルトでオフです)。
• エージェントの接続性: 接続されたエージェントは、config/mcp-documentation-contract.json で契約されているクライアントプロファイルに一致するプロジェクトツールにアクセスします。

1. Memory Console のプロジェクトに移動する

個人ダッシュボードにログインし、https://xmemo.dev/me#projects を開きます。左側のナビゲーションで Workspace セクションを選択し、Projects をクリックします。パネルヘッダーには "Browse project workspaces, context, and project memories." と表示され、Total Projects、Active、Attention Needed、および Archived のトップレベル指標が表示されます。

https://xmemo.dev/me#projects
Workspace -> Projects -> Total Projects (0) | Active (0) | Attention Needed (—) | Archived (0)

2. 新しい個人プロジェクトワークスペースをプロビジョニングする

上部のアクションエリアで Create New Project をクリックして、ワークスペースモーダルを開きます:

• プロジェクト名: 説明的なプロジェクト名を入力します (例: "Incident Response Automation")。フィールドには "Required, 1-128 characters." と表示され、制御文字およびパス区切り文字 (/ または \) に対して検証されます。
• プロジェクト識別子のプレビュー: プレビュー識別子 (#incident-response-automation) を確認します。ヘルパーには次のように表示されます: "Non-authoritative preview. The backend server assigns the authoritative project key."
• 説明: 必要に応じて、最大 2000 文字のスコープ憲章を入力します (例: "Operational runbooks, triage checklists, and automated incident response workflows.")。
• 送信: Create Project をクリックします。サーバーは正規の識別子を割り当て、プロジェクト詳細ビューを開きます。

3. メモリ、TODO、および決定を関連付ける

ワークスペースがプロビジョニングされたら、スコープ設定されたコンテキスト、保留中のタスク、およびアーキテクチャの決定を設定します:

• メモリを関連付ける: プロジェクトにスコープ設定された合成運用ランブックメモリを作成します (scope: "incident-response-automation"): "Runbook policy: P0 production outages trigger immediate secondary on-call escalation after 15 minutes of unacknowledged alerts."
• TODO を記録する: プロジェクト詳細ビューまたはエージェントを介してタスクを追加します: "Draft post-incident review template for payment gateway timeouts."
• 決定を記録する: アーキテクチャの決定を記録します: "Use PagerDuty webhook adapter for primary incident ingestion."
• ヒーロー指標を検査する: ヒーローバーにはライブ集計が反映されます: Memories: 1, Open TODOs: 1, Decisions: 1。

await client.remember(
  "Runbook policy: P0 production outages trigger immediate secondary on-call escalation after 15 minutes of unacknowledged alerts.",
  {
    path: "projects/incident-response-automation/runbooks/p0-escalation",
    scope: "incident-response-automation",
  },
);

4. エージェントのコンテキスト取得を検証する

認可されたエージェントクライアントを接続して、プロジェクトの取得によってプロジェクト間のノイズなしにスコープ設定されたレコードが返されることを検証します:

• Cursor または Ordinary Full: エージェントは get_project_context(project_id="incident-response-automation") を呼び出して、アクティブなメモリ、保留中の TODO、および記録された決定を取得します。
• ChatGPT または Generic Public: エージェントは get_project_summary(project_id="incident-response-automation") または open_project_workspace を呼び出して、サマリーステータスを検査します。
• ChatGPT チャット内ウィジェット: open_project_workspace によって開かれるチャット内インタラクティブウィジェットは、会話内でインラインタスクカードを直接提供します。これは https://xmemo.dev/me#projects の完全な Web Memory Console とは異なります。

{
  "project_id": "incident-response-automation",
  "status": "active",
  "memories_count": 1,
  "open_todos": 1,
  "decisions": 1,
  "summary": "Operational runbooks, triage checklists, and automated incident response workflows."
}

5. メモリの関連付けを解除し、非破壊的な削除を検証する

プロジェクトメモリを削除すると、基盤となる個人メモリレコードを保持したままワークスペースの関連付けのみが解除されることを確認します:

• メモリードロワーを開く: プロジェクトメモリリストで運用ランブック項目を選択して、詳細ドロワーを表示します。
• 削除を開始する: ドロワーのアクションで Remove from Project をクリックします。
• 関連付けの解除を確認する: モーダルが開き、ヘッダーに "Remove from Project"、サブタイトルに "This memory will be disassociated from this project workspace." と表示されます。警告に注意してください: "The memory content remains in your personal memory archive, but will no longer appear in this project context."
• 確認を実行する: Remove をクリックします。プロジェクトのメモリカウントが 0 に減ります。
• グローバルな永続性を検証する: 個人メモリアーカイブ (/me#memory) に移動し、ランブックメモリが無傷で取得可能であることを確認します。

観察可能な結果

このワークフローを完了すると、ワークスペースは完全な運用上の分離を示します:

• ワークスペースステータス: プロジェクトはアクティブなプロジェクト (Active) の下に正規のスラッグ #incident-response-automation で一覧表示されます。
• コンテキストの分離: 接続されたエージェントはプロジェクトコンテキストを照会し、無関係なプロジェクトからの混入なしにスコープ設定された事実を受け取ります。
• データ安全性: ワークスペースからメモリレコードのリンクを解除すると、個人メモリレコードをアーカイブに永続的に保持しながら、プロジェクトの集計のみが正常に減少します。

エージェントがアクセスできるもの

エージェントツールの可用性は、config/mcp-documentation-contract.json で構成されたクライアントプロファイルに厳密に依存します:

• chatgpt-public、generic-public、および public-only プロファイル: project、get_project_summary、および open_project_workspace を公開します。
• claude-plugin プロファイル: project および get_project_context を公開します。
• cursor-plugin および ordinary-full プロファイル: get_project_context、update_project_todo、および update_project_decision を公開します。
• プロファイルの境界: その他のクライアントプロファイルはプロジェクトツールを公開しません。契約外のツールを呼び出そうとすると、ツール検出拒否が発生します。

共有とライフサイクルの境界

プロジェクトワークスペースは、明示的な運用およびデータ境界を強制します:

• 個人の境界: 現在、すべてのワークスペースは個人専用です。チームワークスペースはサポートされておらず、team_id を指定したリクエストは検証に失敗します。
• ライフサイクル状態: メモリエクスプローラーは、レコードを Active、Superseded、Expired、および Archived のステータスに分類します。
• キュレーションパーティション: アカウントで有効化されている場合、ワークスペースは Knowledge (知識) および Working (作業) メモリパーティションを提供します。Knowledge パーティションには永続的な規約が保持され、Working パーティションには一時的なセッション状態が保存されます。
• ナレッジベースとの違い: プロジェクトパーティションは会話型エピソードメモリを分類します。対照的に、ナレッジベースは複数リビジョンのスナップショットを備えた正式でバージョン管理されたドキュメント管理を提供します。キュレーションされたドキュメントについては /docs/concepts/knowledge-bases を参照してください。
• クォータの境界: 個人プロジェクトワークスペースには数値クォータはありません。

障害回復

一般的なエッジケースと回復アクション:

• 重複するプロジェクト名 (HTTP 409): サーバーは重複するプロジェクト名を "A project with this name or identifier already exists in your workspace." で拒否します。別のプロジェクト名を指定してください。
• 無効なプロジェクト名 (HTTP 400): プロジェクト名にスラッシュ (/ または \) を含めたり、128 文字を超えたり、予約されたトークン (_project、.、..) を使用したりすることはできません。作成ダイアログで名前を修正してください。
• クライアントプロファイルのツールの不一致: エージェントが get_project_context を見つけられない場合は、アクティブなクライアントプロファイルを確認してください。chatgpt-public プロファイルは get_project_summary を公開し、get_project_context は cursor-plugin および ordinary-full で公開されます。
• バージョンの競合 (HTTP 409): 別のセッションがプロジェクトまたはメモリを同時に変更した場合、ドロワーに Reload ボタンとともに "Modified elsewhere, please reload" が表示されます。Reload をクリックして状態を更新してください。

関連リファレンス

補完的な機能と技術リファレンスについては、以下を参照してください:

• プロジェクトの概念リファレンス: /docs/concepts/projects のアーキテクチャ詳細とスコープ規則。
• Memory Console ガイド: /docs/guides/memory-console の完全なコンソールウォークスルー。
• ナレッジベースガイド: /docs/concepts/knowledge-bases のキュレーションされた参照ドキュメント管理。
• プロジェクト REST API: /docs/api/projects の認証済みプログラムエンドポイント。