GitHub Copilot設計者の知見が示す「プロンプト設計の3層構造」
『LLMのプロンプトエンジニアリング』（John Berryman, Albert Ziegler 著）は、GitHub Copilot の設計者が書いたプロンプト設計論だ。モデル非依存の原則として「コンテキスト」「スカフォールディング」「テンプレート化」という3つの概念を軸に構成されている。
私はこの本を読んで、自分が Claude Code でサイト構築する際に「なんとなく」やっていた操作が、実は体系的に整理できることに気づいた。以下、38歳個人事業主+法人併営という立場で実際に運用している3段階設計を記録する。
第1段階：コンテキスト設計——「何を渡すか」の判断基準
コンテキストとは、プロンプトに添付する「前提情報」のこと。Claude Code では @ファイル名 や @フォルダ名 でコンテキストを渡すが、ここで重要なのは「何を渡すか」の判断基準だ。
私が運用している基準は次の3つ：
- 直接参照するファイルのみ渡す：例えば「この記事のメタデータを更新して」なら該当の
.mdファイルだけを@する。関連ファイルを総ざらいで渡すと、Claude が迷走する - 設定ファイルは毎回渡す：
tsconfig.jsonやastro.config.mjsは、コード生成の制約条件として毎回@する。これを省くと、後で型エラーやビルドエラーが出る - 過去の失敗履歴は積極的に渡す：「前回このパターンで失敗した」という履歴を
.mdに記録しておき、同じ作業をするときに@する。Claude は過去ログから学習できないが、コンテキストとして渡せば同じミスを回避できる
この「渡す情報の取捨選択」を意識するだけで、Claude の回答精度が体感で3割は上がった。
第2段階：スカフォールディング——「段階的に組み立てる」設計
スカフォールディング（足場）とは、複雑なタスクを小さなステップに分解し、段階的に構築していく手法だ。Claude Code でコードを書くときも、一発で完成形を求めるのではなく、「まず型定義だけ作る→次にロジック部分を書く→最後にエラーハンドリングを追加する」という順序で組み立てる。
私が実際にやっている分解パターンは次の3段階：
- 型定義・インターフェース設計：「このコンポーネントの型を定義して」とだけ指示し、まず
.tsの型部分だけを作る。ここで全体の構造を固める - 最小動作の実装：「この型に基づいて、最小限動くコードを書いて」と指示し、エラーハンドリングや例外処理は後回しにする。まず「動く骨格」を作る
- エッジケース対応：「空配列のときの挙動を追加して」「エラー時のフォールバック処理を書いて」と個別に指示し、段階的に完成度を上げる
この段階分解を意識すると、Claude が「何をどこまで書けばいいか」を迷わなくなる。一度に全部を求めると、Claude は「全体的にそれっぽいが細部が雑」なコードを出力しがちだが、段階的に組むと「各ステップで確実に動くコード」が積み上がる。
第3段階：テンプレート化——「繰り返し使う指示」を定型化する
テンプレート化とは、頻繁に使うプロンプトを定型文として保存し、再利用可能にすることだ。私は「記事生成」「型定義」「コンポーネント作成」「デプロイ前チェック」の4種類をテンプレート化している。
例えば「記事生成テンプレート」は次のような構造：
# 記事生成指示テンプレート
@著者事実台帳.md @読了書籍リスト.md を参照し、以下の条件で記事を生成してください：
- カテゴリ: [指定]
- 文字数: 1500〜2500字
- 構成: リード文 → H2見出し3〜5個 → まとめ
- 必須要素: 書籍引用1冊以上、Amazon+楽天リンク併記
- 禁止事項: 未実施の収益化実績を書かない、数字の断定は出典を示すこのテンプレートを .md ファイルとして保存しておき、記事を作るたびに @記事生成テンプレート.md として呼び出す。これにより、毎回同じ条件を打ち込む手間が省ける。
テンプレート化のメリットは「再現性の確保」と「指示の抜け漏れ防止」の2つ。特に法人運営と個人事業を併営している立場では、「どちらの文脈で書くか」を毎回意識する必要があるが、テンプレートに条件を埋め込んでおけば、文脈の混同を防げる。
運用して見えた「プロンプト設計の実務線引き」
この3段階設計を2ヶ月運用して、実務的な線引きが見えてきた：
- コンテキストは「必要最小限」を守る：渡しすぎると Claude が迷走するが、渡さなすぎると的外れな回答が返る。判断基準は「このファイルがないと回答できないか？」
- スカフォールディングは「3ステップまで」：分解しすぎると逆に手間が増える。「型→最小実装→エッジケース」の3段階が実務的に最適
- テンプレートは「週1回見直す」：運用しながら「この条件は毎回同じだな」と気づいたものを追加していく。最初から完璧なテンプレートは作れない
この3段階設計により、Claude Code での作業効率は体感で2倍になった。特に「同じミスを繰り返さない」「指示の抜け漏れを防ぐ」という2点で、業務の安定性が上がった。
まとめ：プロンプト設計は「何を渡し、どう分解し、どう定型化するか」の3段階
『LLMのプロンプトエンジニアリング』が示す「コンテキスト・スカフォールディング・テンプレート化」の3概念は、Claude Code 運用の実務設計そのものだった。
38歳個人事業主+法人併営という立場で、限られた時間の中で業務効率を上げるには、「何を自動化し、何を手動で制御するか」の線引きが重要だ。この3段階設計は、その線引きを明確にするための実務的な枠組みとして機能している。
関連書籍
LLMのプロンプトエンジニアリング
GitHub Copilot設計者によるプロンプト設計論。コンテキスト・スカフォールディング・テンプレート化の概念地図がClaude Code運用にそのまま応用できる。