@takuma-hirai/hirai-method 0.1.0

package/.claude/hooks/check-required-env.sh

@@ -0,0 +1,95 @@
+#!/usr/bin/env bash
+# check-required-env.sh — SessionStart hook that warns about missing required env vars.
+#
+# 役割:
+#   harness-config.yml の `required_env` を読み、未設定エントリを stderr に出して
+#   ユーザーに通知する。fail-open: 未設定でも block せず exit 0 で続行する。
+#
+# 形式 (harness-config.yml):
+#   required_env: ["NAME|severity|purpose", ...]
+#   severity:
+#     error → ❌ MISSING required env: <NAME> (<purpose>)
+#     warn  → ⚠️  Recommended env not set: <NAME> (<purpose>)
+#     info  → ℹ️  Optional env not set: <NAME> (<purpose>)
+#
+# Stdin: SessionStart hook JSON (read but unused for now)
+# Stdout: 空 (statusMessage / decision JSON は不要 — fail-open)
+# Stderr: 未設定エントリのリスト
+# Exit:   常に 0 (fail-open)
+#
+# bash 3.2 互換 (macOS 標準) で動作する。
+
+set -uo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/config-loader.sh
+. "$SCRIPT_DIR/lib/config-loader.sh"
+
+# Feature toggle 参照 (task-45 Phase 2)
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled check_required_env; then
+  exit 0   # feature OFF で no-op
+fi
+
+# stdin を捨てる (SessionStart JSON は使わない)
+cat >/dev/null 2>&1 || true
+
+[ -z "${HC_REQUIRED_ENV:-}" ] && exit 0
+
+# entry list は newline 区切り (config-loader が `[a, b]` を改行区切りに正規化)。
+# bash 3.2 互換のため while read で 1 件ずつ処理。
+output=""
+
+while IFS= read -r entry; do
+  [ -z "$entry" ] && continue
+  # entry: "NAME|severity|purpose"
+  name="${entry%%|*}"
+  rest="${entry#*|}"
+  if [ "$rest" = "$entry" ]; then
+    # `|` が無い不正フォーマット → skip
+    continue
+  fi
+  severity="${rest%%|*}"
+  purpose="${rest#*|}"
+  if [ "$purpose" = "$rest" ]; then
+    purpose=""
+  fi
+
+  # 前後空白 trim + severity を lowercase
+  name="$(printf '%s' "$name" | tr -d '[:space:]')"
+  severity="$(printf '%s' "$severity" | tr -d '[:space:]' | tr '[:upper:]' '[:lower:]')"
+  # purpose は前後空白だけ trim (中身の空白は保持)
+  purpose="${purpose#"${purpose%%[![:space:]]*}"}"
+  purpose="${purpose%"${purpose##*[![:space:]]}"}"
+
+  [ -z "$name" ] && continue
+
+  # 未設定判定: bash 3.2 互換で eval を使う
+  eval "_hc_value=\${$name:-}"
+  if [ -n "${_hc_value:-}" ]; then
+    continue
+  fi
+
+  case "$severity" in
+    error)
+      output="${output}[harness] \xe2\x9d\x8c MISSING required env: ${name} (${purpose})\n"
+      ;;
+    info)
+      output="${output}[harness] \xe2\x84\xb9\xef\xb8\x8f  Optional env not set: ${name} (${purpose})\n"
+      ;;
+    *)
+      # default = warn
+      output="${output}[harness] \xe2\x9a\xa0\xef\xb8\x8f  Recommended env not set: ${name} (${purpose})\n"
+      ;;
+  esac
+done <<EOF
+$HC_REQUIRED_ENV
+EOF
+
+unset _hc_value
+
+if [ -n "$output" ]; then
+  printf "%b" "$output" >&2
+  printf "[harness] Set them via shell rc, .env, or direnv. See docs/PORTABILITY.md\n" >&2
+fi
+
+exit 0

package/.claude/hooks/check-serena-mcp.sh

