渡す散文を減らす

やることの半分は「消す」。 今のモデルは周囲の文脈から判断できる。旧世代向けに積んだ禁止・手順の全文・例示の列挙は、判断の邪魔になるか、互いに矛盾する。

対象はコードの周りに人が置いた文章すべて。 実装は正なので触らない。

ここで直す。 消すのは1行の削除で、issue と PR を経由するには軽すぎる。ただし判断を含むものは消さずに挙げる（規約そのものの是非、docs/ の要求・技術選定に当たるもの、消すと判断の理由が失われるもの）。決めるのは書き手。

判定と置き場は .claude/rules/documentation.md に従う。

範囲

1回に1層。 上から順に、まだ見ていない層を1つ選ぶ。依頼が範囲を名指ししていればそれに従う。全域を一度に触ると差分がレビューできず、消しすぎたことに次のセッションまで気付けない。

コメントの層はディレクトリ単位に割る。 server/src/domain/、server/src/parsers/ のように、1回で読み切れる単位にする。

選んだ層について、次を順に見る。

1行ずつ、.claude/rules/documentation.md の問いにかける。間違えないなら消す
実装・設定・Git 履歴・ツールの説明を読めば分かることを消す（コマンド一覧、ディレクトリ構成、検査の一覧、ハーネスが既に指示していること）
機械が守っているものを消す（lint・フック・CI が落とすもの）。守らせたいのに守れていないものは、文書ではなくフックか lint に足す（→ enforce）
同じ指示が2箇所にあれば、効く場所1つに寄せる（スキルの使い分けは description に、コーディングの判断は rule に、検査は scripts/check に）
実装と食い違っている記述を直す（テストの範囲、ファイルの所在、文書の節番号、切れた相互参照）
例示の列挙は判断基準1つに置き換える。残す例は、基準を最短で伝える1〜2個

description の層を見るときは、発火条件が他のスキルと重なっていないかも見る。重なると、依頼のたびに違うスキルが立つ。

消した項目と、消した理由を1件1行。 行数は報告しない。量を指標にすると、消すこと自体が目的になり、正当なコメントまで刷る。

1件も消せなければ報告しない。 消せるものが無いのは正常な結果で、この層は既に絞れているというだけ。