AI生成の「CLAUDE .md」、逆に精度が下がるという研究
AI要約
Claude.mdなどの指示ファイルをAIで自動生成すると、むしろ成功率が2~3%低下し、推論コストが20%以上増加することが判明しました。既存ドキュメントとの重複や無駄な検索が原因です。手動作成は平均4%改善しますが、最小限の情報のみ記載することが重要。ドキュメントが全くないリポジトリではAI生成が有効です。
AI要約
Claude.mdなどの指示ファイルをAIで自動生成すると、むしろ成功率が2~3%低下し、推論コストが20%以上増加することが判明しました。既存ドキュメントとの重複や無駄な検索が原因です。手動作成は平均4%改善しますが、最小限の情報のみ記載することが重要。ドキュメントが全くないリポジトリではAI生成が有効です。
Cursor や Claude Code などのAIエージェントをチームで使うと、コミットルールが崩れやすくなります。これを防ぐには「禁止事項・手順・メッセージ形式」の3点を明文化し、.cursor/rules や CLAUDE.md に記述することが重要です。チケット番号を先頭に入れる、git add .を禁止するなど、具体的なルール設定で追跡性が大幅に向上します。

