cursorとclaude codeの協調案１１

document/20_Cursor_Claude連携ガイド.md

@@ -0,0 +1,95 @@
+## Cursor / Claude Code 連携ガイド
+
+> **最終更新**: 2026-02-28  
+> **対象**: Cursor（GPT-5.1）と Claude Code の協調運用ルール
+
+---
+
+## このドキュメントの目的
+
+- Cursor と Claude Code を併用する際の **役割分担** と **情報の受け渡し方法** を明文化する。
+- 両方のエージェントが、このリポジトリ内の同じドキュメントを参照することで、Trilium や外部 MCP に依存せずに進捗・設計情報を共有できるようにする。
+
+---
+
+## 全体方針
+
+- **設計相談・方針検討** は主に Cursor が担当する。
+- **具体的な実装・継続作業** は主に Claude Code が担当する。
+- 両者のあいだで **直接通信は行わず**、このリポジトリ配下の Markdown 文書を介して情報を引き継ぐ。
+- ユーザーが Trilium に手作業でコピーすることを前提にせず、可能な限り **リポジトリ内ドキュメントの自動更新** で完結させる。
+
+---
+
+## 役割分担
+
+### Cursor（GPT-5.1）
+
+- 設計方針や仕様の検討、代替案の比較、設計レビューなどを担当する。
+- セッション中の議論内容・決定事項・未解決の論点を、以下のドキュメントに **逐次追記・更新** する。
+  - `document/20_Cursor_Claude連携ガイド.md`（このガイド。必要に応じて拡張）
+  - `document/21_Cursor_設計ログ.md`（時系列の詳細ログ、※必要になったら作成）
+  - `document/22_Cursor_からClaudeへの引き継ぎ.md`（Claude Code 向けの要約・ToDo、※必要になったら作成）
+
+### Claude Code
+
+- 実際のコード編集、リファクタリング、テスト整備などの「手を動かす」部分を中心に担当する。
+- 作業前に必ず以下を読む:
+  1. `CLAUDE.md`
+  2. `document/20_Cursor_Claude連携ガイド.md`（このファイル）
+  3. 必要に応じて `document/21_Cursor_設計ログ.md` と `document/22_Cursor_からClaudeへの引き継ぎ.md`
+- Cursor がまとめた設計方針や前提条件を尊重しつつ、実装詳細を詰める。
+
+---
+
+## 共有ドキュメントと役割
+
+- **`document/20_Cursor_Claude連携ガイド.md`（本ファイル）**
+  - Cursor / Claude Code の運用ルールそのものを定義する。
+  - 運用方針や役割分担に変更があった場合は、まずここを更新する。
+
+- **`document/21_Cursor_設計ログ.md`（想定）**
+  - Cursor セッション中の思考過程や議論の詳細を、時系列で残すログ。
+  - 「なぜその設計にしたか」「どの案を捨てたか」など、後から振り返りたい情報を含める。
+
+- **`document/22_Cursor_からClaudeへの引き継ぎ.md`（想定）**
+  - Claude Code が最初に読むべき、Cursor セッションの要約。
+  - 構成イメージ:
+    - 背景・前提
+    - 決定した方針
+    - 未完了タスク / ToDo
+    - 注意点（制約、やってはいけないこと など）
+
+実際に `21` や `22` を使い始めるタイミングで、Cursor 側がひな型を作成し、以降はセッションごとに更新していく。
+
+---
+
+## ワークフロー（例）
+
+1. **Cursor セッション開始**
+   - ユーザーが設計相談や仕様検討を Cursor に依頼する。
+   - 必要に応じてこのガイドや既存ドキュメントを参照しつつ、方針を議論する。
+
+2. **Cursor による記録**
+   - 議論の結果を `document/21_Cursor_設計ログ.md`（詳細ログ）と  
+     `document/22_Cursor_からClaudeへの引き継ぎ.md`（要約・ToDo）に追記・更新する。
+
+3. **Claude Code への引き継ぎ**
+   - Claude Code に作業を依頼する際、「まず `CLAUDE.md` と `document/22_Cursor_からClaudeへの引き継ぎ.md` を読むこと」と指示する。
+   - Claude Code が詳細を知りたくなった場合は、`document/21_Cursor_設計ログ.md` やその他ドキュメントを参照する。
+
+4. **Claude Code セッション終了時**
+   - Claude Code 側で重要な設計判断や仕様変更があった場合は、`CLAUDE.md` や関連マスタードキュメント（10〜12など）を更新する。
+   - 必要に応じて、Cursor 側に再相談したい論点を `document/22_Cursor_からClaudeへの引き継ぎ.md` にメモしておく。
+
+---
+
+## 注意点
+
+- Cursor と Claude Code は **直接通信できない** ため、必ずこのリポジトリ内のドキュメントを介して情報を共有する。
+- 運用ルールやフローに大きな変更があった場合は、
+  1. 本ガイド（`20_Cursor_Claude連携ガイド.md`）を更新し、
+  2. 必要があれば `CLAUDE.md` の「よくある作業パターン」などからリンクを追加・修正する。
+
+このファイル自体も、今後の運用の中で少しずつ育てていくことを前提とする。
+