@@ -0,0 +1,123 @@
+#!/usr/bin/env bash
+# check-serena-mcp.sh — SessionStart hook
+#
+# 役割:
+#   `.mcp.json` の `serena` entry 存在を SessionStart で確認する。
+#   不在時は <system-reminder> を stdout に流して導入手順を提示する。
+#   `/save-state` `/resume-state` `/pm-start` が Serena MCP を memory
+#   backend として必須化したことに伴う警告。
+#
+# 失敗時の挙動: 常に exit 0 (fail-open — セッションをブロックしない)。
+#
+# 環境変数:
+#   HC_CHECK_SERENA_ENABLED=false  ... 一時無効化 (Serena 不要環境向け)
+#
+# Stdin:  SessionStart hook JSON (読み捨て)
+# Stdout: 警告 <system-reminder> ブロック (serena 不在時のみ)
+# Stderr: 未使用
+# Exit:   常に 0
+#
+# 制約:
+#   file-top に `set -euo pipefail` を書かない (feedback_set_e_in_sourced_libs 規範)。
+#   `set -u` のみ採用 (caller shell flags への leak を防ぐ)。
+
+set -u
+
+# config 読み込み (HC_* 変数 + is_feature_enabled 関数 export、task-45 Phase 2)
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/config-loader.sh
+. "$SCRIPT_DIR/lib/config-loader.sh" 2>/dev/null || true
+
+# Feature toggle 参照 (task-45 Phase 2)
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled check_serena_mcp; then
+  exit 0   # feature OFF で no-op
+fi
+
+# stdin 消費 (SessionStart JSON は使わない)
+cat >/dev/null 2>&1 || true
+
+# 無効化チェック
+if [ "${HC_CHECK_SERENA_ENABLED:-true}" = "false" ]; then
+  exit 0
+fi
+
+# shellcheck source=lib/project-root.sh
+source "$SCRIPT_DIR/lib/project-root.sh"
+PROJECT_ROOT=$(resolve_project_root)
+MCP_JSON="$PROJECT_ROOT/.mcp.json"
+
+# Case A: .mcp.json 自体が不在 → 警告 + 導入手順
+if [ ! -f "$MCP_JSON" ]; then
+  cat <<'EOF'
+<system-reminder>
+**HIRAI メソッド: Serena MCP 未設定の警告**
+
+`.mcp.json` が見つかりません。`/save-state` `/resume-state` `/pm-start` は
+Serena MCP を memory backend として必須とします。
+
+**導入手順**:
+1. プロジェクト root に `.mcp.json` を作成
+2. 以下の `serena` entry を追加:
+```json
+{
+  "mcpServers": {
+    "serena": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "git+https://github.com/oraios/serena",
+        "serena",
+        "start-mcp-server",
+        "--context",
+        "ide-assistant"
+      ]
+    }
+  }
+}
+```
+
+警告を一時無効化: `export HC_CHECK_SERENA_ENABLED=false`
+</system-reminder>
+EOF
+  exit 0
+fi
+
+# Case B: .mcp.json 存在 → `serena` entry 有無を確認
+# jq があれば構造的 parse、無ければ grep で簡易検出 (silent fallback)。
+has_serena=""
+if command -v jq >/dev/null 2>&1; then
+  has_serena=$(jq -r '.mcpServers.serena // empty' "$MCP_JSON" 2>/dev/null || echo "")
+else
+  has_serena=$(grep -E '"serena"[[:space:]]*:' "$MCP_JSON" 2>/dev/null || echo "")
+fi
+
+if [ -z "$has_serena" ]; then
+  cat <<'EOF'
+<system-reminder>
+**HIRAI メソッド: Serena MCP 未登録の警告**
+
+`.mcp.json` に `serena` entry が見つかりません。
+`/save-state` `/resume-state` `/pm-start` は Serena MCP を memory backend
+として必須とします。
+
+**追加手順**: `.mcp.json` の `mcpServers` に以下を追加:
+```json
+"serena": {
+  "command": "uvx",
+  "args": [
+    "--from",
+    "git+https://github.com/oraios/serena",
+    "serena",
+    "start-mcp-server",
+    "--context",
+    "ide-assistant"
+  ]
+}
+```
+
+警告を一時無効化: `export HC_CHECK_SERENA_ENABLED=false`
+</system-reminder>
+EOF
+fi
+
+exit 0

