今日ひとことで言うと
「なぜ作るか」を必ず紙に残し、AIの下書きは先生(小澤さん)の採点を通るまで正式扱いしない、というルールを工場に固定した。
新しい機能を足したのではなく、みんなが守る約束ごと(契約)を文章とプログラムの両方でカチッと決めたのが今日の中身です。正本は docs/production_brief_contract.md。
まず登場人物(工場で働くAIたち)
Aibou Loop は、AIがそれぞれの持ち場を担当する「自動化された工場」です。人間の部署とそっくりの分業になっています。
| 呼び名 | 役割(工場でたとえると) |
|---|---|
handan(判断係) | 毎朝出勤して数字を見て「今日は何を作るべきか」を決める工場長。常駐せず、判断だけして帰る。 |
daihon(台本係) | 広告のセリフ(台本)を書く制作担当。/script という道具を使う。 |
bucho(検品係) | 出来上がった台本が要件を満たしているか検品する品質チェック担当。 |
| 小澤さん | 工場のオーナー。最終的に「これは本物の知識だ」と認める採点者。 |
変更前 → 変更後
今日の工事で、工場のルールがどう変わったかをまず全体で見ます。
- 「なぜこの広告を作ったか」の理由がどこにも残らず消えていた
- AIが出した下書きが、そのまま正式な知識みたいに扱われる恐れがあった
- 指示どおり作ったのか、AIが勝手に変えたのか後で分からなかった
- 誰がどこまでやっていいか(権限)が曖昧だった
- 設計書に古い「8本」と新しい「6本」が混在していた
- 作る前に「依頼書」で理由を必ず残す
- AIの下書きは、小澤さんの採点を通るまで正式知識に昇格させない
- 指示をどこまで守ったかを4段階で記録する
- 各AIの権限をプログラムで固定(テスト118件パス)
- 冒頭は「6本」に統一(過去の記録は履歴として保存)
5つの変更を、たとえ話つきで
それぞれ「何をしたか」と「学校や部活でいうと何か」をセットで説明します。
「制作依頼書」を導入した
production_brief広告を作るとき、これまでは「やることリスト」(.ops task)しかありませんでした。作業は進むけれど「なぜ作ったのか」が終わると消えてしまいます。そこで production_brief(制作依頼書)という紙を新しく作りました。ここには「なぜ作るか・何を試すか・何が勝てば学びになるか」を書きます。
役割分担はハッキリさせました。依頼書=意図(なぜ)の記録、やることリスト=進み具合の記録。同じ情報を2か所に書いてズレないようにします。依頼書を書けるのは小澤さんと判断係(handan)だけ。台本係などの現場AIは書けません。
AIの下書きは、すぐには保存しない
flow_draft台本を書くAI(/script)は毎回、「読者の気持ちがどう動くか(不安→納得→行動)」という設計図を下書きで出します。これを flow_draft と呼びます。でもこれはあくまでAIの仮説(予想)であって、正しいと決まったわけではありません。
だから、AIの下書きをそのまま正式な知識ベース(Koza OS=小澤さんの頭の中を写した知識置き場)には入れません。小澤さんがレビューしてOKを出したものだけが、正式な知識に「昇格」します。
「指示どおり作ったか」を記録する
route_compliance実験の設計図(route brief)を渡して台本を作らせるとき、台本AIがその指示をどこまで守ったかを4段階で残すようにしました。これが route_compliance です。
| 4段階 | 意味 |
|---|---|
| none | 指示どおり。逸脱なし |
| minor_deviation | 小さな逸脱。狙いは保てている |
| major_deviation | 大きな逸脱。実験の解釈に影響する |
| blocked_by_guardrail | ルール(規制など)に阻まれて作れなかった |
これがあると、実験がうまくいった(or 失敗した)とき、それが「指示が良かったからか」「AIが勝手に変えたせいか」を後から区別できます。
各AIの権限を、プログラムで固定した
テスト118件パス「どのAIが何をしていいか」を、文章だけでなくプログラムのレベルでも縛りました。具体的には —
・台本係(daihon)は、データベース(BQ)には下書きの登録しかできない(本確定や書き換えは禁止)。
・検品係(bucho)から、使っていない余分な権限を削除。
・判断係(handan)を「工場に住み込みで常駐する人」ではなく、「毎朝出勤して判断だけして帰る人」として正式に定義。
この変更で壊れていないことを確かめるため、自動テスト118件がすべて合格しています。
冒頭は「6本」に統一した
6本が正広告の「冒頭(つかみ)」を何パターン作るか。決裁では6本が正しいと決まっているのに、古い設計書やスキルの一部に「8本」という表記が残っていました。これをすべて6本に直しました。
ただし、過去に8本で行った実験の記録はそのまま履歴として残します(歴史を書き換えない)。
全体の流れを図で見る
依頼書ができてから、正式な知識になるまでの一本道です。「小澤レビュー」を通った物だけが右端の正式ナレッジに進めるのがポイント。
実線=ものの流れ/点線=依頼書とやることリストの相互参照(task_id)。検品係は「揃っているか」までを見て、正式知識への昇格は判断しない。昇格の採点は小澤レビューだけが行う。
今日はまだやらないこと(Stage 2以降)
今日はルールブックを固定しただけ。実際に自動化する部分は、数日ルールを運用して確かめてから進めます。
docs/production_brief_contract.md v1.0(2026-07-07)/親文書: docs/aibou_loop_design.md。
用語の正確な定義・フィールド仕様はそちらが優先されます。この解説はやさしく噛みくだいた副読本です。