【第123回】非エンジニアのCLAUDE.mdの書き方｜何を書かないかで決まる
CLAUDE.mdの書き方を調べると、「削ったら守るようになった」という話がたくさん出てきます。
私も読んで、そのとおりだと思いました。ただ、自分のCLAUDE.mdを数えてみたら311行ありました。短くはありません。
ただ、中身を見直すと、いちばん守らせたいことほどCLAUDE.mdには書いていませんでした。書く代わりに、別の場所へ移してあります。
私は放射線技師として16年、地方中核病院で働きながら、院内のAIチームのリーダーをしています。プログラミングは未経験から始めました。この記事は、削った中身をどこへ移したかの記録です。
CLAUDE.mdを手で書いていない
最初に少し変わったことを書くと、私はCLAUDE.mdを直接書いていません。
指示を5つのファイルに分けて書き、ツールでCLAUDE.mdを作っています。同じ元ファイルから、Codex用のAGENTS.mdも一緒に作られます。使っているのはrulerというツールです。
・ユーザー設定と禁止事項
・文章のルール
・作業の流れ
・ネタ出しの方針
・プロジェクトの目的
非エンジニアにとっての利点は、どのAIに何を書いたかを覚えておかなくていいことです。直すのは元のファイル1か所だけで、Claude CodeにもCodexにも同じ指示が届きます。
できあがったCLAUDE.mdは311行です。そのうち半分以上は「作業の流れ」で、ここが長い理由は次の節に書きます。
書かなかったものと、移した先
311行もあるのに、書いていないものがあります。しかも、いちばん守らせたいものほど書いていません。
たとえば、記事で使わない言い回しが26語あります。これはCLAUDE.mdに1語も書いていません。文体チェックのスクリプトに一覧があり、原稿を保存するたびに自動で走ります。引っかかれば、その場で直しが入ります。
CLAUDE.mdに一覧を書いた場合、AIはそれを読んで、覚えて、書くたびに思い出す必要があります。長い作業の途中で抜けることがあっても、責められません。スクリプトに移せば、覚えていなくても引っかかります。
3つに共通しているのは、機械で判定できるか、変わり続けるかのどちらかだということです。どちらかに当てはまるものは、CLAUDE.mdの外に置いたほうが確実でした。
保存したら自動でチェックが走る仕組みのほうは、次の回で詳しく書きます。
・Claude Codeのhooksで品質チェックを自動化する｜止めるフックと止めないフック
[第124回：Coming Soon！]
「作業の流れ」が長いのは、この移した先への案内が並んでいるからです。手順そのものではなく、「この作業はこのコマンドを使う。手で作り直さない」という案内です。
残したのは、判断に使うもの
逆に、CLAUDE.mdに残したのは次のようなものです。
・ファイルを削除しない、という禁止事項
・企画を出すときの合格基準と、何を優先するかの方針
・台帳や原稿が、どこに置いてあるか
どれも、機械では判定できません。AIが迷ったときに読み返すものです。
基準を一つにすると、「スクリプトで判定できるなら移す。判定できないなら残す」です。削るかどうかで考えるより、移せるかどうかで考えたほうが、私には分けやすかったです。
書いても、読まれない場所がある
最近になって気づいたことがあります。
私の環境では、生成したCLAUDE.mdをgitの管理から外していました。元ファイルを管理していれば十分なので、ツールの設定でそうしていたのです。
ところが、作業用のコピーを作ってそこで作業させると、コピーにはCLAUDE.mdが置かれません。調べたら、作業用のコピー9つすべてにCLAUDE.mdがありませんでした。つまり、そこで動いていたAIは、私が書いた指示を読んでいなかったことになります。
毎日の自動実行は元のフォルダで動いているので、こちらには影響がありませんでした。それでも、書き方をいくら工夫しても、読まれる場所になければ意味がありません。
いまは生成したCLAUDE.mdもgitで管理するように戻し、元ファイルとずれていないかを確かめるチェックを1つ足しました。作業用のコピーにも、同じ指示が届くようになっています。
確かめ方は簡単です。作業を始めるときに「このプロジェクトの禁止事項を言ってください」と聞いてみてください。答えられなければ、書き方より先に、置き場所を見直したほうがいいと思います。
非エンジニアが最初に書くなら
これから書く人に、私なら次の3つから勧めます。
・絶対にやってほしくないこと（ファイルを削除しない、など）
・大事なものがどこに置いてあるか
・迷ったときに何を優先するか
文章のルールや手順の細かいところは、最初は書かなくてかまいません。守られなくて困ったら、そのときに「これは機械で判定できるか」を考えれば十分です。
今日からできる一歩として、いまのCLAUDE.mdの各行に、機械で判定できるかどうかの○×を付けてみてください。○が付いた行は、CLAUDE.mdの外に移せる候補です。
ChatGPTで同じことをするなら、プロジェクト機能の指示欄が近い役割になります。そちらは前回に書きました。
・ChatGPTのプロジェクト機能で仕事を分ける｜毎回同じ説明をしなくて済む設計
まとめ
・CLAUDE.mdは311行あって短くない。ただ、守らせたいことほど書いていない
・使ってはいけない言い回し、手順、公開済みの一覧は書いていない。スクリプト、コマンド、台帳へ移した
・残したのは、禁止事項、判断の基準、大事なものの置き場所。機械で判定できないもの
・書いても、読まれない場所に置いていたら意味がない。最初に「禁止事項を言って」と聞いて確かめる
・削るかどうかより、移せるかどうかで考える
同じように非エンジニアでCLAUDE.mdを書いている方がいたら、何を書かずに済ませているか教えてください。移した先の話はあまり見かけないので、知りたいです。
・Claude Codeの使い方【2026年版】｜プログラミング未経験の放射線技師が業務ツールを作る手順
https://note.com/ri_ai_lab/n/n1ca5a293c232
・専門職の言語化力こそAI時代の武器｜Vibe Codingの現場実感
https://note.com/ri_ai_lab/n/ne02ea2d05ccc
医療・介護の現場でのAI活用と、専門職が自分でツールを作る話を書いています。よろしければフォローしていただけると、更新をお届けできます。
本記事の内容は筆者個人の見解であり、所属する医療機関の公式見解を代表するものではありません。記載した設定と運用は筆者の環境での一例であり、すべての環境で同じ結果になることを保証するものではありません。CLAUDE.mdが読み込まれる範囲、置き場所、関連ツールの挙動は、筆者の環境で確認できた範囲の記述です。Claude Code、ruler、Codex CLIの機能仕様と既定の動作は変更されることがあります。利用にあたっては、その時点の公式ドキュメントを確認してください。生成AIおよび開発ツールへの指示ファイルや入力に、患者情報、個人が特定されうる情報、院内固有の非公開情報を含めないでください。本記事を参考にしたことによって生じた損害・不利益について、筆者は一切の責任を負いかねます。
