clone しただけのマシンで、AI が「推測で埋めること」を自分から拒否した——AI駆動開発を .md で規律づける

Claude Code（AIコーディング支援ツール）を使うとき、リポジトリの直下に「CLAUDE.md」というファイルを置くと、セッションのたびにAIが自動で読み込む仕組みがある。このファイルには何を書くのか。従来は、コーディング規約やディレクトリ構成の説明、フレームワークのバージョン情報などが書かれてきた。だが今、別の使い方が広がっている。それは「AIが判断に困ったとき、どう振る舞ってほしいか」を事前に指示する、という方法だ。例えば「このプロジェクトでは、推測で埋めるな」「不確実な部分は質問を返す」「セキュリティが関わる判断は常に確認する」といった、AIの思考プロセスそのものを設計するのだ。

ここに、AI開発の大きな転換が見える。従来のAI活用は「AIに何をやらせるか」をプロンプトで指示する、という外部からの制御が中心だった。だが今は、AIをチームの一員として「教育する」段階に入っている。CLAUDE.mdはその最小化された形で、「AIオンボーディング」とも言える。つまり、AIはもはや「指示したら働く外部ツール」ではなく、「チームの文化やルール」を学ぶべき構成員になったということだ。この変化は、AIの能力が上がったからこそ可能になった。ツールとしてのAIが十分に高性能だから、次は「チームとの適応」に資源を投じる段階に移行できるようになったわけだ。

中小企業がAIを業務に組み込むときの実務的な教訓は、「何をやらせるか」の指示だけでなく「判断に困ったときはどうするか」をあらかじめ決めておくことが、ミスやズレを大幅に減らすということだ。小規模チームほど、この仕組みが効く。なぜなら、チームメンバー間の暗黙知が少ないほど、AIとの間にズレが生まれやすいからだ。逆に言えば、ルール化と透明化が進むほど、AIとの協働がスムーズになる。