keinasystem/document/20_Cursor_Claude連携ガイド.md

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 の「よくある作業パターン」などからリンクを追加・修正する。

このファイル自体も、今後の運用の中で少しずつ育てていくことを前提とする。