package/.claude/hooks/confidence-gate.sh

@@ -0,0 +1,139 @@
+#!/usr/bin/env bash
+# confidence-gate.sh — SubagentStop hook (F3) — confidence threshold gate
+#
+# Orchestrator: env load + bypass / disable check + tool_response/transcript fallback + threshold compare。
+# 個別 logic は lib/confidence-gate/ に分割:
+#   - bypass.sh             — bypass marker + log_failure helper
+#   - extract.sh            — confidence regex / tool_response text / transcript text 抽出
+#   - major-agent-filter.sh — F3 major subagent only judgment
+#   - messages.sh           — block reason text 生成
+#
+# Hook event: SubagentStop
+# Output:
+#   pass  → exit 0 + `{}` （素通し）
+#   block → exit 0 + `{"decision":"block","reason":"..."}` （SubagentStop block JSON）
+# Bypass:
+#   ECC_CONFIDENCE_GATE=off / HC_CONFIDENCE_REQUIRED=false / /gate-bypass confidence
+
+set -u
+
+SCRIPT_DIR="$(dirname "$0")"
+# shellcheck source=lib/config-loader.sh
+source "$SCRIPT_DIR/lib/config-loader.sh"
+
+# Feature toggle 参照 (task-45 Phase 2)
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled confidence_gate; then
+  echo '{}'
+  exit 0   # feature OFF で no-op
+fi
+
+# shellcheck source=lib/confidence-gate/bypass.sh
+source "$SCRIPT_DIR/lib/confidence-gate/bypass.sh"
+# shellcheck source=lib/confidence-gate/extract.sh
+source "$SCRIPT_DIR/lib/confidence-gate/extract.sh"
+# shellcheck source=lib/confidence-gate/major-agent-filter.sh
+source "$SCRIPT_DIR/lib/confidence-gate/major-agent-filter.sh"
+# shellcheck source=lib/confidence-gate/messages.sh
+source "$SCRIPT_DIR/lib/confidence-gate/messages.sh"
+
+# Phase β: F3 disable for SWE-bench grid evaluation (fail-open)
+if [ "${ECC_F3_OFF:-0}" = "1" ] || [ "${ECC_F3_OFF:-}" = "true" ]; then
+  if command -v jq >/dev/null 2>&1; then
+    jq -n '{decision:"approve", reason:"F3 (confidence-gate) disabled via ECC_F3_OFF"}'
+  else
+    printf '{"decision":"approve","reason":"F3 (confidence-gate) disabled via ECC_F3_OFF"}\n'
+  fi
+  exit 0
+fi
+
+# === bypass / disable check ===
+if [ "${ECC_CONFIDENCE_GATE:-}" = "off" ]; then echo '{}'; exit 0; fi
+if [ "${HC_CONFIDENCE_REQUIRED:-true}" = "false" ]; then echo '{}'; exit 0; fi
+
+input=$(cat)
+
+if ! command -v jq >/dev/null 2>&1; then echo '{}'; exit 0; fi
+
+init_bypass_paths
+handle_bypass_marker
+
+emit_block() { jq -n --arg r "$1" '{decision:"block", reason:$r}'; }
+
+agent_type=$(printf '%s' "$input" | jq -r '.agent_type // empty' 2>/dev/null)
+transcript=$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)
+_cg_agent_id=$(printf '%s' "$input" | jq -r '.agent_id // empty' 2>/dev/null)
+transcript=$(resolve_subagent_transcript "$transcript" "$_cg_agent_id")
+unset _cg_agent_id
+
+is_sidechain=$(classify_sidechain "$transcript")
+is_major=$(is_major_subagent "$agent_type" "$is_sidechain")
+
+threshold="${HC_CONFIDENCE_THRESHOLD:-0.6}"
+
+compare_and_emit() {
+  local score="$1"
+  local fail_phase="$2"
+  local ok
+  ok=$(awk -v s="$score" -v t="$threshold" 'BEGIN { print (s+0 >= t+0) ? "1" : "0" }')
+  if [ "$ok" = "1" ]; then echo '{}'; exit 0; fi
+  log_failure "$fail_phase" "score=${score} threshold=${threshold} sidechain=${is_sidechain}"
+  if [ "$fail_phase" = "below_threshold_via_tool_response" ]; then
+    emit_block "[confidence-gate] tool_response 経由で抽出した confidence ${score} が閾値 ${threshold} 未満です。"
+  else
+    emit_block "$(build_below_threshold_reason "$score" "$threshold")"
+  fi
+  exit 0
+}
+
+extract_score_from_match() {
+  printf '%s' "$1" | sed -E 's/.*[:：][[:space:]]*([0-9]+(\.[0-9]+)?).*/\1/'
+}
+
+# transcript 不在 / null / 不存在 → tool_response fallback
+if [ -z "$transcript" ] || [ "$transcript" = "null" ] || [ ! -f "$transcript" ]; then
+  fallback_text=$(extract_tool_response_text "$input")
+  if [ -n "$fallback_text" ]; then
+    fb_match=$(extract_confidence "$fallback_text")
+    if [ -n "$fb_match" ]; then
+      score=$(extract_score_from_match "$fb_match")
+      compare_and_emit "$score" "below_threshold_via_tool_response"
+    fi
+  fi
+  if [ -z "$transcript" ] || [ "$transcript" = "null" ]; then
+    log_failure "no_transcript" "transcript_path missing or null"
+  else
+    log_failure "file_not_found" "path=${transcript}"
+  fi
+  echo '{}'; exit 0
+fi
+
+final_text=$(extract_final_assistant_text "$transcript")
+is_sidechain=$(refine_sidechain_from_records "$is_sidechain" "$transcript")
+
+if [ -z "$final_text" ]; then
+  log_failure "extract_failed" "transcript=${transcript} sidechain=${is_sidechain}"
+  echo '{}'; exit 0
+fi
+
+match=$(extract_confidence "$final_text")
+if [ -z "$match" ]; then
+  fallback_text=$(extract_tool_response_text "$input")
+  if [ -n "$fallback_text" ]; then
+    match=$(extract_confidence "$fallback_text")
+  fi
+fi
+
+if [ -z "$match" ]; then
+  # major subagent でなければ fail-open
+  if [ "$is_major" = "false" ] && [ "${HC_CONFIDENCE_MAJOR_AGENT_ONLY:-true}" != "false" ]; then
+    log_failure "skipped_minor_sidechain" "agent_type=${agent_type} sidechain=${is_sidechain} transcript_chars=${#final_text}"
+    echo '{}'; exit 0
+  fi
+  log_failure "regex_no_match" "transcript_chars=${#final_text} sidechain=${is_sidechain}"
+  emit_block "$(build_no_match_reason "$threshold")"
+  exit 0
+fi
+
+# 数値抽出 + 閾値比較
+score=$(extract_score_from_match "$match")
+compare_and_emit "$score" "below_threshold"

