LECTURE

座学編
ハーネスとループの設計とデモ

今夜の[120min]のうち、講師が話す[80min]分の資料です。前半でハーネスとループの違いを整理し、ループを5つの要素に分けます。後半では、講師が毎日動かしている2つのループを、設定ファイルと実行の記録で読みます。手元の環境は使いません。

2026年11月26日(木)
座学 [80min]
オンライン ZOOM ウェビナー
講師 安田 光喜(Givery)
この座学で扱うこと
[10min]

オープニング座学

第1回と第2回で扱った範囲と、「任せたら回り続ける」形に移ると変わることをお伝えします。

[30min]

ハーネスとループ座学

2つの言葉の定義と違い、ループの5つの要素、起動のしかた、検証と停止条件、回し続けるときの費用を扱います。

[20min]

ループのデモライブデモ

毎朝の自動ニュース収集と夜間の自動開発を、設定ファイルと実行の記録で読み、止まった日の理由を確かめます。

[20min]

振り返り・次回予告・質疑応答座学

概念と実装の対応を1枚の表にまとめ、AIが自分の結果から手順を直していくループに触れてから質疑に入ります。

SESSION 01 ・ [10min]

オープニング

最初の10分で、第1回と第2回で扱った範囲と、今夜進む範囲の境目をお伝えします。

01 シリーズの中での位置

第1回(2026年5月)では、Hooks・Skills・サブエージェントの3つの部品を1つずつ動かしました。第2回(2026年8月)では、その部品に何を読ませてどこで止めるかを決めるハーネスとコンテキストを扱い、架空のヘルプデスクへの問い合わせ1件に、人が見ている前で一次回答を作りました。

今夜は、第2回で組んだ1件の処理を、人が呼ばなくても繰り返し回る形に組み替えます。ハンズオンの配布データも、第2回の問い合わせの題材を引き継いでいます。

第1回・第2回に参加していない方へ

前回までの内容を覚えていることは前提にしていません。ハーネスの部品は完成した状態で配布し、今夜さわるのはループの設計書の空欄だけです。言葉の定義は補足ページの用語集にも置いています。

02 回り続ける形で変わること

人が見ている前で1回動かすときは、おかしな出力が出ても、その場で人が気づいて止められます。繰り返し回す形に移ると、この前提が4つ外れます。

変わること1回動かすとき回し続けるとき
許可の確認画面の前の人が答える答える人がいない。事前に決めた範囲だけが通る
失敗の気づき方出力を見てすぐ気づく記録を読むまで気づかない
費用1回分回数分。止まらなければ上限まで積もる
直す場所依頼文を言い直す設定と手順を直し、次の回から効かせる

ループの設計は、人が受け持っていたこの4つを、仕組みの側に移す作業です。

03 今夜の見取り図

今夜の言葉は、下の図の2つの層に分かれます。内側のハーネスが1回の実行の質を決め、外側のループが繰り返しの回り方を決めます。デモとハンズオンでファイル名が出てきたら、どちらの層のものかをこの図で確かめてください。

ループ 繰り返しの回り方を決める ハーネス 1回の実行の質を決める コンテキスト Skills Hooks MCP 権限 モデルそのものは変えない 1 起動のきっかけいつ、何で始めるか 2 検証何を機械で確かめるか 3 停止条件どこで止めるか 4 記録何を残すか 5 人を呼ぶ条件いつ人に知らせるか
SESSION 02 ・ [30min]

ハーネスとループ

2つの言葉の定義をそろえてから、ループを5つの要素に分けます。最後に、回し続けるときの費用の考え方を扱います。

01 ハーネスエンジニアリング

ハーネスエンジニアリングは、特定の作業をAIが再現できる形にし、AIモデル以外のすべての設定を設計する仕事です。同じモデルを使っていても、何を読ませ、何をさせず、どの手順で進ませ、どう確かめるかが変われば、結果も変わります。

