HELM / SYSTEM / CLAUDE

AI Activation Primer

2026-07 EDITION · CANON: memory/system/claude/ai-activation-primer.md

HARNESS — the machine around the model

Harness = モデルをエージェントに変える周辺機構の総称。 ①ループ ②道具と許可境界 ③記憶 ④規律（ゲート・フック）⑤継続の駆動 ⑥観測。 Claude Code 自体がハーネスであり、下の15プリミティブはその部品カタログ。 helm は人生用ハーネス、hydrogie の経営憲法 as code は「会社をハーネスとして設計する」の実例。

知能はハーネスに書かない（モデルが賢くなるたび足場が負債になる）。書くのは賢さと無関係に真であることだけ — 金銭L0・送信L0・silent skip 禁止・JST。進化の方向は増築ではなく「知能の分を削り、境界の分だけ残す」

HARNESS DESIGN — procedure

仕事を1つ選ぶハーネスは仕事に生える。汎用ハーネスを先に作らない（器が先だと死ぬ）
自分がハーネスになって1回通す手動で1件。必要な道具・判断点・失敗様式がここで全部見える
判断点を3つに仕分ける委ねる / 人間ゲート / コードで強制。基準は2問 — 不可逆か？賢さと無関係に真か？残りは全部モデルへ
最小ハーネスで組むプロンプト+汎用ツールから。専用ツールは境界・観測・実際の失敗箇所にだけ
失敗を観測可能にするlogs・exit code・heartbeat・APNs。「不在で発見される失敗」を設計段階で殺す
敵対レビュー → 実運用 → 還流教訓をルール/lint/ツールに還流（THE SEQUENCE と同じ骨格）

モデルに見せるものは全部UI — ツール定義・エラー文は次の一手を導くように書く

文脈は予算 — 常時注入は最小、詳細は progressive disclosure（hot.md 3,000字はこの実装）

キャッシュを設計する — 静的を先頭に。編集でなく system-reminder 追記。モデル切替はキャッシュを壊す

検証はハーネスの仕事 — 自己申告と API 報告値を信じない。書き込みには staleness check

冪等と再開 — run state を持ち、途中死しても再実行で壊れない

定期的に削る — 「何をやめられるか？」を四半期ごとに。古い回避策は新モデルの足枷

PRE-PRODUCTION CHECKLIST — before it runs unattended

この仕事を手動で1回、最後まで通したか
全判断点が「委ねる / ゲート / 強制」に分類されているか
不可逆操作（送信・金銭・削除・公開）はすべて人間ゲートか
失敗は通知されるか — 不在によって発見される失敗が残っていないか
すべての注入依存に working default があるか
再実行・途中再開で壊れないか（冪等 / run state）
モデルの自己申告・API 報告値に頼った検証がないか
既知の違反を1件食わせて、検出されることを証明したか
静的→動的の順にプロンプトが並び、キャッシュが効くか
「モデルが1世代賢くなったら、どこを削れるか」に答えられるか

WHAT DO I USE? — tap a situation

#	PRIMITIVE	DEFINITION	DECISION RULE
1	CLAUDE.md / rules	毎セッション注入される恒常指示	常時必要な短いルール（<200行/file）。手順書は書かない
2	Skills	自動トリガー可能な再利用手順書	複数ステップの定型作業。CLAUDE.md に収まらない手順
3	Slash commands	手動起動	スキルの手動入口（/skill-name）
4	Subagent	別コンテキストでの委任実行	メイン文脈の節約・ツール制限・fan-out。リサーチ/レビュー向き
5	Hooks	ライフサイクル固定発火（推論を経ない）	強制が必要なもの。CLAUDE.md は助言、hook は必ず発火
6	MCP	外部システムへのライブ接続	データをチャットにコピペし始めたら導入サイン
7	Headless claude -p	非対話の単発実行	スクリプト部品。mini の draft-batch が実例
8	launchd	Mac 上の無人定期実行	ファイル直結の夜間処理。helm の標準（憲法§7: mini のみ）
9	Routines beta	Anthropic 側での無人定期実行	マシン非依存にしたい定期処理。要再検証
10	Model tiering	能力×コストの配車	判断=上位・量=下位。docs/design/2026-07-08-model-tiering.md
11	Managed Agents	クラウド常駐エージェント基盤	本番の長時間・ステートフル運用を Anthropic 側に持たせる
12	Agent SDK	プログラムからのエージェント制御	Claude Code を「製品の部品」にする段階。Hydrogie の将来形
13	Auto-memory	セッション横断の学習メモ	マシン固有・自動。安定した学びは CLAUDE.md/wiki に昇格
14	/goal	完了条件を満たすまでターンを回し続ける	検証可能な終了状態のある大仕事。小型モデルが毎ターン条件判定・headless 可
15	/loop	時間間隔でプロンプトを再実行	外部状態のポーリング（CI・デプロイ・PR番）。セッション内・7日失効

