SUPPLEMENT

補足資料
用語集と出典、デモの設計書

座学とハンズオンで出てくる言葉の定義と、説明の根拠にした公式ドキュメントの一覧です。デモで使った夜間開発のループの設計書も、全文を載せています。

2026年11月26日(木)
補足
オンライン ZOOM ウェビナー
講師 安田 光喜(Givery)
GLOSSARY

用語集

今夜出てくる順に並べています。

言葉意味
ハーネスエンジニアリング特定の作業をAIが再現できる形にし、AIモデル以外のすべての設定を設計すること。コンテキスト、Skills、Hooks、MCP、権限を組み合わせる
ループエンジニアリングハーネスで再現できるようになった作業を、いつ起動し、何を確かめ、どこで止め、何を残すかまで設計すること
起動のきっかけループを始める条件。決まった時刻、ファイルが置かれたとき、Issueが立ったときなど
検証1回の結果が使えるかを、AIの外にある仕組みで確かめること。テスト、検査スクリプト、差分の確認など
受け入れテスト課題が終わったと言える条件を、人が先に書いたテスト。夜間開発のデモでは、AIに編集を許可していない
停止条件ループを止める条件。件数、回数、金額、時間の上限と、始める前に確かめる前提
差し戻し検証に落ちた結果を、理由を付けてAIに直させること。回数に上限を置く
人を呼ぶ条件ループが自分で進めずに、人の判断を待つ条件。誰がどこで気づくかまで決める
ヘッドレス実行対話の画面を開かずにAIを1回動かすこと。Claude Codeはclaude -p、Copilot CLIはcopilot -p
launchdmacOSで、決まった時刻やきっかけでプログラムを起動する仕組み。設定は~/Library/LaunchAgents/のplistファイルに書く
タスク スケジューラWindowsで、決まった時刻にプログラムを起動する仕組み
/loopClaude Codeのセッションの中で、依頼文を決まった間隔で繰り返す機能。定期の繰り返しは7日で止まる
デスクトップ版の定期実行Claude Codeのデスクトップアプリから、手元のPCで決まった時刻に作業を起動する機能
クラウドの定期実行Anthropicのクラウドで、決まった時刻やAPIの呼び出しをきっかけにClaude Codeを動かす機能。PCの電源は要らない
StopフックClaudeが応答を終えようとしたときに動くフック。"decision": "block"と理由を返すと、作業を続けさせられる
--permission-mode dontAsk許可していない操作を、確認を出さずに断る起動のしかた。人がいない時間帯の実行に使う
--max-budget-usdclaude -pの1回の実行で使ってよい金額の上限
再帰的自己改善(RSI)AIが自分自身を改良し続けること。研究の分野で議論されている。今夜扱ったのは、その手前の、手順と設定の直し方をAIが出す範囲
ローカルLLM手元のPCで動かす言語モデル。利用料はかからず、速さと品質はPCの性能で決まる
SERIES

シリーズの各回

3か月ごとに開催している技術シリーズです。各回は独立して完結します。

回開催テーマ教材
第1回2026年5月エージェンティックエンジニアリング0521agentic.give-app.net
第2回2026年8月エージェンティックエンジニアリング ハーネスとコンテキストの基本設計0827agentic-en.give-app.net
第3回2026年11月ハーネス・ループエンジニアリング 2026このサイト
第4回調整中調整中-
SOURCES

公式ドキュメント

座学の説明は、2026年11月に次のページで確かめた内容にもとづいています。機能は随時追加されますので、使う前にこれらのページを開いてください。

ページ確かめたこと
Claude Code 定期実行と/loop/loop、デスクトップ版とクラウドの定期実行の違い、7日で止まる決まり、.claude/loop.md
Claude Code HooksStopフックで作業を続けさせる返し方、PostToolUseでは止められないこと
Claude Code ヘッドレス実行claude -pと、使ってよい道具の渡し方
Claude Code 費用の管理消費の確かめ方とモデルの使い分け
Claude Code GitHub ActionsIssueやプルリクエストをきっかけに動かす方法
VS Code エージェントのHooksプレビュー機能であること、置き場所が.github/hooks/であること
VS Code Agent Skills.claude/skills/に置いたSkillもCopilotが読むこと
GitHub Copilot CLI 対話なしの実行copilot -pと--allow-tool
DEMO

夜間開発のループ設計書

デモ2本目のリポジトリに入れているnight/LOOP.mdの全文です。自分の業務のループを書くときの見本にしてください。

# ループ設計書 夜間の自動開発

issues/open/ の課題を、人が寝ている間に1件ずつ実装するループです。

## 1. 起動のきっかけ

launchd が毎晩1時30分に night/night.sh を起動します。設定は ~/Library/LaunchAgents/com.pxt.nightly-dev.plist にあります。

## 2. 検証

AIの報告ではなく、night.sh が自分で確かめます。

- 変更が src/ の中だけか(git の差分で見る)
- その課題の受け入れテストと、これまでに終えた課題のテストが全部通るか(node --test)

## 3. 停止条件

- 1晩に処理する課題: 1件
- 1件あたりの実装の回数: 2回まで(1回目に落ちたら、テストの失敗を渡して1回だけ直させる)
- 1回の実装で使ってよい金額: 1.5ドル(claude -p の --max-budget-usd)
- 1回の実装にかけてよい時間: 20分(timeout)
- 前の晩の作業が片づいていない(作業ツリーに変更が残っている)ときは始めない

## 4. 記録

- logs/night.tsv: 1晩1行。日時、課題、結果、回数、費用、秒数、理由
- reports/YYYY-MM-DD.md: 朝に人が読む報告書
- logs/attempts/: 実装ごとのAIの出力とテストの出力の全文
- git: 通った課題は main にコミットし、通らなかった課題は night/ で始まるブランチに残す

## 5. 人を呼ぶ条件

- 2回とも検証に落ちた。課題は issues/blocked/ に移し、朝の報告書に理由を書き、Macの通知を出す
- 前の晩の作業が片づいていない
- AIが src/ の外を書き換えた