Claude Codeで成果が出る依頼ブリーフ: 初心者が最初に渡すべき情報

なぜこの手順が必要か

初心者がClaude Codeでつまずく原因は、プロンプトの文才ではありません。多くの場合、目的、守るべきファイル、壊してはいけない導線、完了条件が足りません。依頼ブリーフを先に渡すと、Claude Codeは大きな推測を減らし、最初の一手を小さくできます。

あわせて読むと、流れを作りやすくなります: 初回タスク実行ガイド, プロンプトライブラリの育て方, CLAUDE.mdスターターテンプレート。

実務で使う手順

最初にゴールを一文にします。次に、対象ファイル、読者、ビジネス上の理由を書きます。最後に触ってはいけない領域、残すべきGumroadリンク、証明コマンドを明記します。この順番なら、会話が長くなる前に安全な境界ができます。

コピペできる最小セット

# Claude Code task brief

## Goal
Change one clear thing:

## Context
- user or reader:
- current file/page:
- business reason:

## Constraints
- do not touch:
- keep these links working:
- proof command:

## Definition of done
- small diff
- public URL checked
- CTA path still works
- handoff note written

Use this brief before editing.
Ask up to three clarifying questions only if the goal, protected files, or proof command is missing.
Then propose the smallest safe patch and the verification receipt.

rg --files | Select-Object -First 80
git diff --name-only
cd site
npm.cmd run build

良い依頼ブリーフの例

良い依頼は、Claude Codeに「何を変えるか」だけでなく「何を変えないか」まで渡します。たとえば記事改善なら、次のように依頼します。

site/src/content/blog/claude-code-productive-prompt-brief.mdx の導入文とCTA周辺だけを改善してください。読者はClaude Codeを初めて触る個人開発者です。目的は、無料PDFを読んだあとにPrompt Templatesか導入相談へ自然に進めることです。frontmatter、slug、既存のGumroadリンク、内部リンク、コードブロックは壊さないでください。変更後は node scripts/check-updated-article-quality.mjs を実行し、このslugのエラーが消えたことを報告してください。

この例で大事なのは、依頼範囲が狭いことです。「導入文とCTA周辺だけ」と書けば、Claude Codeは本文全体を作り直す必要がありません。「読者は誰か」「ビジネス上の目的は何か」も入っているので、単なる文章の装飾ではなく、読者の次の行動に合わせた改善になります。

また、守る対象が具体的です。frontmatterは公開日、カテゴリ、heroImageなどを含むため、壊すとページ生成やOGP表示に影響します。Gumroadリンクは収益導線です。内部リンクは関連記事への回遊です。コードブロックは読者がそのままコピーする実用品です。この4つを先に書いておくだけで、レビュー時に「良くなった気がするが、何かが消えた」という事故を減らせます。

悪い依頼の例

悪い依頼は、たいてい短すぎます。

この記事をSEOに強くして、いい感じにしてください。

これだけでは、Claude Codeはタイトルを変えてよいのか、本文を全部書き換えてよいのか、商品リンクを増やしてよいのか判断できません。SEOと言っても、検索キーワードを増やすのか、導入文を改善するのか、内部リンクを足すのか、descriptionを直すのかで作業は変わります。

もう一つ危ない依頼は、完了条件が曖昧なものです。

Claude Code初心者向けに読みやすくして。終わったら教えて。

読みやすさは大切ですが、これだけだと検証できません。良い依頼にするなら、「1段落を短くする」「悪い例を追加する」「品質チェックコマンドを通す」「このslug由来のエラーを残さない」のように、終わりを判定できる条件へ分解します。Claude Codeは強い編集役ですが、ゴールが霧のままだと広い差分を出しやすくなります。

初心者が最初に書くテンプレ

最初から完璧なプロンプトを書く必要はありません。初心者は、次の5行だけを埋めるところから始めると十分です。

• 変更したいこと: 何を一つだけ変えるか
• 対象: ファイル名、ページURL、または画面名
• 読者/利用者: 誰にとって良くしたいか
• 守るもの: 触らないファイル、残すリンク、消してはいけない仕様
• 確認方法: 実行するコマンド、見るURL、期待する結果

たとえば「商品ページのCTAを改善したい」なら、変更したいことはCTA文言と並び順だけに絞ります。対象は商品ページのMDXファイルです。読者はClaude Codeを導入したいが、まだ有料教材を買うか迷っている人です。守るものは無料PDF、Prompt Templates、Setup Guideのリンクです。確認方法はビルド、公開URL、リンククリックです。

このテンプレの狙いは、Claude Codeに長い背景を読ませることではありません。最初の作業単位を小さくして、失敗したときに戻しやすくすることです。慣れてきたら、制約に「見出し階層を変えない」「既存のコード例はそのまま残す」「日本語だけでなく全ロケールも合わせる」のような条件を足します。

迷ったときは、まず「一つの変更」「守るもの」「確認方法」だけを書いてください。この3点があれば、Claude Codeは不足情報を質問できます。逆に、この3点がないまま依頼すると、作業の正しさをあとから説明しにくくなります。

教材/相談への自然な導線

依頼ブリーフは、教材や相談を無理に売るための文章ではありません。むしろ、読者が今どの段階にいるかを見分けるためのチェックリストです。まだコマンドの意味が不安なら無料PDFで十分です。何度も似た依頼を書いているならPrompt Templatesで型を増やす価値があります。チーム導入、権限設計、レビュー運用、収益リンクの保護まで絡むなら、個別相談のほうが早い場面があります。

記事の中では、この順番で案内すると自然です。まず無料PDFで「今日使う最低限」を渡します。次に、繰り返し作業を減らしたい読者へ有料テンプレートを示します。最後に、組織やプロダクトの事情で一般論だけでは決めにくい読者へ相談導線を置きます。読者の不安を飛び越えて購入を迫るより、現在地に合う選択肢を並べるほうが信頼されます。

実例: 3つの使いどころ

• 既存記事のCTAだけを直すとき、本文全体のリライトを禁止して公開URL確認を完了条件にする。
• CLAUDE.mdを整えるとき、チームの禁止コマンドとビルドコマンドを先に渡す。
• 商品ページを直すとき、無料PDF、Prompt Templates、Setup Guideのリンクを守る制約に入れる。

失敗例と避け方

• 『いい感じにして』だけで依頼する。結果は広すぎる差分になりがちです。
• 守るリンクを書かない。収益導線が消えても差分だけでは気づきにくいです。
• 完了条件がない。Claude Codeが調査で止まり、公開まで進まないことがあります。

無料PDF・Gumroad・導入相談への導線

このブリーフを使う前に無料チートシートで基本コマンドを確認してください。繰り返し使う依頼文を増やすならPrompt Templates、プロジェクトごとの前提を固定するならSetup Guideが向いています。

• 無料Claude Codeチートシート
• 50個のClaude Codeプロンプトテンプレート
• Claude Code Setup Guide
• 商品一覧
• 導入相談

最初は無料PDFで日々のコマンドと安全な進め方を確認してください。繰り返し作業が見えたらGumroad教材で型を増やし、チーム導入や収益導線まで絡む場合は相談に進むのが自然です。

この記事で紹介した内容を実際に試した結果

この記事では、依頼前に埋めるMarkdownテンプレート、Claude Codeに渡す短い指示、最低限の確認コマンドを分けました。初心者でも一つの変更、一つの証明、一つの導線確認に絞れるようにしています。