ハーネスに足す前に消す条件を書いている
Claude Code のハーネスに何かを足すとき、先に「何が起きたら消すか」を書いている。4代目を作る間に、決まり、止める仕組み、対応するベンダー、月1回の運用から何を引いたかを書く。

Claude Code で使っているハーネスに何かを足すとき、私は先に「何が起きたら消すか」を書くことにしている。書けなければ足さない。条文(AI が従う決まりの項目)でも、調べた記録でも、外から採ってきた決まりでも同じである。
ハーネスを学生に説明するときは、馬につける手綱のような物だと言っている。AI が勝手なことをせず、目的に向かって進むようにするための仕組みで、AI が賢くなるにつれて必要な手綱の形も変わってきた。今使っているのは4代目で、Seneschal という名前で公開している(MIT ライセンス、執筆の時点で v0.2.1)。この記事では使い方を紹介せず、4代目を作る間に何を引いたかを書く。
AI に任せる範囲が広がるなら、決まりや検査は増やしたほうが安心だと考えるのが普通だと思う。私も3代目の LAM(Living Architect Model)ではそう考えて足し続けた。その結果、ハーネスを作ること自体が仕事の中心になった。LAM では AI が判断や検証をするたびに記録の文書を残していて、その文書が多すぎて誰も目を通さなくなっても、書くことだけは続いた。AI が毎回読み込む条文には上限を 80 と決め、新しい条文を1つ入れるなら既存の条文を1つ出す決まりにした。すると条文の数は増えない代わりに、1つの条文が複数の意味を持つようになった。動く製品を作るよりハーネスを作るほうがメインになってしまった。本末転倒も良いところだ。
決まりを全部明示して書く形は悪くないが、それを整備するのに手間が掛かる。思い付くままに書き加えれば整合性も怪しくなるし、多すぎれば AI が遵守しなくなる。少なすぎれば意味を成さない。おまけに Claude のモデルが 5 系になってからは、Anthropic が、細かいルールよりモデルに裁量を与え方針を示すように勧めるようになった。3代目ハーネスの終焉である。
それもあり、4代目では人間の手元に残す物を先に決めた。残したのは3つのゲートである。1つ目はゴールの合意で、完了条件と検証方法とやらないことを書いた文書を私が承認するまで、Seneschal は着手しない。2つ目は取り消せない操作で、本番への投入、削除、外部への送信などが当たる。2つ目に助けられることが多い。3つ目はハーネス自身の決まりを書いた文書の書き換えである。この3つ以外は Seneschal が判断して進め、確認を取りに戻らない。
AI に作業を任せて自分は考える側に回るが、任せきりにはせず、方向は人間が決める。これが新しい私のやり方で、それを形にしたら3つのゲートになった。
取り消せない操作を止める仕組みは、自分で書かなかった。そのためのスクリプト(guard.py)を自前で用意しなかったのは、測ってみると、止めたい経路を Claude Code の auto mode の判定と permissions.deny が既に覆っていたからである。だから2つ目のゲートは、止める仕組みが Claude Code の側にあり、Seneschal の中には無い。ベンダーが持っている物は自分で持たないことにした。
対応するベンダーも減らした。初めは Claude Code と Codex の両方で動かす方針だったが、2つのエージェントの両方を制御するのは私にはきつかった。Claude Code での試運転をいくらかこなしたことで満足した。Claude Code に満足したことで、Codex では試運転しないことにし、Claude Code 専門にした。Codex 用に計画していたファイル2本は作る前に計画から外し、「どちらのベンダーでも読めるように、素の Markdown で表現できる構造しか使わない」という制約も無くなった。Codex を主に使う形に戻ったら、そのときに調べ直す。Seneschal より前に Codex 向けに試作したハーネスは、検査を細かく分け続けて実装が膨らみ、2回やり直して中止している。
抜け道が見つかったら塞ぐべきだ、というのも普通の考えだと思う。開発用のリポジトリでは、3つ目のゲートとして、まず permissions.deny で文書への書き込みを止めた。ところが deny の境界は確率的で、同じ形のヒアドキュメントが通ったり止まったりした。すり抜ける経路を測って一度は「穴は2つだけ」と書いたが、測り直すと新しい経路が出てきて撤回した。止めるかどうかの境界がモデルの判定で決まるので、経路は数え上げられない。穴が無いことを証明しようとすれば、無限回の検証になる。そのうえ、穴を1つ見つけるたびに仕組みを1つ足すのは、前のハーネスが大きくなっていったときと同じ動きだった。
そこで完全な物を目指すのをやめ、最初は6〜7割の出来で止めることにした。詰めるのは、実際に使って足りないと分かってからにする。仕組みのほうは、書き込みを止めるのに加えて、commit に載ることを pre-commit のフックで止める形にした。git は stage されたパスの一覧を自分で持っているので、こちらは判定に推測が要らない。それでも --no-verify を付ければ越えられる。得られるのは事故の防止で、わざとやることまでは防げない。
測って見つかった穴は「塞がない」と書いて閉じ、直すのは、宣言したことを実装できていないバグだけにした。たとえば git commit の出力をパイプで head に渡すと、フックが止める前に死んで、10 回中 10 回すり抜けた。フックの先頭に trap '' PIPE の1行を足すと、10 回中 10 回止まった。
最初に書いた「消す条件」は、足す物の全部に書いている。「当面は消さない」も消す条件の1つとして書き、そう書いた物は後で見直せばよい。削って残した物には、戻す条件を書く。
ただ、条件を書くだけでは消えなかった。条件が満たされた決定と調査の文書を残したまま次へ進んだことがあり、別のモデルによるレビューで見つかった。それからは、フェーズの終わりに「条件が満たされた物を消す」工程を入れている。この工程が無いと、書いた本人が覚えている間しか消えない。
自分で決めた運用も消した。Seneschal には「受入」という手順があった。Seneschal 以外の実際のプロジェクトで月に1回実行し、条文と実際の動きのずれを記録する手順で、ハーネスの開発が使われないまま自分自身の開発に戻っていくのを見つけるための、ただ1つの仕組みだった。5回実行して5回とも通り、条文を直すことになったずれは、2回目が4件、3回目が4件、4回目が2件、5回目が0件と減った。取り入れるべき物は残っているかと Seneschal に聞くと、残っていないという答えだった。それで 2026年10月14日、公開と同じ日に受入をやめ、Seneschal 自身は保守だけにした。今は、私が使っていて困ったときにだけ条文を直す。自分自身の開発に戻っていくのを見つける仕組みは無くなったが、それは分かったうえで引いた。
ハーネスは足していく物ではなく引いていく物だと思っている。AI が賢くなった分だけ、手綱は短くできる。今の形が正しいかは分からないし、次の代ではまた変わるだろう。
