ソロ開発者のための大規模プロジェクト向け二段階プロンプト手法：Claude AI活用

ワークフロー構造

開発者は、厳密に分離された2つのClaudeツールを使用しています：Claude Chatはアーキテクトとしてすべてのプロンプトを設計し、Claude Codeはビルダーとしてそれらのプロンプトを実行します。開発者は、これらの役割を決して交差させないことを強調しており、Codeが自身の作業を設計した際に、隠れた品質問題、テストのスキップ、機能性に関する虚偽の主張などの問題を経験しています。

2段階プロンプト手法

Claude Codeに送信されるすべてのプロンプトは、2つの段階を経ます：

• フェーズ1： Claude Chatはドメインエキスパートとしてプロンプト内容を作成します - 何を、どの順序で、どのような制約で行う必要があるかを指定します。
• フェーズ2： Claude Chatは「AI信頼性エンジニア」としてプロンプトを書き直し、タスクの特定の障害モードを特定し、印刷された証明（単なる「テスト合格」ではない）を必要とする検証ゲート、アンチショートカットルール、ロールバック計画、バッチ操作前の単一ファイル操作、編集後の再読み込み要件、変更前のバックアップゲートなどの緩和策を組み込みます。

引き継ぎプロセス

Claude ChatはClaude Codeと直接話せないため、開発者はプロンプトを引き継ぎフォルダにコピーし、Codeに貼り付けます。この摩擦は、それをスキップするリスクと比較して必要であると考えられています。

基本ルール

• 1つのプロンプトは1つの目的に等しい - タスクを決して束ねない
• すべてのプロンプトは、Codeが採用すべき正確な役割を指定します。「シニア開発者」のような一般的な役割ではなく、特定の専門知識の組み合わせです
• 記憶からの状態を決して仮定しない - 実際のファイルに対して検証する
• Codeはすべてのセッション開始時にプロジェクトのCLAUDE.mdファイルを読み、完全なコンテキストを取得します
• Chatは解決策を提案する前に診断質問をします
• 会話中に範囲が拡大した場合、Chatは組み込むか延期するかを確認します
• プロンプトにコミット指示を含めない - 代わりに「作業が検証されたときにコミットチェックポイントを提案してください」を使用します
• すべてのプロンプトはファイル引き継ぎチェックリストで終わります
• 速度を犠牲にしてでも注意を払う - 常に

プロンプト前の質問

プロンプトを作成する前に、開発者はClaudeに3つの質問に答えさせます：

1. この特定のタスクに最適な役割と理想的な特性は何ですか？
2. このタスクのあらゆる可能な障害モードは何ですか？それぞれをどのように緩和しますか？
3. 私は全力で取り組んでいますか、それとも急いでいますか？

これが機能する理由

開発者は、Claudeは優れた実行者になり得るが、信頼性の低い自己監督者であることを発見しました。Codeが自身のプロンプトを設計すると、品質ではなく完了を最適化します。Chatが組み込み障害防止機能を備えたプロンプトを設計すると、Codeは一貫して成果を出します。プロセス内の追加の摩擦は、欠陥ではなく機能と見なされています。