59 lines
3.1 KiB
Markdown
59 lines
3.1 KiB
Markdown
## Cursor ガイド（Keina System）
|
||
|
||
> **最終更新**: 2026-02-28
|
||
> **対象**: Cursor（GPT-5.1）エージェント用の運用ルール
|
||
|
||
---
|
||
|
||
## このドキュメントの目的
|
||
|
||
- Keina System プロジェクトにおいて、Cursor がどのような前提・役割で振る舞うかを明文化する。
|
||
- Claude Code（Sonnet 系）と併用する際の、自身の立ち位置と守るべきルールを整理する。
|
||
|
||
---
|
||
|
||
## セッション開始時の読み順
|
||
|
||
Cursor は、このリポジトリで新しいセッションを開始する際に、次の順番でドキュメントを参照することを前提とする。
|
||
|
||
1. `.cursor/rules/30_Cursorガイド.md`（このファイル）
|
||
- Cursor 自身の振る舞い・運用ルールを確認し、必要に応じてアップデートする。
|
||
2. `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` にも必要な範囲で反映する。
|
||
|