CLAUDE.md、どの行を消していいか分からない ── 24項目を1つずつ棚卸しした記録

AIエージェントへの指示書を三か月運用したら、五十六行に膨れ上がっていた。書き足した記憶はあるのに、消した記憶はない。内訳を調べると、実行環境について書かれた節だけで全体の四分の一を占めていた。証明書エラー、認証ヘルパ、セッション種別といった、障害が起きるたびに調べた結果を追記してきた跡が、地層のように積み重なっていたという。消せない理由ははっきりしている。どの行も一度は役に立ったからだ。そこで筆者は削除の基準を論じるのをやめ、二十四項目を一つずつ判定する棚卸しに踏み切った。

AIの鬼が面白いと思うのは、指示書が「効いた記憶」だけで太っていく構造である。役に立った行ほど消しづらく、消さないからまた増える。これは社内のマニュアルや引き継ぎ資料でもまったく同じ現象で、AIだけの問題ではない。基準を議論していると手が止まるが、一行ずつ「今も必要か、同じ障害は再発するか」と問い直すと、判断は意外と速く進む。どんなに賢いエージェントでも、読むべき指示が多すぎれば迷う。指示書を増やすより減らす作業のほうに腕の差が出るという本音を、この記事は行数と割合という数字で示している。

中小企業でAIに手順を任せているなら、今日から指示書の行数を数えてみるとよい。そして一行ずつ、今も使っている根拠があるかを問うことだ。根拠が言えない行は、まずは別ファイルに移すだけでもいい。手順書の見直しはAIのためだけでなく、社員が迷わないための仕事でもある。