部品決めること今夜の配布データでの場所
コンテキスト何を根拠にさせるかCLAUDE.mdとcontext/
Skillsどの手順で進ませるか.claude/skills/loop-run/SKILL.md
Hooksどこで必ず止め、何を必ず残すかhooks/approval-gate.shとhooks/record-write.sh
MCP外のどの道具を呼ばせるか今夜は使いません
権限どこに書かせ、何を打たせないか.claude/settings.json

ハーネスの出来は、同じ1件を何度動かしても同じ品質で返ってくるかで確かめます。第2回のハンズオンで、context/の数行を書き換えただけで出力が別物になったのは、この層の働きです。

Tips GitHub Copilotでの置き場所

コンテキストは.github/copilot-instructions.mdに置きます。Skillsは.github/skills/のほか、.claude/skills/に置いたものも読まれます。VS CodeのCopilotにもHooksがプレビュー機能として入っていて、置き場所は.github/hooks/です。Claude Codeの.claude/settings.jsonのHooksは読まれません。

02 ループエンジニアリング

ループエンジニアリングは、ハーネスで再現できるようになった作業を、いつ起動し、何を確かめ、どこで止め、何を残すかまで設計する仕事です。ハーネスが1回の質を決めるのに対し、ループは回数をまたいだ振る舞いを決めます。

ループの出来は、人が見ていない間に何が起きたかを、翌朝に記録だけで説明できるかで確かめます。

03 2つの違いと組み合わせる順番

観点ハーネスループ
決めるもの1回の実行の質繰り返しの回り方
主な部品コンテキスト、Skills、Hooks、MCP、権限起動、検証、停止条件、記録、人を呼ぶ条件
失敗の現れ方1件の出力がおかしい止まらない、止まりすぎる、止まった理由が分からない
直す場所コンテキストと手順設計書と起動の設定

組み合わせるときは、ハーネスを先に仕上げます。手で動かしても毎回やり直しになる作業をループに載せると、やり直しが回数分に増えるだけです。今夜のハンズオンも、Step 2で1件を手で通してから、Step 5でループに載せる順にしています。

Tips ループに載せる目安

講師は、手で3回動かして3回とも直さずに使えた作業だけをループに載せています。1回でも直したなら、直した内容をハーネスの側に書き足してから、もう一度3回を数えます。

04 ループの5つの要素

ループは5つの要素で書けます。講師のニュース収集と夜間の自動開発、今夜のハンズオンのループを並べると、次のようになります。

要素決めることニュース収集夜間の自動開発ハンズオン
起動のきっかけいつ、何で始めるかlaunchdが毎朝8:30launchdが毎晩1:30受講者がチャットで頼む
検証何を機械で確かめるか字数、レイアウト、改行の検査人が書いた受け入れテストchecks/check-reply.sh
停止条件どこで止めるか候補が出なければ中止。検査で落ちたら巻き戻して終了1晩1件、2回まで、1.5ドル、20分件数と差し戻しの上限
記録何を残すかcollect.lognight.tsvと朝の報告書loop-log.tsvとprocessed.txt
人を呼ぶ条件いつ人に知らせるか仕組みがない2回落ちたらMacに通知needs-human/に書く

5つのうち後回しにされやすいのは、人を呼ぶ条件です。講師のニュース収集にもこの仕組みが入っていないので、止まった日に気づけるのは、ログを開いたときだけです。デモでその状態をお見せします。

05 起動のきっかけの選び方

起動のしかたは、PCの電源が要るかどうかと、許可の確認に誰が答えるかで選びます。Claude Codeの公式ドキュメントでは、次の仕組みが案内されています。

仕組みどこで動くかPCの電源向いている使い方
/loop開いているセッションの中要る作業中に決まった間隔で見張らせる。定期の繰り返しは7日で止まる
デスクトップ版の定期実行手元のPC要る手元のファイルを使う作業を、毎朝決まった時刻に回す
クラウドの定期実行Anthropicのクラウド要らないリポジトリを相手にする作業。間隔は最短1時間
claude -pとOSの定期実行手元のPC(launchd、cron、タスク スケジューラ)要る起動の条件、使ってよい道具、記録の残し方を自分で決めたいとき
GitHub ActionsGitHubの実行環境要らないIssueやプルリクエストの動きをきっかけに回す

