AIに作業を任せるときの「ハーネス」、最初から設計して作ったわけじゃないです。
やらかすたびに1個ずつ足していったら、いつの間にかこうなってました。
🎥 この記事の内容は動画でも解説しています。
先に結論です。
- 書いても守られなかったルールは、「口で言う→覚え書き→作業手順→hook」と置き場所を上げている
- 上の段ほど飛ばされにくい。でも、全部をhookにはしない(止めすぎるから)
- 「今どこまで進んだか」と「次から気をつけること」は、別のファイルに分ける
- 増やすだけだと太るので、減らす日もつくる
ハーネスって、ちゃんと作るの大変そう。
自分のは、困ったときに1行ずつ足しただけ。あとから名前を知った感じ。
ハーネスのおさらい
ハーネスは、AIエージェント(自分で作業を進めるAI)のまわりに置くしくみのことです。
ルールのファイル、引き継ぎのメモ、終わったかを確かめるチェックなどが入ります。
言葉の意味は、ハーネスとは?で書きました。
このブログ、note、YouTubeは、ほとんどClaude CodeとCodexに作業してもらっています。
この記事は、そのまわりに置いているものを、どう育ててきたかの話です。
書こうと思ったきっかけは、Xでエナミコウジさんのハーネスの記事を見たことでした。
正直、ふだんやっていることに名前がついて注目されているのは、ちょっと不思議な感じがしてます。
なので、特別なことじゃない温度のまま書きます。
今、置いているもの
今は、こんな感じです(数はClaude Codeに数えてもらいました)。
| 置いているもの | 中身 | 量 |
|---|---|---|
| ルール(CLAUDE.mdとrules) | コードの書き方、作業の進め方 | 6ファイル・195行 |
| 覚え書き(memory) | 指摘されたこと、好み、前に失敗したこと | 92ファイル(うち指摘・方針が38) |
| 作業手順のファイル | 記事・動画を出すまでの順番 | 273行 |
| 引き継ぎのファイル(HANDOFF.md) | やったこと・残り・次にやること | 記録の見出しが412個 |
| hook | 決まった操作の前後で機械的に止める・直す | 3つ |
ルールのファイルは、自分で書いたところと、AIに足してもらったところの両方があります。
育て方: 失敗したら、1段ずつ上げる
やっていることは、ほぼこれだけです。
書いてあるのに守られなかったら、そのルールの置き場所を上げます。
まず、なぜ飛ばされたかを確かめます。
そもそも書いた場所を読んでいなかったのか、読んだけど作業の流れで通り過ぎたのか。
くり返し見落とすなら作業の直前の手順へ、実行前に確実に止めたいならhookへ。
ふつうは1段ずつで、困り具合によっては段を飛ばします。
- 口で言う: その会話の中だけ。次の会話には引き継がれないことが多い
- 覚え書き(memory)に書く: 自分の環境では、次の会話でも読まれる。ただ、作業の途中では通り過ぎることがある
- 作業手順の途中に書く: 「この次に進む前に」の場所に入れる。かなり止まるようになる
- hookで止める: 条件を満たさないと、コマンド自体が動かない(自分のはClaude Codeに設定しているので、Codexで作業するときは効かない)
上の段ほど飛ばされにくいです。
でも、いきなり全部をhookにはしていません。
手順とhookの分け目は、だいたいこう決めてます。
- あとで気づいても小さく直せるもの(文章の言い回し、採点のやり直し)→ 手順に書く
- 公開されてから気づくと手戻りが大きいもの → hookで実行前に止める。自分の環境で止めているのは、記事を作るコマンド、動画をアップするコマンド、測っていない画像を記事に設定すること
Codexで同じ作業をするときは、このhookが効かないので、今は共有の作業手順に書いた確認だけが頼りです。
Codexにもhookのしくみはあるので、同じ止め方をCodex側にも置けないか試しているところです。
全部hookにしたら、最強じゃないの?
止めすぎて、調べたいだけのコマンドまで止まるんだよね。だから最後の手段。
段を上げた実例
覚え書きから手順に移した例、手順からhookに上げた例(2つ)、止めるんじゃなくて直すために使った例の4つです。
採点の90点ルール: 覚え書き→手順
「採点が90点に届くまで作らない」は、最初は覚え書きに入れていました。
なのに85点の記事が「完了」にされて、次は72〜82点の台本のまま動画まで作られました。
そこで、動画の作業手順の採点のところへ「90点に届くまで、音声・映像・アップロードに進まない」と書き直しました。
3日後、別の台本が89点と82点のところで止まって、聞いてきました。
詳しくはルールは文章より手順に入れるに書いてます。
公開前のチェック: 手順→hook
あるとき、決めてあった文章チェックのガイドのファイルが置き場所になくて、Claude Codeが覚えている内容で代わりにチェックしていました。
それで、記事を作るコマンドと動画をアップするコマンドの前で止まるhookを入れてもらいました。
「確認が終わった」という印のファイルがないと動きません。
ただ、見ているのは印があるかどうかだけで、チェックの中身までは確かめていません。
中身はClaude Codeのhooksの使い方に書いてます。
アイキャッチの測定: 手順→hook(すぐに)
アイキャッチの案のうち、一部しか余白や文字の大きさを測っていなかったことがありました。
これは手順にすでに書いてあったので、その日のうちにhookへ上げて、測っていない画像は記事に設定できないようにしました。
ルールの原本: 2つあったのを1つに
Claude CodeはCLAUDE.md、CodexはAGENTS.mdを読みます。
両方に同じルールを書いていたら、片方だけ古くなりました。
今は原本を1か所にして、Claude Codeがrulesの原本を編集したら、Codex用のAGENTS.mdを自動で作り直すhookにしています。
これは止めるhookじゃなくて、直すほうのhookです。
やり方はAGENTS.mdとCLAUDE.mdを共通にする方法にまとめました。
「進み具合」と「気をつけること」は分ける
もう一つ、途中で分けたものがあります。
最初は、記事のネタ帳もClaude Codeの覚え書きに入れていました。
でも、Codexもブログの作業をするようになったとき、その覚え書きはCodexと共有する場所に置いていませんでした。
どのネタを書いたかが、2つのAIでずれ始めました。
今は、こう分けています。
- 今どうなっているか(ネタ帳、予約した記事、次にやること): 2つのAIが両方読む共有のフォルダ
- 次から気をつけること(指摘、前の失敗、好み): それぞれのAIの覚え書きやルール
進み具合は毎日変わるので、両方から見える場所に。
気をつけることはあまり変わらないので、ルールの側に。
太ったら、減らす
足していくだけだと、だんだん太ります。
なので、増やすだけじゃなくて、減らすきっかけも決めてあります。
全部のプロジェクトで読まれるCLAUDE.mdに、「新しいモデルが出たら、ルールのファイルを1つずつ外して試すのを提案する」と入れています。
モデルが賢くなると、前は必要だった注意がいらなくなることがあるからです。
一気に消すんじゃなくて、ファイル単位で外して様子を見る形です。
足す前に見ていること
- 同じ注意を2回以上していないか(していたら、どこかに書く)
- 書いてあるのに破られたなら、今どの段にあるか(1段上げる)
- それは「進み具合」か「気をつけること」か(置き場所を分ける)
- hookにするほど困るものか(止めすぎないか)
- 前に足したもので、もういらないものはないか
最初の一歩なら、直近で困ったことを1つ選んで、次に同じ作業をする直前の手順に、確認を1行入れるところからで十分だと思います。
たとえば記事の公開の手順なら「公開する前に、決めてあるガイドのファイルを開いて照らし合わせる」の1行です。
最初から完成形を作ろうとしなくて大丈夫です。
自分のも、困ったことを書き足していった結果です。
毎日の引き継ぎに使っているファイルの作り方と、手順のひな形は、noteにまとめています。
AIに毎日の発信を任せるためのハーネス(note)