96 lines
4.8 KiB
Markdown
96 lines
4.8 KiB
Markdown
## 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` の「よくある作業パターン」などからリンクを追加・修正する。
|
||
|
||
このファイル自体も、今後の運用の中で少しずつ育てていくことを前提とする。
|
||
|