準備編で作成した設計書をもとに、Claude Code で効率的に開発を進めるための実践的なコツをまとめました。
Explore → Plan → Code → Commit の4段階的アプローチを中心とした、ベストプラクティスです。
1. 段階タスク開発アプローチの基本
推奨される開発サイクル
Claude Codeで最も効果的なのは、以下の4段階的アプローチです：
- Explore（探索・理解）: プロジェクトの現状と要件を深く理解
- Plan（計画・設計）: ultrathink を使った詳細設計
- Code & Test（実装・テスト）: 実装と動作確認
- Commit（記録・次準備）: Git記録と次タスクへの準備
なぜ4段階に分けるのか？
❌ 一括指示の問題:
「タスクを実行してください」
→ 曖昧で方向性がブレやすい
→ エラー時の原因特定が困難
✅ 段階的アプローチの効果:
各段階で確実に理解・設計・実装・記録
→ 高精度な成果物
→ 問題の早期発見と解決
2. Task単位での指示パターン
📍 推奨指示パターン
# 新しいセッション開始
claude
プロジェクト名：[プロジェクト名]
Task X.X: [機能名] を開始します。
--------
**Task X.X.1: Explore（探索・理解）**
以下のドキュメントを読んで、Task X.Xの要件を深く理解してください：
- @CLAUDE.md # プロジェクト統括設定（最初に読む）
- @docs/01_requirements.md # 要件定義書
- @docs/02_architecture.md # システム設計書
- @docs/03_development-workflow.md # 開発/テスト方針（段階的テストとログ記録の徹底）
- @docs/10_tasks.md # 開発タスク・ロードマップ
- @logs/ERRORLOG.md # 過去の類似エラーの確認
- @logs/PATTERNS.md # 関連する知見・パターンの確認
**重要**: この段階ではコードは書かないでください。理解に専念してください。
完了後、Task X.X.2に進んでください。
--------
**Task X.X.2: Plan（計画・設計）**
ultrathink を使って Task X.Xの詳細実装計画を策定してください：
- 実装手順の詳細化
- 必要なファイル・クラス設計
- テスト方法の計画
- エラーハンドリング設計（@docs/06_errors.md 参照）
必要に応じて以下のコマンドを活用してください：
```
/superpowers:brainstorm # ブレインストーミング（要件整理・アイデア出し）
/superpowers:write-plan # 実装計画の詳細化
```
完了後、Task X.X.3に進んでください。
--------
**Task X.X.3: Code & Test（実装・テスト）**
必要に応じて以下のコマンドを活用してください：
```
/superpowers:execute-plan # 計画の実行（TDD駆動）
```
計画に従って実装と動作確認を行ってください：
**実装**：
- 機能コードの実装
- エラーログの記録
**動作確認：**
- シンタックスチェック
- 完了後、実環境で起動して動作確認を行います。確認用のデバッグ機能を作成してください。
完了後、Task X.X.4に進んでください。
--------
**Task X.X.4: Record & Commit（記録・コミット）**
**ドキュメント同期**：
- /docs-sync # Slash Command
**開発日誌**：
- /devlog Task X.X: [機能名] # Slash Command
**ドキュメント更新**：
- @logs/CHANGELOG.md # 実装内容・進捗状況の記録
- @logs/ERRORLOG.md # エラー・問題解決策の記録
- @logs/PATTERNS.md # 新しい知見・コーディングパターンの記録
- @logs/devlog/YYYY-MM-DD_TaskX.X_[機能名].md # 詳細な振り返り
**Self-Improvement**：
今回のタスクでユーザーから修正・指摘を受けた場合は、必ず以下を記録してください：
- 同じミスを繰り返さないためのルールを `@logs/PATTERNS.md` に追記
- エラー・問題の根本原因と解決策を `@logs/ERRORLOG.md` に追記
**Git commit実行**：
```bash
git add .
git commit -m "feat: Task X.X: [実装内容の要約]"
git push origin main
```
「Task X.X: [機能名] → ✅完了」と報告してください。
開始してください。
3. セッション管理のベストプラクティス
Task単位でのセッション管理
# 新しいセッションを開始
claude
**Phase 1: コアロジック開発**
- Task 1.1: プラグイン基盤構築
- Task 1.1.1: Explore（探索・理解）
- Task 1.1.2: Plan（計画・設計）
- Task 1.1.3: Code & Test（実装・テスト）
- Task 1.1.4: Record & Commit（記録・コミット）
# 現在のセッションを終了
exit
# Task 1.2用の新セッションを開始（前回の履歴を参照）
claude --resume
- Task 1.2: データベース設計・実装
- Task 1.2.1: Explore（探索・理解）
- Task 1.2.2: Plan（計画・設計）
- Task 1.2.3: Code & Test（実装・テスト）
- Task 1.2.4: Record & Commit（記録・コミット）
なぜTask単位なのか？
✅ Task単位セッションの利点：
- 文脈の連続性：Explore → Plan → Code → Commitが一つの流れ
- 適切なメモリ使用：1Task 約10,000-15,000トークンで管理可能
- 効率的なエラー処理：同セッション内で設計を参照して迅速修正
claude --resume を使う理由
✅ claude --resume の利点：
- 前回のTaskの成果を参照可能
- プロジェクト全体の流れを把握
- 設定や決定事項の継承
Alternative: 同一セッション継続も可能
もし現在のセッションのコンテキストがまだ余裕があれば、そのまま継続も可能です：
🎯 推奨判断基準
Context left: 7% → 新しいセッション推奨
Context left: 20%以上 → 継続可能
Context left: 10-20% → Task内容の複雑さで判断
4. 中断からの効率的な再開方法
📍 セッション再開時の指示パターン
# 新しいセッションを開始（前回の履歴を参照）
claude --resume
**現在の状況**：
プロジェクト名：[プロジェクト名]
- Phase 1: コアロジック開発 → ✅完了
- Phase X: GUI開発
- Task X.1: 管理画面基盤 → ✅完了
- Task X.2: タグ管理画面 → ✅完了
- Task X.X: [機能名] → 🔄中断
前回からの作業を再開し、Task X.X: [機能名] を開始します。
--------
**Task X.X.1: Explore（探索・理解）**
以下のドキュメントを読んで、Task X.Xの要件を深く理解してください：
- @CLAUDE.md # プロジェクト統括設定（最初に読む）
- @docs/01_requirements.md # 要件定義書
- @docs/02_architecture.md # システム設計書
- @docs/03_development-workflow.md # 開発/テスト方針（段階的テストとログ記録の徹底）
- @docs/10_tasks.md # 開発タスク・ロードマップ
- @logs/ERRORLOG.md # 過去の類似エラーの確認
- @logs/PATTERNS.md # 関連する知見・パターンの確認
**重要**: この段階ではコードは書かないでください。理解に専念してください。
完了後、Task X.X.2に進んでください。
--------
**Task X.X.2: Plan（計画・設計）**
ultrathink を使って Task X.Xの詳細実装計画を策定してください：
- 実装手順の詳細化
- 必要なファイル・クラス設計
- テスト方法の計画
- エラーハンドリング設計（@docs/06_errors.md 参照）
必要に応じて以下のコマンドを活用してください：
```
/superpowers:brainstorm # ブレインストーミング（要件整理・アイデア出し）
/superpowers:write-plan # 実装計画の詳細化
```
完了後、Task X.X.3に進んでください。
--------
**Task X.X.3: Code & Test（実装・テスト）**
必要に応じて以下のコマンドを活用してください：
```
/superpowers:execute-plan # 計画の実行（TDD駆動）
```
計画に従って実装と動作確認を行ってください：
**実装**：
- 機能コードの実装
- エラーログの記録
**動作確認：**
- シンタックスチェック
- 完了後、実環境で起動して動作確認を行います。確認用のデバッグ機能を作成してください。
完了後、Task X.X.4に進んでください。
--------
**Task X.X.4: Record & Commit（記録・コミット）**
**ドキュメント同期**：
- /docs-sync # Slash Command
**開発日誌**：
- /devlog Task X.X: [機能名] # Slash Command
**ドキュメント更新**：
- @logs/CHANGELOG.md # 実装内容・進捗状況の記録
- @logs/ERRORLOG.md # エラー・問題解決策の記録
- @logs/PATTERNS.md # 新しい知見・コーディングパターンの記録
- @logs/devlog/YYYY-MM-DD_TaskX.X_[機能名].md # 詳細な振り返り
**Self-Improvement**：
今回のタスクでユーザーから修正・指摘を受けた場合は、必ず以下を記録してください：
- 同じミスを繰り返さないためのルールを `@logs/PATTERNS.md` に追記
- エラー・問題の根本原因と解決策を `@logs/ERRORLOG.md` に追記
**Git commit実行**：
```bash
git add .
git commit -m "feat: Task X.X: [実装内容の要約]"
git push origin main
```
「Task X.X: [機能名] → ✅完了」と報告してください。
開始してください。
📍 エラー修正時の指示パターン
# 新しいセッションを開始（前回の履歴を参照）
claude --resume
**現在の状況**：
プロジェクト名：[プロジェクト名]
- Phase 1: コアロジック開発 → ✅完了
- Phase X: GUI開発
- Task X.1: 管理画面基盤 → ✅完了
- Task X.2: タグ管理画面 → ✅完了
- Task X.X: [機能名] → 🔄中断
Task X.X: [機能名]で、エラーが出ています。
```
**エラー内容**
```
以下のドキュメントを読んで、エラー内容の分析と修正を行なってください。：
--------
**Task X.X.1: Explore（探索・理解）**
以下のドキュメントを読んで、Task X.Xの要件を深く理解してください：
- @CLAUDE.md # プロジェクト統括設定（最初に読む）
- @docs/01_requirements.md # 要件定義書
- @docs/02_architecture.md # システム設計書
- @docs/03_development-workflow.md # 開発/テスト方針（段階的テストとログ記録の徹底）
- @logs/CHANGELOG.md # 修正記録
- @logs/ERRORLOG.md # 過去の類似エラーの確認
- @logs/PATTERNS.md # 関連する知見・パターンの確認
**重要**: この段階ではコードは書かないでください。理解に専念してください。
完了後、Task X.X.2に進んでください。
--------
**Task X.X.2: Plan（計画・設計）**
ultrathink を使って Task X.Xの詳細修正計画を策定してください：
- 修正手順の詳細化
- 必要なファイル・クラス設計
- テスト方法の計画
- エラーハンドリング設計（@docs/06_errors.md 参照）
必要に応じて以下のコマンドを活用してください：
```
/superpowers:brainstorm # ブレインストーミング（要件整理・アイデア出し）
/superpowers:write-plan # 修正計画の詳細化
```
完了後、Task X.X.3に進んでください。
--------
**Task X.X.3: Code & Test（修正・テスト）**
必要に応じて以下のコマンドを活用してください：
```
/superpowers:execute-plan # 計画の実行（TDD駆動）
```
計画に従って修正と動作確認を行ってください：
**修正**：
- 機能コードの修正
- エラーログの記録
**動作確認：**
- シンタックスチェック
- 完了後、実環境で起動して動作確認を行います。確認用のデバッグ機能を作成してください。
完了後、Task X.X.4に進んでください。
--------
**Task X.X.4: Record & Commit（記録・コミット）**
**ドキュメント同期**：
- /docs-sync # Slash Command
**開発日誌**：
- /devlog Task X.X: [機能名] # Slash Command
**ドキュメント更新**：
- @logs/CHANGELOG.md # 修正内容・進捗状況の記録
- @logs/ERRORLOG.md # エラー・問題解決策の記録
- @logs/PATTERNS.md # 新しい知見・コーディングパターンの記録
- @logs/devlog/YYYY-MM-DD_TaskX.X_[エラー内容]修正.md # 詳細な振り返り
**Self-Improvement**：
今回のタスクでユーザーから修正・指摘を受けた場合は、必ず以下を記録してください：
- 同じミスを繰り返さないためのルールを `@logs/PATTERNS.md` に追記
- エラー・問題の根本原因と解決策を `@logs/ERRORLOG.md` に追記
**Git commit実行**：
```bash
git add .
git commit -m "feat: Task X.X: [修正内容の要約]"
git push origin main
```
「Task X.X: [エラー内容]修正 → ✅完了」と報告してください。
開始してください。
5. 効率化のコツとまとめ
効率化テクニック
-
事前準備の完璧化：
- CLAUDE.md、requirements.md、architecture.md、tasks.mdの完備
- Task依存関係の明確化
-
段階的アプローチの徹底：
-
セッション管理の最適化：
- Task単位でのセッション管理
- claude --resume での効率的な継続
品質確保テクニック
-
段階的品質管理：
- 各Task段階での確認
- 統合テストでの最終確認
-
エラー対処の体系化：
- 中断箇所の明確化
- 再開手順の標準化
-
ドキュメント連携：
- 設計書との整合性確保
- 進捗のリアルタイム更新
成功のコツ
- 明確性が最優先：何を、どこまで、どの順番で
- 段階的アプローチの確実な実行
- Task単位管理：適切な粒度でのセッション管理
- 継続性の確保：中断時の効率的な再開方法
このアプローチにより、Claude Codeでの開発効率と品質が向上します。
Vibe Codingのワークフロー 実行編2 - Claude Codeに「Serena」を導入する