GitHub Copilotでは、Issueを割り当てるとクラウドで実装してプルリクエストを作るcoding agentと、copilot -pで対話なしに動かすCopilot CLIが、同じ役割を持ちます。

講師の2つのループは、どちらもclaude -pとlaunchdで動かしています。起動の時刻、使ってよい道具、金額の上限を、1本のスクリプトに書いて残せるためです。

Tips /loopの既定の依頼文

/loopを引数なしで打つと、.claude/loop.mdに書いた内容が依頼文として使われます。決まった見張りの作業があるなら、依頼文を毎回打たずに、このファイルに置いておけます。

デスクトップのフォルダが夜に読めなくなる

講師の環境では2026年8月末にmacOSの設定が変わり、launchdから起動したジョブがデスクトップ配下を読めなくなりました。教材のドラフトを作る夜間ジョブは、それ以降一晩も完了していません。夜間開発のデモ用リポジトリをデスクトップの外に置いているのは、このためです。

06 検証の置き場所

ループの検証は、AIの報告ではなく、AIの外にある仕組みで行います。人が見ていない間は、AIが「通りました」と書いた報告を確かめる人がいないためです。

講師の夜間開発では、受け入れテストを人が先に書き、AIにはテストの編集を許可していません。テストを走らせて合否を決めるのも、AIではなくループのスクリプトです。AIがsrc/の外を書き換えていたら、テストが通っても不合格にしています。

verify() {
  # 変更が src/ の中だけかを git の差分で見る
  outside="$(git status --porcelain | awk '{print $2}' | grep -v '^src/' || true)"
  [ -n "$outside" ] && return 1
  # その課題と、これまでに終えた課題のテストを全部流す
  node --test $TESTS > "logs/attempts/$TODAY-$ID-$1-test.txt" 2>&1
}

ハンズオンも同じ形です。検証スクリプトが結果をlogs/loop-log.tsvに書き、AIが書くstate/processed.txtと突き合わせられるようにしてあります。

07 停止条件と人を呼ぶ条件

停止条件には、止まらないことを防ぐ条件と、止まったまま気づかれないことを防ぐ条件の2種類があります。講師の夜間開発では、次の5つを決めています。

種類決めること夜間開発での値
件数1回で処理する数1晩に1件
回数同じものを直す回数2回まで
金額1回で使ってよい額--max-budget-usd 1.5
時間1回にかけてよい時間timeout 1200(20分)
前提始める前に確かめること前の晩の変更が残っていたら始めない

回数の上限は、AIの見込みではなく、記録に残った回数で数えます。ハンズオンの準備で講師がループを試したとき、AIは1回落ちた時点で「直しても通らない」と判断し、2回目の検証を省いて人を呼びました。判断としては正しくても、設計書の「2回落ちたら」と記録が食い違います。手順に「見込みで回数を省かない」と書き足し、2回目も記録に残る形にしました。

Stopフックで止めない仕組みを入れるとき

Claude CodeのStopフックは、"decision": "block"と理由を返すと、Claudeに作業を続けさせられます。全部終わるまで止めないループを手早く組めますが、終わる条件を満たせない課題が1件あると、上限に当たるまで回り続けます。止めない仕組みを入れるときは、回数か金額の上限を同じ場所に書いてください。

人を呼ぶ条件には、誰がどこで気づくかまで書くのが決まりです。講師の環境には、ニュース収集の失敗をセッションの開始時に表示する仕組みがあります。ところが失敗の記録が消えるのは同じ日付のジョブが成功したときだけなので、11月4日から毎日成功していても、11月1日から3日の失敗が表示され続けている状態です。同じ通知が出続けると、人はやがて読まなくなります。

08 回し続けるときの費用

ループの費用は、1回の消費に回数を掛けたものです。講師の実測では、1回の消費は処理の中身より、起動のたびに読み直す設定とコンテキストの量で決まっていました。

