初めての人 — 5ステップで始める

1. Step 1 — ツールを1本

   Cursor / Claude Code / Codex から1本。迷ったら Cursor。

2. Step 2 — 3段フロー

   たたき台 → ルール → プラン の順。AI に仕様を推測させない。

3. Step 3 — ルールを置く

   .cursor/rules/ または CLAUDE.md。サンプル をコピーし、テストコマンドと git 方針を書き換える。

4. Step 4 — 小タスクで試す

   1日以内の修正1件で Plan → 実装 → 検証まで。

5. Step 5 — 困ったら章を開く
   • PRD 合意 → 要件定義
   • 新規リポ → 規約整備
   • 大きい機能 → Phase 地図

3段フロー（通常はこれだけ）

1. たたき台
   • 何を・なぜ・やらないこと（Won't）・制約を人間が書く
   • AI に「だいたいこんな感じ」と推測させない

   Issue 1段落（汎用）

   注文完了時に購入者へ確認メールを送る。

   • Must: 既存のメール送信機能を使い、非同期（キュー）で送る。
   • Won't: テンプレエディタ UI・HTML メールの新規デザインは作らない。
   • 制約: プロジェクトのテストコマンドで検証、本番デプロイは別 PR。

2. ルール

   たたき台から、AI が毎回守るルール案を作る。

   • 禁止事項・参照パス・検証手順を明文化する
   • 配置例
     • Cursor: .cursor/rules/
     • Claude Code: CLAUDE.md
     • Codex: AGENTS.md
   • テンプレの丸写しは避ける
3. プランと ADR
   • タスク分解・リスク・完了条件を Plan に書く
   • 設計の「なぜ」は docs/adr/NNNN-タイトル.md に1段落で残す（11.7 ADR のテンプレに Context / Decision / Consequences を書く）
   • Cursor: Plan モード（Shift+Tab）→「Save to workspace」→ .cursor/plans/
   • 実装依頼時は ADR + Plan を先頭で読み込ませる

   tasks/todo.md

   • - [ ] メールテンプレ追加
   • - [ ] 送信ジョブ実装
   • - [ ] 結合テスト

   Done when: rspec spec/mailers/order_mailer_spec.rb が green。

   リスク: 既存 Mailer との二重送信 → 送信前に idempotency キーを確認。

   ADR: ジョブキューに載せる理由を docs/adr/0012-mail-via-queue.md に1段落（テンプレ参照）。

よくあるつまずき

• Plan モードが見つからない — Cursor の Composer で Shift+Tab を切り替え。ルール/プラン 参照。
• ルールが効かない — ファイルパスと alwaysApply を確認。Phase 1 · サンプル。
• 用語がわからない — 用語集（初見10語） から。

ベストプラクティス早見

• Rules / Skills / Plan — いつ Plan モードか、Skills をいつ足すか
• エージェント運用 — 会話の管理・検証・別 AI への任せ方
• AIツール — Cursor / Claude Code / Codex の操作