【結論】設計品質を上げるPlan Modeと設計書生成
Claude Codeでシステム設計を行う際は、最初から実装させず、要件・制約・未確定事項を整理してから設計書を生成させます。
設計はAIへ丸投げする作業ではなく、仮説を可視化して人間が承認するレビュー工程として使うのが安全です。
# ターミナルで対象プロジェクトへ移動
cd ~/projects/my-app
# Plan ModeでClaude Codeを起動
claude --permission-mode plan具体的な手順・設定方法
要件、非機能要件、既存システムとの境界をrequirements.mdへ記録します。
Plan Modeで影響範囲、代替案、判断理由を出させます。
承認した内容だけをdocs/design.mdへ保存し、Mermaidの構文と実装可能性を検証します。
# ターミナルで設計資料の存在を確認
test -f requirements.md && echo 'requirements found'
# 起動後のセッション内で実行
/context実践プロンプト / 活用テクニック
設計案には前提、代替案、採用理由、リスク、検証方法を必ず含めます。
Mermaid図だけでなく、API境界、データ所有者、障害時の挙動も文章で残します。
requirements.mdを読み、ユーザー認証機能の設計案を作成してください。
実装は行わず、候補を2案比較してください。
各案についてデータフロー、脅威、移行手順、ロールバック条件を示してください。
最後に未確定事項を質問リストとして出力してください。注意点・よくあるエラーと対処法
Claude Codeは要件に書かれていない業務ルールを推測する場合があります。
外部サービスの仕様、料金、上限、暗号方式は必ず公式資料で再確認してください。
巨大なリポジトリを一括解析するより、対象ディレクトリと設計観点を限定し、必要に応じてSubagentへ調査だけを委任すると精度を保てます。