Claude Codeの規律をhookに降ろしたら、Haikuでも壊れなくなった

Claude Codeで複数のAIエージェントに作業を任せると、ルールを文章で書いても守られないことがある。この記事は、その問題を「プロンプトのルールは確率的に守られる」という前提から見直し、機械的に判定できるルールだけをhookに移した試みを紹介している。具体的には、ファイル編集のたびに自動で走るチェックスクリプトを用意し、違反があればその場で編集したエージェントにだけ修正指示を返す仕組みだ。例として、ページ先頭の"use client"や、クライアント側で非公開の環境変数を読む記述などが挙げられている。

面白いのは、ルールを「判断が要るもの」と「grepで書けるもの」に分けたことだ。前者はモデルに考えさせるしかないが、後者は機械に任せたほうが速くて確実である。人間の組織で言えば、「規則を読んで覚えろ」と言い続けるより、受付で書類の不備をその場で指摘する仕組みを置いたほうが、差し戻しの往復が減るのと同じ理屈だ。筆者はそれを、トークン代の払い方の問題としても捉えている。プロンプトにルールを置くと守られていても毎回課金されるが、hookは違反したときだけ数行が入る。ルールを増やすほど遵守率が下がりコストが上がるという指摘は、AIを使う現場全般に当てはまる。さらに、モデルを安いものに下げてもhookが下支えするので安物の実用構成になる、という発想は、ツールの賢さより仕組みの設計で品質を保つという本音の方向性を示している。

中小企業の実務では、AIに任せる作業の中で「これは絶対に守ってほしいが、判断はいらない」ルールを一覧にすることが第一歩になる。帳票の必須項目漏れ、金額の桁、禁止語句などは、AIに頼むより検査の仕組みに置いた方が確実に効く。