実践：実際の開発で使う

# ① まず方針を確認する
> Node.js + Express + SQLite で Todo アプリの REST API を作りたい。
  どんな構成で作るか方針を説明して

# ② プロジェクトの雛形を生成
> その方針で進めて。まずディレクトリ構成と
  package.json を作って

# ③ 段階的に実装
> 次に DB のスキーマと接続設定を作って
> Todo の CRUD エンドポイントを実装して
> 各エンドポイントのテストを書いて

# ④ 動作確認
> npm test を実行して、全テストが通ることを確認して

# ⑤ ドキュメント整備
> README.md と CLAUDE.md を生成して

# ① エラーログをそのまま貼り付ける
> 本番でこのエラーが出ています。原因を調べて修正して：
  UnhandledPromiseRejection: Cannot read properties of null
  at getUserProfile (src/services/userService.js:34)
  at async router.get (/api/profile) (src/routes/user.js:12)

# ② 関連ファイルを調べてもらう
> src/services/userService.js と src/routes/user.js を読んで、
  null が渡るケースを全て洗い出して

# ③ 修正と影響範囲の確認
> 修正して。他のファイルへの影響も確認して

# ④ テストを追加してリグレッションを防ぐ
> このバグに対するテストケースを追加して

# ⑤ コミット
> 変更を git commit して。メッセージは英語で

# ① 現状のコードを把握してもらう
> src/routes/posts.js の GET /posts エンドポイントを読んで
  現状の実装を説明して

# ② 要件を伝えて実装方針を確認
> このエンドポイントに page・limit のクエリパラメータで
  ページネーションを追加したい。
  デフォルトは page=1, limit=20。どう実装する？

# ③ 実装
> その方針で実装して。バリデーションも忘れずに

# ④ レスポンス形式も合わせる
> レスポンスに totalCount と totalPages も含めて

# ⑤ テストと API ドキュメントの更新
> テストを追加して、docs/api.md のエンドポイント仕様も更新して

# ① diff を見せてレビューを依頼
> git diff main...feature/user-auth を確認して、
  以下の観点でコードレビューして：
  - セキュリティ上の問題
  - パフォーマンスの問題
  - コーディング規約の違反
  - テストの網羅性

# ② 問題点の修正を依頼
> 指摘した問題を全て修正して

# ③ セキュリティの詳細チェック
> 認証・認可の実装に漏れや脆弱性がないか詳しく確認して

# GitHub MCP がある場合
> GitHub の PR #45 をレビューして、
  修正依頼コメントを各行に直接書いて

# ① CSV データの集計・レポート自動生成
> data/sales_2025.csv を読んで月別・商品別の売上を集計して
  reports/monthly_report.md にまとめて

# ② ファイルの一括整形
> logs/ フォルダの全 .log ファイルから ERROR レベルのログだけ
  抽出して errors_summary.txt に出力するスクリプトを作って

# ③ 定期実行スクリプトの作成
> 毎日深夜に DB をバックアップして S3 にアップロードする
  シェルスクリプトを書いて。cron 設定方法も教えて

# ④ API からデータ取得して通知
> GitHub API で今週クローズされた Issue 一覧を取得して
  Slack の #weekly-report チャンネルに投稿するスクリプトを作って

# ターミナル 1：フロントエンドの実装
cd my-project
claude
> src/pages/Dashboard.tsx にグラフ表示コンポーネントを追加して

# ターミナル 2（別ウィンドウ）：バックエンドの実装
cd my-project
claude
> /api/dashboard/stats エンドポイントを実装して

# ターミナル 3（別ウィンドウ）：テストの作成
cd my-project
claude
> Dashboard コンポーネントと stats API の両方のテストを書いて

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

# 3つの視点で並列調査させる例
> PR #142 をレビューするエージェントチームを作って。
  ・セキュリティの観点で確認するレビュアー
  ・パフォーマンスを確認するレビュアー
  ・テストカバレッジを確認するレビュアー
  の 3 人を用意して、それぞれの調査結果をまとめて

# 競合する仮説でデバッグする例
> このバグについて 3 つの異なる仮説でチームを組んで。
  互いの仮説を反証し合いながら、最も可能性の高い原因を特定して

my-project/
├── CLAUDE.md              # ← プロジェクト共通ルール（必ずコミット）
├── .claude/
│   └── settings.json      # ← allowedTools などの設定（コミット推奨）
└── ...

# .gitignore に追加すべきもの
.claude/credentials.json   # 個人の認証情報は含めない