コンテンツにスキップ

CLAUDE.md でプロジェクトの方針をAIに覚えさせる

この章でわかること: CLAUDE.md という1枚のファイルの役割と書き方。これは プロジェクトの「常識」をまとめておき、AIが毎回自動で読んでくれるメモです。 うまく使うと、「毎回おなじ前提を説明し直す」という地味に重い負担が消えます。

CLAUDE.md はプロジェクトの「常識」を書いた一枚

Section titled “CLAUDE.md はプロジェクトの「常識」を書いた一枚”

新しくチームに入った人に、最初にプロジェクトの前提を一通り伝えますよね。 「うちはこういうトーンで書く」「この技術を使う」「ここには触らないで」——。 CLAUDE.md は、その申し送りメモをAI向けに1枚にしたものです。

ポイントは、AIがそのプロジェクトで作業を始めるとき、中身を毎回勝手に読み込むこと。 だからチャットのたびに前提を貼り直す必要がなく、セッションやページをまたいでも 一貫した出力が返ってきます。人に何度も同じ説明をせずに済むよう仕組み化する—— 極めてエンジニア的な発想を、ファイル1枚で実現しているわけです。

最初から完璧を目指す必要はありません。次のようなことを、思いつく範囲で書きます。

  • トーン・言い回し: 一人称、敬体/常体、避けたい表現など
  • 使う技術・道具: 「このツールで作る」「この形式で出す」といった前提
  • やってほしくないこと: 触ってほしくない箇所、避けたいやり方
  • 素材やドキュメントの場所: 資料・画像・仕様書がどのフォルダにあるか

日本語の短い箇条書きで十分です。たとえば、営業資料サイトを作るプロジェクトなら こんな数行から始められます。

CLAUDE.md(非エンジニア向けの、ごく素朴な例)
# このプロジェクトの方針
- 読み手は取引先の担当者。専門用語は避け、やさしい言葉で書く。
- 文章のトーンは丁寧語(です・ます)で統一する。
- 会社名は必ず「株式会社サンプル」と正式名称で書く(略称は使わない)。
- 画像やロゴは `assets/` フォルダにあるものだけを使う。
- 価格や日付など、資料にない数字は勝手に作らない。分からなければ確認する。

Skills(技)との違い——こちらは「常設の前提」

Section titled “Skills(技)との違い——こちらは「常設の前提」”

似た仕組みに Skills(スキル)があります。 違いはシンプルです。

  • Skills = 呼び出して使う「技」。「今回はこの手順でやって」と、必要な場面で発動する
  • CLAUDE.md = 常設の「前提」。呼び出さなくても、そのプロジェクトでは常に効いている

スキルが「必要なときに取り出す道具」なら、CLAUDE.md は「作業机に最初から貼ってある 注意書き」です。両方をあわせて使うと、普段の前提はCLAUDE.mdで固定しつつ、 特定の作業はスキルで呼び出す、という役割分担ができます。

非エンジニアでも書ける——まず数行から

Section titled “非エンジニアでも書ける——まず数行から”

CLAUDE.md はプログラムではなく、ただの箇条書きメモです。書き方に厳密な決まりは なく、日本語の普通の文章で構いません。いきなり網羅しようとせず、 「これは毎回言っている気がする」という前提を1つ書くところから始めましょう。

育て方——詰まった原因を一行ずつ足していく

Section titled “育て方——詰まった原因を一行ずつ足していく”

CLAUDE.md は書いて終わりではなく、使いながら育てるものです。コツは、 作業中に「あれ、思った通りに出なかった」と感じたら、その場で一行足すこと。

  • 意図と違う出力が返ってきた → 「次はこうして」を一行追加する
  • 同じ指示を毎回している自分に気づいた → その指示を前提として書いておく
  • ミスの原因が分かった → 「◯◯は避ける」と書いて再発を防ぐ

こうして、詰まった原因や気づきを一行ずつ積んでいくと、CLAUDE.md は少しずつ そのプロジェクト専用の頼れる申し送りに育ちます。長い文章より、短い箇条書きを こまめに足すほうが、AIにも人にも読みやすく効きます。

VibeCoding で作業が長くなるほど、「毎回おなじ前提を説明し直す」コストは地味に 効いてきます。CLAUDE.md はそのコストを一度きりの記述に置き換え、セッションや ページをまたいでも一貫した品質を保つための、いちばん手軽な仕組み化です。

一度書けば毎回効く——この感覚は Skills の自作とも共通します。前提はCLAUDE.mdで 常設し、特定の進め方はスキルで呼び出す。両輪がそろうと、AIはぐっと 「自分のプロジェクトを分かっている相棒」に近づきます。実務での本格的な使い方は 提案書から動くPoCを作るへどうぞ。