EXECUTION LAYERS

INTERACTIVEclaude CLI / desktop — 探索・要件定義・人間ゲート

LOCAL AUTOlaunchd + headless — 定期処理・ファイル直結（現行標準）

CLOUD AUTORoutines (beta) — マシン非依存が要るときのみ

PRODUCTIONManaged Agents / SDK — hydrogie の自律運営を製品化する段階

MODEL ROUTING

FABLE / OPUS判断・設計・要件定義 — inline（本人が握る）

SONNET / HAIKU量・fan-out・下請け — subagent / worker

ADVISOR安い実行役が詰まったときだけ上位へ1回相談（/advisor）

単価は変動するため固定記載しない — models/overview を四半期ごとに再確認（次回 2026-10）

SESSION CONTINUATION — what starts the next turn?

METHOD	NEXT TURN STARTS	STOPS WHEN	FITS
/goal	前ターンの終了	小型モデルが条件成立を判定	検証可能な終了状態のある大仕事（全テスト green・キュー空）
/loop	時間間隔の経過	手動停止 or Claude が完了判断	外部状態のポーリング
Stop hook	前ターンの終了	自作スクリプト/プロンプトの判定	全セッション適用の独自判定

/goal の条件: ①測定可能な終了状態 ②証明方法 ③制約 + 「or stop after 20 turns」。 /loop は間隔+プロンプト=固定 / プロンプトのみ=自律ペース / 裸=loop.md。7日失効 — 恒久化は launchd へ

THE SEQUENCE — new AI-heavy initiative

要件定義対話（対話・上位モデル）制約と語彙を出し切る。教科書から始めない
最小スライス（ローカル）最狭経路を1本だけ。1件・実データ・手動ゲート付き
敵対レビューadversarial-reviewer / Codex クロスで設計を攻撃させる
ローカル自動化（launchd）昇格条件: 手動3回連続成功。コスト検分はここで — クラウド投資の前
堅牢化hooks・検証・通知・tiering。silent skip を残さない
クラウド移管（必要な場合のみ）Routines / Managed Agents
教訓の成文化retrospective-codify → Playbook 1ページ + ルール/スキル昇格

実績: email-draft-batch / monthly-close 設計 / HelmApp はすべてこの順で成功している

PLAYBOOK RULES

RULE実案件を1つ通すたび、memory/system/claude/ に 1ページだけ蒸留（tag: ai-playbook）
RULEページが増えてから索引を作る。先に器を作らない（self-audit 2026-07: 器が先だと死ぬ）
QUEST2026-Q3: 実案件から型を4つ抽出 = Playbook 4ページの存在で完了判定
FIRST1ページ目 = monthly-close 実装（orchestration・run state・ゲート設計）

KNOWN UNCERTAINTIES — 2026-07-08

Routines は beta — API 安定性は要再検証。 /goal は v2.1.139+、/loop のスキル実行制御は v2.1.196+（mini 側バージョン確認）。単価・レート制限は次回 vision alignment（2026-10）で再確認。 Blog 要諦: ループは反復・判断・検証が要る仕事に。停止条件を必ず書く。ハーネス3原則 — 道具はモデルに寄せる / 削ぎ落とす / 境界だけ明示設計。