package/.claude/hooks/context-budget.sh

@@ -0,0 +1,233 @@
+#!/usr/bin/env bash
+# context-budget.sh — UserPromptSubmit hook
+#
+# 役割:
+#   Loop モード稼働中、context 使用率が閾値 (default 60%) を超えた時点で
+#   <system-reminder> を注入してメインに `/save-state` 実行 + セッション再開
+#   提案を強制する。Normal モードでは no-op。
+#
+# Wave 1.4 (2026-05-23): 60% 未満では完全 silent kill switch を確実化。
+#   既存 logic も silent だったが、early-exit comment と env override
+#   `HC_CONTEXT_BUDGET_SILENT_BELOW_THRESHOLD` (default true) で明示化。
+#   起源: docs/draft/system-reminder-attention-fix.md W1.4
+#
+# 仕組み:
+#   1. mode-loader.sh で現モード解決。loop でなければ exit 0。
+#   2. stdin JSON から transcript_path / session_id を取得。
+#   3. transcript JSONL を末尾から逆走し、最後の assistant メッセージの
+#      `message.usage` を抽出。
+#   4. context_used = input_tokens + cache_creation_input_tokens
+#                   + cache_read_input_tokens + output_tokens
+#   5. ratio = context_used / context_limit (HC_CONTEXT_BUDGET_LIMIT, default 1M)
+#   6. ratio >= threshold かつ未警告セッションなら system-reminder を注入。
+#   7. state file (.claude/.context-budget-state/<session>.warned) に
+#      警告済み tier (60/80/95) を記録し、tier ごとに 1 度だけ警告。
+#
+# 失敗時の挙動:
+#   - exit 0 のみ。失敗してもユーザターンをブロックしない。
+#   - jq 不在 / transcript 不在 / parse 失敗 → silent skip。
+#
+# 環境変数 (env override):
+#   HC_CONTEXT_BUDGET_ENABLED=false  ... 無効化 (Normal モードと等価)
+#   HC_CONTEXT_BUDGET_LIMIT=200000   ... context window サイズ (tokens)
+#   HC_CONTEXT_BUDGET_THRESHOLD=0.60 ... 警告開始 ratio (0.0〜1.0)
+#   HC_CONTEXT_BUDGET_STATE_DIR=...  ... 警告済み marker 保管先
+#   HC_CONTEXT_BUDGET_SILENT_BELOW_THRESHOLD=false ... 閾値未満でも debug 出力 (default true で完全 silent)
+
+set -u
+
+# stdin を必ず消費して保持
+input=$(cat 2>/dev/null || true)
+
+# --- モード解決 ---
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=lib/mode-loader.sh
+if [ -f "$SCRIPT_DIR/lib/mode-loader.sh" ]; then
+  # shellcheck disable=SC1091
+  source "$SCRIPT_DIR/lib/mode-loader.sh"
+  MODE=$(load_mode)
+else
+  MODE="normal"
+fi
+
+# Loop モード以外は no-op (Normal では context 警告しない)
+if [ "$MODE" != "loop" ]; then
+  exit 0
+fi
+
+# --- config 読み込み ---
+# shellcheck source=lib/config-loader.sh
+if [ -f "$SCRIPT_DIR/lib/config-loader.sh" ]; then
+  # shellcheck disable=SC1091
+  source "$SCRIPT_DIR/lib/config-loader.sh"
+fi
+
+# Feature toggle 参照 (task-45 Phase 2)
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled context_budget; then
+  exit 0   # feature OFF で no-op
+fi
+
+# --- 早期 bypass ---
+if [ "${HC_CONTEXT_BUDGET_ENABLED:-true}" = "false" ]; then
+  exit 0
+fi
+
+# --- 依存チェック ---
+if ! command -v jq >/dev/null 2>&1; then
+  exit 0
+fi
+
+# --- 設定値解決 (defaults) ---
+context_limit="${HC_CONTEXT_BUDGET_LIMIT:-1000000}"
+threshold="${HC_CONTEXT_BUDGET_THRESHOLD:-0.60}"
+state_dir="${HC_CONTEXT_BUDGET_STATE_DIR:-.claude/.context-budget-state}"
+silent_below="${HC_CONTEXT_BUDGET_SILENT_BELOW_THRESHOLD:-true}"
+
+# --- stdin parse ---
+transcript_path=$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)
+session_id=$(printf '%s' "$input" | jq -r '.session_id // "default"' 2>/dev/null)
+
+if [ -z "$transcript_path" ] || [ ! -f "$transcript_path" ]; then
+  exit 0
+fi
+
+# session_id sanitize (alnum + dash)
+session_safe=$(printf '%s' "$session_id" | tr -c '[:alnum:]-' '_' | head -c 64)
+
+# --- transcript から最新 assistant usage を取得 ---
+# JSONL を逆順に読み、最初に見つかった message.usage を採用。
+# 形式変動に備え、複数 path を試す。
+# tac 不在環境 (macOS) のための fallback: awk で逆順化
+if command -v tac >/dev/null 2>&1; then
+  reverse_cmd="tac"
+else
+  reverse_cmd="awk '{a[NR]=\$0} END {for(i=NR;i>0;i--) print a[i]}'"
+fi
+
+last_usage=$(eval "$reverse_cmd" < "$transcript_path" 2>/dev/null \
+  | jq -c 'select((.message.usage // .usage // null) != null) | (.message.usage // .usage)' 2>/dev/null \
+  | head -1)
+
+if [ -z "$last_usage" ]; then
+  exit 0
+fi
+
+# context_used = input + cache_creation + cache_read + output
+context_used=$(printf '%s' "$last_usage" | jq -r '
+  ((.input_tokens // 0)
+   + (.cache_creation_input_tokens // 0)
+   + (.cache_read_input_tokens // 0)
+   + (.output_tokens // 0)) | floor
+' 2>/dev/null)
+
+if [ -z "$context_used" ] || [ "$context_used" = "null" ] || [ "$context_used" = "0" ]; then
+  exit 0
+fi
+
+# --- ratio 計算 (awk で float 演算) ---
+ratio=$(awk -v u="$context_used" -v l="$context_limit" 'BEGIN { if (l > 0) printf "%.4f", u / l; else print "0" }')
+ratio_pct=$(awk -v r="$ratio" 'BEGIN { printf "%.1f", r * 100 }')
+
+# === Wave 1.4 kill switch: 閾値未満は完全 silent ===
+# 60% 未満では <system-reminder> 注入を一切しない (attention dilution 削減)。
+# 起源: docs/draft/system-reminder-attention-fix.md W1.4
+# 既存 logic も silent だが、ここで明示的に early-exit して可読性を上げる。
+# env で revert 可: HC_CONTEXT_BUDGET_SILENT_BELOW_THRESHOLD=false
+crossed=$(awk -v r="$ratio" -v t="$threshold" 'BEGIN { print (r >= t) ? 1 : 0 }')
+if [ "$crossed" != "1" ]; then
+  # 閾値未満: completely silent (default true)
+  # debug 用に stderr へ ratio を出したい場合は SILENT_BELOW_THRESHOLD=false にする
+  if [ "$silent_below" = "false" ]; then
+    printf '[context-budget] ratio=%s%% below threshold (silent)\n' "$ratio_pct" >&2
+  fi
+  exit 0
+fi
+
+# --- tier 判定 (60/80/95) ---
+tier="60"
+if awk -v r="$ratio" 'BEGIN { exit !(r >= 0.95) }'; then
+  tier="95"
+elif awk -v r="$ratio" 'BEGIN { exit !(r >= 0.80) }'; then
+  tier="80"
+fi
+
+# --- state ファイルで重複抑制 ---
+mkdir -p "$state_dir" 2>/dev/null
+state_file="$state_dir/${session_safe}.warned"
+already_warned=""
+if [ -f "$state_file" ]; then
+  already_warned=$(cat "$state_file" 2>/dev/null)
+fi
+
+# 同 tier を既に警告済みなら skip
+case "$already_warned" in
+  *"|${tier}|"*) exit 0 ;;
+esac
+
+# 上位 tier の警告が既に出ているなら、下位 tier の再警告は不要
+if [ "$tier" = "60" ]; then
+  case "$already_warned" in
+    *"|80|"*|*"|95|"*) exit 0 ;;
+  esac
+elif [ "$tier" = "80" ]; then
+  case "$already_warned" in
+    *"|95|"*) exit 0 ;;
+  esac
+fi
+
+# tier を marker に書き出し
+# `already_warned` 末尾の `|` を保ち、`<existing>|<tier>|` 形式で **上書き** する。
+# `>>` (append) ではなく `>` (write) を使うのは、`already_warned` を再度
+# 書き出すので append すると `|60||60||80|` のように重複するため。
+printf '%s|%s|' "$already_warned" "$tier" > "$state_file" 2>/dev/null
+
+# --- 警告メッセージ生成 ---
+limit_k=$(awk -v l="$context_limit" 'BEGIN { printf "%.0f", l / 1000 }')
+used_k=$(awk -v u="$context_used" 'BEGIN { printf "%.0f", u / 1000 }')
+
+case "$tier" in
+  "95")
+    urgency="CRITICAL"
+    action_verb="**即座に** \`/save-state\` を実行"
+    ;;
+  "80")
+    urgency="URGENT"
+    action_verb="**この応答内で** \`/save-state\` を実行"
+    ;;
+  *)
+    urgency="NOTICE"
+    action_verb="\`/save-state\` を実行"
+    ;;
+esac
+
+cat <<EOF
+<system-reminder>
+**[${urgency}] Loop モード Context 使用率 ${ratio_pct}% (${used_k}K / ${limit_k}K tokens, tier=${tier}%)**
+
+Loop モード稼働中に context limit の ${tier}% を超過しました。残り context が枯渇する前に
+セッション状態を保存し、ユーザに再開を提案してください。
+
+**メインエージェントへの指示** (このターン内で必ず実行):
+
+1. ${action_verb} してセッション状態を永続化する
+2. 完了後、以下のフォーマットでユーザに **明示的に** 再開を提案する:
+
+   > Context 使用率が ${ratio_pct}% に到達しました。Loop モード継続のため
+   > \`/save-state\` でセッション状態を保存しました。
+   >
+   > **推奨**: 新しいセッションを開始して \`/resume-state\` で復元するか、
+   > このまま継続する場合は context limit 到達まで残りわずかな点に留意してください。
+   >
+   > 続行 / 新セッション開始 のいずれを希望しますか?
+
+3. ユーザの応答を待つ間も Why × 5 出力ルールは継続
+
+**重要**:
+- この警告は同一 tier では 1 セッションあたり 1 度のみ発火
+- 60% → 80% → 95% の 3 段階で段階的にエスカレート
+- 一時的に無効化したい場合: \`HC_CONTEXT_BUDGET_ENABLED=false\`
+- 閾値変更: \`.claude/harness-config.yml\` の \`context_budget_threshold\`
+</system-reminder>
+EOF
+
+exit 0

package/.claude/hooks/delegation-guard.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+# サブエージェント委譲ルール: メインエージェントは保護パス (既定 src/ tests/ scripts/) を直接操作できない。
+# 保護パスのリスト・whitelist 位置・タスク管理 path 等は `.claude/harness-config.yml` で集中管理。
+# Bash は原則禁止。`.claude/bash-whitelist.txt` に登録された prefix のみ実行可能。
+# 申請フローは `.claude/bash-whitelist-requests/REQUEST_TEMPLATE.md` 参照。
+#
+# Orchestrator: env load + subagent detect + tool dispatch to lib/*。
+# 個別ルール logic は lib/delegation-guard/ に分割:
+#   - subagent-detect.sh   — subagent 検出 (多段フォールバック)
+#   - protected-paths.sh   — Edit/Write/Read/Grep/Glob 保護パス + code 保護 + task glob
+#   - git-deny.sh          — git destructive 10 patterns + protected branch push
+#   - bash-whitelist.sh    — whitelist 照合 + segment splitter + path leak guard
+#
+# stdin から PreToolUse JSON を受け取り、stdout に hook 応答を返す。
+# 引数: $1 = tool name (Edit|Write|Read|Grep|Glob|Bash)
+
+set -u
+
+# config 読み込み (HC_* 変数 export)
+SCRIPT_DIR="$(dirname "$0")"
+# shellcheck source=lib/config-loader.sh
+source "$SCRIPT_DIR/lib/config-loader.sh"
+
+# Feature toggle 参照 (task-45 Phase 2)
+if command -v is_feature_enabled >/dev/null 2>&1 && ! is_feature_enabled delegation_guard; then
+  exit 0   # feature OFF で no-op
+fi
+
+# bypass logger (log_bypass 関数を提供)
+# shellcheck source=lib/bypass-logger.sh
+source "$SCRIPT_DIR/lib/bypass-logger.sh"
+# shellcheck source=lib/delegation-guard/subagent-detect.sh
+source "$SCRIPT_DIR/lib/delegation-guard/subagent-detect.sh"
+# shellcheck source=lib/delegation-guard/protected-paths.sh
+source "$SCRIPT_DIR/lib/delegation-guard/protected-paths.sh"
+# shellcheck source=lib/delegation-guard/git-deny.sh
+source "$SCRIPT_DIR/lib/delegation-guard/git-deny.sh"
+# shellcheck source=lib/delegation-guard/bash-whitelist.sh
+source "$SCRIPT_DIR/lib/delegation-guard/bash-whitelist.sh"
+
+input=$(cat)
+tool="${1:-}"
+
+# task-22 W2: jq 不在環境では fail-open (hook 機能停止して継続)
+# delegation-guard.sh は jq に重度依存 (16 箇所) のため、不在で crash する前に exit 0
+if ! command -v jq >/dev/null 2>&1; then
+  exit 0
+fi
+
+# --- debug ---
+if [ "${CLAUDE_HOOK_DEBUG:-}" = "1" ]; then
+  printf '[%s] tool=%s\n%s\n---\n' "$(date +%FT%T)" "$tool" "$input" \
+    >> /tmp/claude-hook-debug.log
+fi
+
+# --- subagent detection ---
+is_subagent=$(detect_subagent "$input")
+
+if [ "$is_subagent" = "true" ]; then
+  echo '{}'
+  exit 0
+fi
+
+# --- main agent path enforcement ---
+# Bash deny / 委譲ガード block を受けた際の必須アクション (development-process.md §5)。
+# 全 block message に共通フッタとして付与する。
+reflex_footer=$'\n\n【次のアクション】\n1. Agent tool で subagent を起動 (run_in_background: true 必須)\n2. その subagent に本作業を委譲\n3. TaskCreate でタスク登録\n\nBash deny / whitelist 不在 / 委譲ガード block は loop 停止理由にしないこと (development-process.md §5)。'
+
+# メッセージは harness-config.yml の protected_paths を反映 (例: "src/ tests/ scripts/")
+block_path_msg=$(jq -nc --arg d "$HC_PROTECTED_DISPLAY" --arg f "$reflex_footer" \
+  '{decision:"block", reason:("[サブエージェント委譲ルール] メインエージェントは " + $d + " を直接操作できません。Agent tool でサブエージェントに委譲してください。" + $f)}')
+block_read_msg=$(jq -nc --arg d "$HC_PROTECTED_DISPLAY" --arg f "$reflex_footer" \
+  '{decision:"block", reason:("[サブエージェント委譲ルール] メインエージェントは " + $d + " のファイルを直接読み取れません。Agent tool(Explore等)でサブエージェントに調査を委譲してください。" + $f)}')
+block_search_msg=$(jq -nc --arg d "$HC_PROTECTED_DISPLAY" --arg f "$reflex_footer" \
+  '{decision:"block", reason:("[サブエージェント委譲ルール] メインエージェントは " + $d + " を直接検索できません。Agent tool(Explore等)でサブエージェントに調査を委譲してください。" + $f)}')
+
+# task 配下の絶対 path 部分一致パターン (protected-paths.sh が参照)
+task_glob="*/${HC_TASK_DIR}/*"
+
+case "$tool" in
+  Edit|Write)
+    handle_edit_write "$input" "$tool"
+    ;;
+  Read)
+    handle_read "$input"
+    ;;
+  Grep|Glob)
+    handle_search "$input"
+    ;;
+  Bash)
+    cmd=$(printf '%s' "$input" | jq -r '.tool_input.command // empty')
+    check_bash_inline_override "$cmd"
+    check_git_destructive "$cmd"
+    check_protected_branch_push "$cmd"
+    check_bash_whitelist "$cmd"
+    ;;
+esac
+
+echo '{}'