実行処理した数費用時間
ハンズオンのループの1回目3件0.45ドル2分32秒
ハンズオンのループの2回目1件0.43ドル1分19秒
夜間開発で1回目に合格した晩1件0.12〜0.13ドル26〜28秒
夜間開発で2回とも落ちた晩1件0.22ドル45秒

ハンズオンのループが3件でも1件でも0.4ドル台なのは、起動のたびにcontext/と手順を読み直す分が、毎回同じだけかかるためです。起動の回数を増やすほどこの分が積もるので、1回にまとめて処理する件数と、起動の間隔を一緒に決めます。

講師が費用を減らすために行っていることは3つあります。

やり方講師のループでの例
ツールの出力を短くして渡す夜間開発では、テストの出力の全文はファイルに残し、AIには失敗の理由の行だけを渡す
モデルを使い分ける手順の決まった実装はsonnetを指定し、設計の判断が要る作業だけを上位のモデルに回す
上限を分け合うループの数を数える2026年10月22日に利用の上限に当たり、ニュース収集、夜間の動画収集、採点、締切の同期の4つが同じ日に止まった

手元のPCで動くローカルLLMも、モデルの使い分けの候補になります。利用料はかかりませんが、速さと品質がPCの性能で決まるので、手順の決まった短い作業から試すのが向いています。

成果物 ハーネスとループの設計チェックリスト
  • 1件を手で3回動かし、3回とも直さずに使えた
  • 検証はAIの外にあり、結果が記録に残る
  • 件数、回数、金額、時間の上限が書いてある
  • 前の回の作業が残っていたら始めない
  • 人を呼ぶ条件と、誰がどこで気づくかが書いてある
  • 止まった日の理由を、記録だけで説明できる
  • 同じ利用上限を使うループの数を把握している

配布データのmy-loop/CHECKLIST.mdにも同じ7項目を入れています。

SESSION 03 ・ [20min]

ループのデモ

講師が毎日動かしている2つのループを、設定ファイルと実行の記録で読みます。講師の画面で進めますので、手元の環境は使いません。

01 毎朝の自動ニュース収集

生成AIの最新トレンド資料に、毎朝1件ずつニュースを足しているループです。launchdが毎朝8:30にスクリプトを起動し、Claude Codeが7つの観点で調べて候補を3〜5件出します。スクリプトが1件を選んでスライドに足し、レイアウトと改行の検査で落ちたら追記を巻き戻します。顧客のサイトへの反映は人が判断するので、ループはそこまでは行いません。

8:30に起動
→
調べる
→
1件を選ぶ
→
スライドに足す
→
検査
→
落ちたら巻き戻す

2026年10月10日から11月8日までの30日の結果です。

毎朝のニュース収集 2026年10月10日から11月8日まで 10/1010/1510/2010/2511/111/511/8 成功 20日候補が出ず中止 4日検査で巻き戻し 3日採用なし 2日記録なし 1日
止まり方日数日付と理由
候補が出ずに中止4日10月13日、11月1日、11月5日はネットにつながらなかった。10月22日は利用の上限に当たった
検査で落ちて巻き戻し3日10月26日と11月6日はレイアウトの検査で落ちた。10月30日は検査器そのものがファイルの読み込みで止まり、正しい候補まで巻き戻した
採用なし2日10月12日と10月24日は、候補が全部、字数か改行の検査で落ちた
記録なし1日10月31日は開始の行だけが残り、終わった記録も理由もない

11月5日は8:50に始まり、失敗と判定されたのは10:21でした。ネットにつながらないまま1時間31分待っていたことになります。時間の上限を決めていないと、止まるまでの時間は相手の都合で決まります。

02 夜間の自動開発

ヘルプデスクで使う小さな関数を、1晩に1件ずつ実装させるループです。今回のセミナーのために、2026年11月10日から毎晩1:30に動かしています。課題は10件あり、どの課題にも人が先に書いた受け入れテストが付いています。

1:30に起動
→
前の晩の作業を確かめる
→
課題を1件選ぶ
→
実装させる
→
差分とテストで検証
→
朝の報告書

