Claude Code 実践ワークフロー完全ガイド｜タスクの渡し方・コンテキスト管理・アンチパターン対策

# Shift+Tab を2回押す（ターミナル上）
# → Normal → Auto-Accept → Plan Mode の順に切り替わる

# 計画をエディタで編集したい場合
# Ctrl+G でプランを外部エディタで開く

# --- Plan Mode（探索・計画） ---

あなた: "read src/auth/ and understand how we handle authentication"
Claude: [ファイルを読み込んで現状を説明]

あなた: "I want to add Google OAuth login. What files need to change?
         What's the implementation flow? Create a detailed plan."
Claude: [変更ファイル一覧・手順・懸念点を計画として提示]

# --- Normal Mode（実装） ---
# → Shift+Tab でモード切り替え

あなた: "implement the Google OAuth flow from your plan.
         write unit tests for the callback handler.
         run the test suite and fix any failures."
Claude: [実装・テスト実行・修正]

あなた: "commit with a descriptive message and create a draft PR"
Claude: [コミット・PR作成]

あなた: "I'm seeing this error when I run npm test:
         TypeError: Cannot read property 'id' of null
         at /src/user.ts:45
         [エラー全文をペースト]"

Claude: [エラーの原因を分析]

あなた: "suggest a few ways to fix the null check in user.ts"
Claude: [修正案を3種類提示・推奨案を説明]

あなた: "implement option 2. write a test that reproduces the bug first,
         then fix it, then run all tests"
Claude: [テスト追加→修正→テスト実行]

# 基本（自動でコンテキスト全体を圧縮）
/compact

# フォーカス指定（特定の内容に絞って圧縮）
/compact Focus on the authentication changes only
/compact Keep only the final implementation, discard debug attempts

# 起動時に名前をつける
claude -n "auth-refactor"

# セッション中に名前をつける
/rename auth-refactor

# 後で再開する
claude --resume auth-refactor

# セッション一覧から選んで再開
claude --resume
# または /resume コマンド

# プロジェクト名

## 概要
〇〇システムのバックエンドAPI。詳細は @README.md を参照。

## よく使うコマンド
開発: `npm run dev`
テスト: `npm test`
利用可能なコマンド全体は @package.json を確認。

## コード規約
@docs/coding-standards.md を参照。

## Git ワークフロー
@docs/git-instructions.md を参照。

./CLAUDE.md               # グローバル共通（リポジトリ全体のルール）
./backend/CLAUDE.md       # バックエンド固有（API設計・DB接続等）
./frontend/CLAUDE.md      # フロントエンド固有（コンポーネント規約・状態管理等）
./mobile/CLAUDE.md        # モバイル固有

# 別々のターミナルで実行
# ターミナル1
claude --worktree feature-oauth    # feature-oauthブランチで作業

# ターミナル2
claude --worktree bugfix-timeout   # bugfix-timeoutブランチで作業

# 作業が完了したらメインブランチにマージ