# Projects API
SUMMARY: 取り組みごとにメモリ・タスク・専用マインドをまとめる — プロジェクトはステータス・優先度・リポジトリ・ホームページを持ち、周辺の作業をリンクします。

KEY CONTEXT:
認証：Mind Key（またはユーザー JWT）。全エンドポイントは呼び出し元の mind スコープ。
一覧：GET /projects?status=in_progress&priority=critical
作成：POST /projects {name, status?, priority?, repository_url?}
統計：GET /projects/stats
詳細：GET /projects/:id（メモリ数＋タスク数付き）
リンク：POST /projects/:id/memories {memory_id} · POST /projects/:id/tasks {task_id}
自動リンク：POST /projects/:id/auto-link（タグ重複による）
共有マインド：GET /projects/shared-mind（冪等）

Projects API
Projects は Synapse のポートフォリオ層です。1 つのプロジェクトが、同じ取り組みに属するメモリ・タスク・さらに専用のエージェントマインドまでをまとめます。各プロジェクトはステータス（idea、planning、inprogress、paused、completed、archived、deprecated）と優先度（low、normal、high、critical）、任意のリポジトリ/ホームページ URL を持ち、艦隊は断片ごとではなく取り組みごとに報告できます。
リンクは明示的かつ可逆です：メモリとタスクはリンクエンドポイントで添付（単一または一括）、タグ重複の自動リンクが大規模な提案を行い、GET /memory/:id/projects が逆方向の問いに答えます。プロジェクトマインド（GET /projects/shared-mind）は、全きょうだいが読める取り組み専用の共有メモリ空間を与えます。
プロジェクトが持つもの
| メソッド | パス | 目的 |
| --- | --- | --- |
| POST |  | Create a project {name, slug?, description?, status?, priority?, repositoryurl?, homepageurl?, tags?, metadata?} |
| GET |  | List projects (filter: ?status=, ?priority=, ?tag=, ?archived=) |
| GET |  | Statistics (counts by status/priority) |
| GET |  | Get or create the account-level shared project mind (idempotent, primary discovery endpoint) |
| POST |  | Admin: ensure shared project minds for all accounts (JWT) |
| GET |  | Project details (with memory + task counts) |
| PUT |  | Update project (partial body, same fields as create) |
| DELETE |  | Delete project |
| POST |  | Link memory to project {memoryid, linkedby?} |
| POST |  | Link multiple memories {memoryids: [...]} |
| DELETE |  | Unlink memory from project |
| GET |  | List memories linked to project (?limit=, default 200) |
| POST |  | Link task to project {taskid} |
| DELETE |  | Unlink task from project |
| GET |  | List tasks linked to project |
| POST |  | Auto-link memories by tag overlap |
| POST |  | Create/link a project mind {name?} |
| GET |  | List project minds |
| DELETE |  | Remove a project mind link |
| GET |  | List projects linked to a memory |
クイックスタート
[CODE BLOCK]
メモリとタスクのリンク
-  {memoryid, linkedby?} · bulk:  {memoryids: [...]}
-  {taskid} ·  · 
- :  — 逆に： 
- 例:  (タグ重複によるメモリーの自動リンク)
プロジェクトマインド
 (レスポンス: mind, idempotent) ·  {name?} ·  ·