検証に通った課題はmainに取り込み、2回とも落ちた課題はissues/blocked/に移してMacに通知を出します。4件目の課題は、総務部が用意する祝日一覧のファイルが無いと通らないように作ってあります。試運転では、AIは祝日を実装に直接書き込まずに2回とも止まり、朝の報告書に足りないものを書きました。

## AIの最後の報告

ISSUE-004 は実装せずに終わります。前提の data/holidays.json がないためです。
祝日を実装に直接書き込む回避もしていません。祝日一覧は総務部が持つデータだからです。

人が対応してほしいこと
- 総務部から祝日一覧を受け取り、data/holidays.json に置いてください。

当日は、本番までの毎晩の記録をlogs/night.tsvで読み、止まった晩の報告書を開きます。

Tips 夜は許可の設定が読まれないことがある

試運転の1回目は、AIの書き込みが全部断られました。新しいフォルダを一度も対話で開いておらず、Claude Codeがフォルダの許可設定を読まなかったためです。夜は信頼の確認に答える人がいないので、使ってよい道具はnight.shからclaude -pの引数で渡す形に直しました。

03 止まった日の読み方

2つのループの記録を並べると、止まった理由は次の4つに分けて読めます。

分類講師の記録での例直す場所
ループの外の環境ネットにつながらない、OSの権限が外れた起動の条件と時間の上限
上限利用の上限、金額の上限起動の回数と間隔、上限を分け合うループの数
検証で落ちたレイアウトの検査、受け入れテストハーネスか、課題そのもの
仕組み自身の不具合検査器の誤作動、終わりの記録がないループのスクリプト

4つのうち、ループが設計どおりに働いた結果は3つ目の「検証で落ちた」だけです。残りの3つは、ループの設計か環境を直します。検査器が止まった日を内容の不合格と同じ記録にしていると、この区別がつかなくなります。

SESSION 04 ・ [20min]

振り返り・次回予告・質疑応答

今夜の言葉と、ハンズオンと夜間開発のファイルの対応を1枚にまとめます。

01 概念と実装の対応

今夜の言葉ハンズオンのファイル夜間開発のファイル
コンテキストCLAUDE.md、context/CLAUDE.md、issues/
手順.claude/skills/loop-run/SKILL.mdnight/night.shの依頼文
権限.claude/settings.jsonclaude -pの--allowedTools
起動のきっかけチャットで頼む。持ち帰ったあとはschedule/launchd
検証checks/check-reply.shgitの差分とnode --test
停止条件loop/LOOP.mdの3night/night.shの先頭の4つの値
記録logs/loop-log.tsv、state/processed.txtlogs/night.tsv、reports/
人を呼ぶ条件needs-human/issues/blocked/とMacの通知

02 自己改善のループ

ハンズオンの準備でループを回したとき、AIは処理の報告の最後に、設計書の直し方を1つ提案しました。「判断できません」になる件は必ず2回落ちるので、最初から人を呼ぶ条件に入れれば、検証を1回むだに回さずに済む、という案です。

研究の分野では、AIが自分自身を改良し続ける再帰的自己改善(RSI)が議論されています。業務のループで今すぐ使えるのはその手前で、AIが自分の結果を読み、手順や設定の直し方を出す範囲です。

講師の運用では、AIに出させるのは改善の案までにしています。設計書と検証を書き換える権限は人が持ちます。検証を直す権限までAIに渡すと、通らない課題を、検証を緩めて通せるようになるためです。ハンズオンのStep 6でも、AIに改善案を1つ出させ、採るかどうかは受講者が決める形にしています。

03 次回と質疑応答

今夜は、1本ずつ独立したループを扱いました。複数のループが同じ利用上限や同じファイルを分け合うときの設計は、今夜の範囲の外に残っています。第4回のテーマは調整中です。

このあと、チャット欄でいただいた質問に時間の範囲でお答えします。答えきれなかった質問は、開催後にトップページへ回答を載せます。

出典