3ツール早見 — 共通と選び方
Cursor / Claude Code / Codex の共通 Plan とツール選び。
3ツール早見（Cursor / Claude Code / Codex）
メインツール別 — 設定の置き場
- Cursor — IDE で diff を見ながら日常実装・Plan（2章: 複雑な機能・デバッグ・大規模リファクタ）
- Claude Code — ターミナルで長時間自律・CI 調査（2章: 長時間自律タスク）
- Codex — Issue / クラウド PR・ルーチン並列（2章: ルーチン修正の並列）。ローカル CLI も可
| ツール | Rules | 手順 | Plan 正本 | 手順集 |
|---|---|---|---|---|
| Cursor | .cursor/rules/*.mdc | .cursor/commands/ · Skills | tasks/todo.md + .cursor/plans/ | 初期設定 · 作業手順 |
| Claude Code | CLAUDE.md | .claude/skills/ · Hooks | tasks/todo.md | 初期設定 · 作業手順 |
| Codex | AGENTS.md（階層） | .agents/skills/ · MCP | tasks/todo.md | 初期設定 · 作業手順 |
公式（一次情報リンク）
| ツール | 一次情報 |
|---|---|
| Cursor | エージェント BP · Rules · Skills · Commands |
| Claude Code | Best practices · Extend · Hooks |
| Codex | AGENTS.md |
| 標準 | Agent Skills — 詳細は BP 参照表（Cursor 章） |
状況別 — 何をするか（3ツール共通）
flowchart LR
planNode[Plan] --> askNode[依頼]
askNode --> implNode[実装]
implNode --> verifyNode[検証]
verifyNode --> doneNode[完了]
Plan — tasks/todo.md または Plan モードに Done when まで書く。依頼 — 対象ファイルと検証コマンドを渡す。完了 — テスト結果等の証拠を添え、仕様は docs/ に残す（チャットだけにしない）。
| 状況 | 操作 | Cursor | Claude Code | Codex |
|---|---|---|---|---|
| 3ステップ以上の作業を始める前 | Plan をファイル化 | Shift+Tab Plan → /plan | Plan モード → tasks/todo.md | Issue + tasks/todo.md |
| 会話が長くなった・別の機能に移るとき | コンテキストを切る | 新規 + @Past Chats（前の会話を参照） | 新規 + /resume（必要時） | 新規スレッド + todo |
| 変更内容をレビューするとき | ブランチ文脈 | @Branch | git diff を渡す | PR / ブランチ指定 |
| 作業を終えるとき | 検証を示す | /verify | テストコマンド + /goal | 承認前に diff 確認 |
| 同じミスがまた起きたとき | ルール 1 条追加 | .cursor/rules/ | CLAUDE.md 1 行 | AGENTS.md 1 行 |
委譲・並列: マルチエージェント · プロンプト例: プロンプト設計
共通の土台
共通: Plan・docs・AGENTS.md
手順: Plan 正本を置く
- リポ直下に
tasks/を作成（無ければ） tasks/todo.mdを作成（下記テンプレをコピー）- 各タスクに 終わりの条件（Done when）（検証コマンド or 手動確認）を 1 行ずつ書く
- 仕様は
docs/<feature>/01_requirements.mdへ（Rules に複製しない）
## タスク
- [ ] 要件確認 — Done when: docs/invoice-export/01_requirements.md レビュー済
- [ ] 実装 — Done when: `docker compose exec app bundle exec rspec spec/services/invoice_export_spec.rb`
- [ ] PR — Done when: /pr-check 9 カテゴリすべて [x]
## Plan メモ
- リスク: 在庫不足時のエラー型は ErrInsufficientStock に統一
docs/
├── adr/016-pdf-async.md
└── invoice-export/
├── 01_requirements.md
└── 02_design.md