CLAUDE.mdファイルは往々にして開発者向けに構成されており、AIモデル向けではない――それが重要な理由

r/ClaudeAIの投稿で、CLAUDE.mdファイルによく見られる失敗パターンが指摘されています。それは、ファイルが開発者が文書化したいことに基づいて構成されており、モデルが判断するために必要なことに基づいていないことです。これらは異なる問題です。

開発者優先の構造

開発者向けに整理されたファイルの例：

## このプロジェクトについて
[3段落の背景]
## テクノロジースタック
[15項目]
## 目標
[5つの箇条書き]
## ハードルール   <- これは47行目

モデルは線形的に読みます。ハードルールに到達する頃には、既に仮定を構築し始めています。もし制約がそれらの仮定を上書きするはずなら、モデルは困難と戦うことになります。

モデル優先の構造

この投稿は、ある思考モデルを提案しています。すなわち、「モデルが不可逆的なことをする3秒前に、何が必要か？」を考え、それを最初に置くことです。より良い構造：

## ハードルール（これを最初に読む）
[実際の制約]
## 現在のコンテキスト
[現在稼働中のもの]
## 背景
[残り]

長さの問題

4000行のCLAUDE.mdは整理されていません——アーカイブされただけです。アーカイブされたファイルはうまく読まれません。整理されたファイルは素早く読まれます。明瞭さは完全さに勝ります、常に。著者は問います：あなたのCLAUDE.mdの最初の20行には何がありますか？