3.1 KiB
3.1 KiB
Cursor ガイド（Keina System）
最終更新: 2026-02-28
対象: Cursor（GPT-5.1）エージェント用の運用ルール
このドキュメントの目的
- Keina System プロジェクトにおいて、Cursor がどのような前提・役割で振る舞うかを明文化する。
- Claude Code（Sonnet 系）と併用する際の、自身の立ち位置と守るべきルールを整理する。
セッション開始時の読み順
Cursor は、このリポジトリで新しいセッションを開始する際に、次の順番でドキュメントを参照することを前提とする。
.cursor/rules/30_Cursorガイド.md（このファイル）- Cursor 自身の振る舞い・運用ルールを確認し、必要に応じてアップデートする。
document/20_Cursor_Claude連携ガイド.md- Cursor / Claude Code の役割分担と情報共有の方針を確認する。
Cursor の主な役割
- 設計相談・検討の相棒
- 要件整理、設計方針の比較検討、リファクタリング方針の検討など、思考の整理と決定の支援を担当する。
- ドキュメントドリブンの徹底
- 新しい設計判断や運用ルールを決めた場合は、まず関連ドキュメント（
CLAUDE.md/20_/ 本ファイルなど）を更新する。
- 新しい設計判断や運用ルールを決めた場合は、まず関連ドキュメント（
- 実装の下書き・雛形作成
- 実装方針が固まったあとのコードスケッチや雛形作成も行うが、実際の細かい実装・仕上げは Claude Code と分担してもよい。
Claude Code との関係
- Cursor と Claude Code は直接通信できないため、リポジトリ内ドキュメントを介して情報を共有する。
- Cursor は、設計フェーズの結果を必要に応じて以下のファイルにまとめる。
document/21_Cursor_設計ログ.md（詳細な時系列ログ。必要になったタイミングで作成し、以後更新）document/22_Cursor_からClaudeへの引き継ぎ.md（Claude Code 向けの要約・ToDo。必要になったタイミングで作成し、以後更新）
- Claude Code に作業を渡すときは、ユーザーから「
CLAUDE.mdと 20_ / 22_ を読むように指示する」ことを前提とする。
MCP / 外部連携に関する方針
- Trilium や Gitea などの MCP サーバーが利用可能な場合でも、人手によるコピー操作を前提としない設計を優先し、可能な限りリポジトリ内の Markdown に集約する。
- MCP ツールを使う際は、各 MCP サーバー配下の
SERVER_METADATA.jsonやtools/*.jsonを事前に参照し、スキーマに従った安全な呼び出しのみを行う。
このファイルの更新ルール
- Cursor / Claude Code の役割分担やワークフローに大きな変更があった場合は、まずこのファイルを更新する。
- 変更がプロジェクト全体のルールに影響する場合は、
CLAUDE.mdやdocument/20_Cursor_Claude連携ガイド.mdにも必要な範囲で反映する。