Claude Code 覚醒ワークフロー：PSBメソッド
AIは「書き始める」のは得意ですが、「全体像を維持する」のは苦手です。このフローは、人間の脳を設計（Architecture）に、AIのパワーを実行（Execution）に集中させるための戦略です。
① Plan（計画）：AIに「逆質問」をさせる
初心者は「〇〇を作って」と指示しますが、プロは「〇〇を作りたいから、不足している情報を聞き出して」と頼みます。
- ゴール設定: 「何を作るか」だけでなく、「何をしないか（スコープ外）」を定義する。
- AIへの逆質問:
「この要件を実現する上で、設計上の懸念点や、事前に決めておくべき仕様を3つ挙げてください」と入力する。 - 手戻りの防止: 最初に論理的な矛盾（DB設計のミスやAPIの制限など）を潰すことで、後半の「コードの書き直し」を防ぎます。
② Setup（設定）：AIのための「外部メモリ」を作る
Claude Codeの記憶力（コンテキスト）には限界があります。これを補うのがドキュメントの自動更新です。
- CLAUDE.md（最重要）:プロジェクトの憲法です。技術スタック、命名規則、特定のライブラリの使用禁止などを記します。Claude Codeはこれを優先的に読み込みます。
- 状態管理ファイル:
architecture.md: 現在の構造。project-status.md: 何が終わって、次は何をするか。changelog.md: どんな変更をしたか。
- 自動化: Claude Codeに対し、
「タスクが完了するたびに、project-status.md を更新してください」と指示することで、数日後に作業を再開してもAIが即座に状況を把握できます。
③ Build（構築）：小さな単位で「捨てる」前提で進める
いきなり巨大な機能を一気に作らせるのは、AIが迷子になる原因です。
- Issueベースの開発: 「ログイン機能を作る」ではなく、「ログイン画面のUIを作る」「認証APIを叩く」「エラーハンドリングを追加する」と細分化して1つずつ命じます。
- 「コードは安い」の精神: AIが生成したコードが複雑になりすぎたら、修正を繰り返すのではなく「一度消して、別の構成で作り直して」と指示する方が速い場合が多いです。
- 並列処理（MCPの活用）: 外部ツールや検索機能を連携させ、最新のドキュメントを参照させながら構築します。
他の補足ポイント
類似のAIエージェント活用術（CursorやWindsurfのコミュニティ等）で推奨されている「さらに効率を上げるコツ」を補足します。
| 項目 | 内容 |
|---|---|
| TDD（テスト駆動） | 先にテストコードを書かせることで、AIの出力が正しいかを自動判定させる。 |
| .claudignore | 不要なログやビルドファイル、node_modulesをAIに読ませない（消費トークンの節約と混乱防止）。 |
| One-shot Prompting | 理想的なコードのサンプルを1つ提示し、「このスタイルで書いて」と基準を示す。 |
今日から使える具体的なアクション
まずは、新しいプロジェクトで以下のコマンドから始めてみてください。
touch CLAUDE.mdで設定ファイルを作る。- Claude Codeを起動し、最初にこう伝えてください：「今から〇〇を開発します。まず、私が提供した要件に対して設計上の懸念点や不足している情報を3つ質問してください。その後、CLAUDE.mdとarchitecture.mdを作成し、ステップバイステップで進めます。」
