CLAUDE.mdの書き方、建設業の会社版

CLAUDE.mdは、Claude Codeに会社固有の情報を渡しておくためのテキストファイルである。会社概要、部署構成、頻出する書類の様式、取引先ごとのルールをここに書いておけば、依頼のたびに同じ前提を説明し直す必要がなくなる。

AIは会社の外の一般知識には強いが、その会社の固有事情は知らない。取引先の名前、社内の呼び方、提出書類の締切ルールといった情報は、書いておかない限り毎回ゼロから伝えることになる。

AIはCLAUDE.mdに書いていない暗黙のルールまでは推測できない。長年の勘や、口頭でしか伝わっていない判断基準は、言語化して書かない限りAIには伝わらない。

建設業の会社は、取引先ごとに提出書類の様式が異なり、現場ごとに呼び方や慣習も変わる。同じ内容の依頼でも、取引先が変わればフォーマットも変わる。この違いを毎回口頭で説明していては時間がかかる。

書類仕事を担当する人数が少ない会社ほど、この繰り返しの説明にかかる時間は無視できない。CLAUDE.mdに書いておけば、依頼するたびに前提をそろえ直す手間が減る。

取引先が増えるほど、この違いを覚えておく負担は増える。CLAUDE.mdに書いておけば、新しく担当になった人でも同じ前提を共有できる。

項目は多く書けばよいわけではない。会社概要、部署と役割、頻出する書類のフォーマット、取引先ごとのルール、注意点の5つに絞るところから始めるとまとめやすい。

特に注意点の欄は省略しない方がよい。AIに任せてよい範囲と、金額や提出物のように人が最終確認すべき範囲を分けて書いておくことで、運用上の事故を防げる。

項目ごとに実例を1つ添えておくと、後から読み返したときにも分かりやすい。抽象的なルールだけを書くより、具体的な書類名や取引先名を添えた方が実務に使える。

建設業向けのテンプレートでは、見積書・安全書類・工事日報といった頻出書類ごとに、様式のファイル名と保存場所、取引先ごとの違いを書く欄を用意する。取引先が独自の様式を求める場合は、その旨も明記しておく。

プロンプト例: 自社の会社概要、部署構成、頻出する書類の様式一覧を渡すので、CLAUDE.mdの形式でまとめてほしい、AIに任せてよい範囲と人が確認すべき範囲も注意点として分けて書いてほしい、という指示でたたき台を作らせられる。

取引先ごとの様式の違いは、テンプレートの中でも特に更新頻度が高い項目である。新しい取引先が増えるたびに追記していく前提で作っておくと運用しやすい。

最初から完璧なものを目指さない方がよい。まずは頻繁に説明し直している情報を思い出して書き出し、実際に使いながら足りない部分を追記していく形が現実的である。

更新を前提にすることも重要である。取引先が増えたり様式が変わったりするたびに、CLAUDE.mdを直す運用を最初から組み込んでおく。放置すると内容が古くなり、かえって誤った前提でAIが動く原因になる。

社内に複数の担当者がいる場合は、誰か1人がたたき台を作り、他の担当者が使いながら追記していく進め方が現実的である。1人で完璧を目指すと、着手自体が先延ばしになりやすい。

CLAUDE.mdには、契約金額や個人情報のような機密情報は書かない。会社の運用ルールや書類の様式といった、外部に漏れても実害が小さい情報にとどめておく。

金額の最終確認や提出物の押印確認のように、人が必ず担う範囲は注意点として明記しておく。AIが下書きを作れる範囲と、人が最終判断する範囲を分けて書いておくことが、事故を防ぐ一番の対策になる。

取引先名や個人名を書く場合も、社外に出しても問題ない範囲にとどめる。契約金額のような数字は、別の管理された場所に置き、CLAUDE.mdには書かない。

当社は建設業向けにCLAUDE.mdの整備を含む実装支援を行っている。自社でも13本の自動化を運用しており、その前提となる会社情報はCLAUDE.mdに書き出してある。

最初の一歩は、今週AIに説明し直した会社の情報を1つ書き出すことである。そこから項目を増やしていけば、数か月後には依頼のたびに前提を説明し直す時間がなくなっていく。

書き出す情報に迷ったら、直近1か月で同じ説明を2回以上した内容から手をつけるとよい。繰り返しの説明が多い項目ほど、書いておく効果が大きい。