@takuma-hirai/hirai-method 0.1.0

package/.claude/rules-details/development-process/research-reuse.md

@@ -0,0 +1,22 @@
+> Layer A: [`development-process.md`](../../rules/development-process.md) §コーディング指針 / 出力 / 研究 (必読) | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# 研究と再利用 詳細 (Layer B)
+
+## 適用対象 task (完全 list)
+
+- 新 library / package 採用前 (npm install / pnpm add / pip install 等の **直前**)
+- 既存 library の major version migration (例: React 18 → 19、Next.js 14 → 16)
+- API syntax / config / option の確認 (新 hook / 新 API 利用時)
+- error message debug (library 由来 error の stack trace を context7 / 公式 docs と照合)
+- 新機能 / lifecycle hook の利用 (例: Next.js Cache Components / use cache directive 等)
+
+## 関連設定
+
+- `.mcp.json` の context7 entry (`npx -y @upstash/context7-mcp@latest`、stdio transport)
+- 採用 4 リポへ portable 同期済 (本 repo `.mcp.json` SSoT + `install.sh --update` で同期)
+- subagent 委譲時も同 chain 適用 (Agent prompt に「library 仕様確認は context7 を最初に」と明示)
+
+## bypass の補足
+
+- MCP server fail (context7 unreachable / npx fail) で loop 停止しない構造は §「Bash deny / whitelist 不在時の subagent 委譲反射」と類似 (fail → fallback chain に自動 retry、停止理由にしない)
+- 起源 memory: `feedback_verify_path_before_implementation.md` (verify before recommending 原則)

package/.claude/rules-details/development-process/staging-strategy.md

@@ -0,0 +1,47 @@
+> Layer A: [`development-process.md`](../../rules/development-process.md) §サブエージェント `.claude/` 編集の staging 戦略 (必須) | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# staging 戦略 詳細 (Layer B)
+
+## 強制プロンプト雛型 (Agent tool prompt に必ず明示)
+
+> 本 task は `.claude/<sub>/foo.sh` 等への新規作成 / 編集を含む。Claude Code permission system が subagent context での `.claude/` 直接 Write を deny するため、以下の staging 戦略を使え:
+>
+> 1. `/tmp/foo.sh` に `Write` で内容を書く
+> 2. `mv /tmp/foo.sh .claude/<sub>/foo.sh` で install
+> 3. 実行 file の場合 `chmod +x .claude/<sub>/foo.sh`
+>
+> Edit の場合: 既存 file を Read → 編集して `/tmp/foo.sh` に `Write` → `mv` で上書き install
+
+## 検出パターン (subagent 失敗時の即時切替)
+
+- `Write` tool で `file_path` が `.claude/` 配下 → permission denied
+- `Edit` tool で `file_path` が `.claude/` 配下 → permission denied
+- `Bash` で `cat > .claude/...` / `tee .claude/...` heredoc redirect → block
+
+## 例外
+
+- **メインからの `.claude/` Write/Edit は通過** (`delegation-guard.sh` がメイン許可)
+- **`worktree` isolation でも同 policy** (foreground / background / worktree いずれも denied、隔離方式に依らず subagent context の `.claude/` 直接 write は deny)
+- **単一 repo 内 (hirai-method 内 `.claude/hooks/` 等の編集) は staging 戦略で subagent から可能** — cross-repo Write のみが完全 deny ([cross-repo-write.md](./cross-repo-write.md) §例外 参照)
+
+## task #12 dual-mode-portability 由来 (起源)
+
+本規範は task #12 dual-mode-portability 実装中の発見 (2026-05-13) から起こされた。subagent ad80e8f5b63437f01 で以下 3 パターンの permission denied を全件確認:
+
+1. `Write` tool で `file_path` が `.claude/` 配下
+2. `Edit` tool で `file_path` が `.claude/` 配下
+3. `Bash` で `cat > .claude/...` / `tee .claude/...` heredoc redirect
+
+## 関連 artifact
+
+- task #12: `feat/loop-mode` ブランチ、commit `4ddf115`〜`93100a8` (2026-05-13)
+- Serena memory: `learning/solutions/subagent-claude-permission-staging` (subagent context での `.claude/` write 制約と staging 回避策)
+- 副産物 entry: `docs/tasks/next-actions.md` entry #12 (2026-05-13、🟡)
+- 規範化 task: #13 (本セクション追加)
+
+## 再発検出時の昇格判定
+
+honor system のため、subagent dispatch prompt への staging 明示忘れリスクは残存する。再発が **N=2 以上** 観測されたら、副産物 entry を起こし以下を検討:
+
+- **案 B**: `.claude/templates/` に staging 強制プロンプト template 新設 + `/new-task` 系 command が自動参照
+- **案 C**: 専用 hook `subagent-staging-reminder.sh` で PreToolUse(Agent) に staging 強制注入

package/.claude/rules-details/modes/artifacts.md

@@ -0,0 +1,34 @@
+> Layer A: [`modes.md`](../../rules/modes.md) §関連 artifact (代表) | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# 関連 artifact 完全 list (Layer B)
+
+本 file は Layer A に掲載する代表 4 件を補完する完全 artifact list。mode 系 hook / 5 層強制機構 / 設定 state / 設計起源 draft path を含む。
+
+## mode 系 hook
+
+- `.claude/hooks/mode-session-start.sh` (SessionStart、モード表示 / 切替提案)
+- `.claude/hooks/mode-enforce.sh` (UserPromptSubmit、遵守事項再注入)
+- `.claude/hooks/context-budget.sh` (UserPromptSubmit、context tier 監視)
+- `.claude/hooks/lib/mode-loader.sh` (共通 lib、mode 解決)
+
+## 5 層強制機構
+
+- `.claude/rules/modes.md` (層 1、規範本体 = Layer A)
+- `.claude/hooks/loop-auto-progress-reminder.sh` (層 2、UserPromptSubmit)
+- `.claude/hooks/autonomous-action-guard.sh` (層 3、PreToolUse Bash)
+- `.claude/settings.json` (層 4、hook 配線)
+- `.claude/tests/loop-auto-progress-smoke.sh` (層 5、9 ケース smoke)
+- `.claude/hooks/loop-confirmation-detector.sh` (層 6、Stop hook)
+
+## 設定 / state
+
+- `.claude/mode.yml` (mode 永続化、`mode: normal|loop`)
+- `.claude/harness-config.yml` (`context_budget_threshold` / `HC_*` env 集中管理)
+- `.claude/.workflow-state/bypass.log` (bypass 追跡 audit log)
+- `.claude/.workflow-state/context-budget-tiers.json` (tier 発火状態)
+
+## 設計起源 draft (採用プロジェクト側、本 harness は portable 設計のため path のみ参照)
+
+- `docs/draft/loop-auto-progress-enforcement.md` (遵守事項 7+8 起源)
+- `docs/draft/loop-mode-list-md-auto-enque.md` (遵守事項 9 起源、task #47)
+- `docs/draft/task-equals-phase-step-status-list-normative.md` (task-management.md 採用 6 条と連動)

package/.claude/rules-details/modes/compliance-items.md

@@ -0,0 +1,120 @@
+> Layer A: [`modes.md`](../../rules/modes.md) §Loop モード遵守事項 (9 件) | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# 遵守事項 詳細 (Layer B)
+
+本 file は Layer A の SSoT を補完する詳細解説。Loop モード遵守事項 9 件の例外条項詳細 / 違反例 / 緩和経緯 / 起源を含む。
+
+## 遵守事項 2 例外条項の起源と詳細
+
+**起源 (recall_poc/docs/01-03 事案、task-21 W2.1、2026-05-23)**:
+- 2026-05-23 user 観察「recall_poc/docs/01-03 が draft 経由なしで docs/ 直下に直接 Write された事案」
+- `task-management.md` の「設計→承認→タスク追加フロー」と相反していた構造問題を例外条項で解消
+- Loop モードの中間確認禁止が「設計文書の新規追加」まで暴走することを防止
+
+**起源 (規範変更、task-40 + 2026-05-28 緩和)**:
+- 2026-05-26 task-40 Step 5: 本 session 規範違反 (規範変更時 draft skip) の再発防止として `.claude/rules/*.md` / `.claude/commands/*.md` / `.claude/templates/docs/**/*.md` への新規 Write に対して `draft-flow-guard.sh` で機械強制 BLOCK を実装
+- 2026-05-28 user 直接指示「既存 rules file の Edit は PASS (新規 Write のみ BLOCK) → 書き込みも許容してください」で **task-40 拡張部分を撤廃**
+- 規範文書 path は新規 Write / 既存 Edit とも hook で PASS、本 hook は一切監視しない
+- 機械強制ではなく **規律として残す方針** (honor system)
+- bypass env `ECC_RULE_CHANGE_GUARD_OFF` / `HC_RULE_CHANGE_GUARD_ENABLED` は dead path (後方互換で残置、hook は参照しない)
+
+**禁止対象の境界 (戦術判断 vs 戦略判断)**:
+
+| カテゴリ | 例 | 確認要否 |
+|---|---|---|
+| **戦術判断** (禁止対象) | 実装中の方式選択 / branch 命名 / commit メッセージ / 一時的なエラー対処 / build green までの試行錯誤 | 確認不要 (即採用) |
+| **戦略判断** (例外、確認必須) | 設計文書新規追加 / 仕様変更 / scope 拡張 / architecture 選択 / 採用技術スタック変更 / 既存 task 優先順入替 | 確認必須 |
+| **規範変更** (例外、honor system) | `.claude/rules/*.md` / `.claude/commands/*.md` / `.claude/templates/docs/**/*.md` 編集 | user 確認推奨 / 設計→承認フロー推奨 (機械強制 BLOCK は 2026-05-28 撤廃) |
+
+## 遵守事項 7 (subagent 並走中の独立作業義務) 詳細と違反例
+
+**設計起源**: `docs/draft/loop-auto-progress-enforcement.md` (採用プロジェクト側、本 harness は portable 設計のため起源 draft path のみ参照)。
+
+**違反例 (2026-05-12、subagent #13-#15 起動後の停止事案)**:
+- subagent #13-#15 を `run_in_background: true` で起動後、メインが「completion 通知の受動待ち」でターン区切り報告で停止
+- user 「Loop モード継続中。なぜ自動で実行を続けないのか?」を **複数回**指摘
+- 結果: `.claude/hooks/loop-auto-progress-reminder.sh` (UserPromptSubmit) を導入し、「待ち中報告」キーワード検出で `<system-reminder>` 強制注入
+- 機械防止化により「subagent 完了通知後のメイン報告 → 即次タスク自動起動」を default 動作として強制
+
+**並行作業の優先順位**:
+
+| 順位 | 並行作業内容 | 理由 |
+|---|---|---|
+| 1 | 別の独立 task 着手 (`docs/tasks/list.md` 🔲 行) | 全体進捗を最大化 |
+| 2 | メイン専任作業 (タスク管理 / list.md sync / task ファイル生成 / draft 起こし) | サブエージェント完了待ち中の生産的活動 |
+| 3 | 規範文書化 (`.claude/rules/` 編集 / `CLAUDE.md` 更新) | 学習機会の活用 |
+| 4 | memory / `next-actions.md` 整理 | 軽量タスクで context を温存 |
+
+**「並行作業できない」と判定可能なケース** (停止 OK):
+- 依存関係: 全独立 task が背景 subagent に着手済で残 task が依存待ち
+- 全 task 着手済: list.md 🔲 行が 0 件
+- 上記以外で停止すれば違反、即 hook 強制が発火
+
+## 遵守事項 8 (自律実行禁止リスト) 11 カテゴリ 例外詳細
+
+各カテゴリの「準備として OK」例外を明示。Layer A は条文のみ、本表で実運用 boundary を確認:
+
+| カテゴリ | 対象コマンド / 操作 | 例外 (準備として OK) |
+|---|---|---|
+| remote 反映 | `git push origin main\|stg*` のみ (protected-branch-push-deny で別 layer block) | feature branch push は自律可 (task #39 緩和) / ローカル `git commit` |
+| PR / リリース | `gh pr merge` / `gh release create` / `git tag <name> origin` (tag push) | `gh pr create` は自律可 (task #39 緩和) / task ファイル / draft 起こし |
+| main 操作 | main への merge / main checkout 後の編集 | feature branch 編集 |
+| DB 作業 | migration 実行 / `INSERT/UPDATE/DELETE` 直接実行 / dump / restore | migration script 作成 (実行しない) |
+| 本番 deploy | `vercel --prod` / `supabase deploy` / production environment 触る操作 | preview / staging deploy |
+| secrets | `.env*` 編集 / API key 生成・ローテーション / OAuth token 操作 | `.env.example` 更新 |
+| 外部通知 | Slack post / メール送信 / Asana タスク作成・更新 | 通知文 draft |
+| CI/CD | `.github/workflows/` 編集 + push | local workflow 編集 (push しない) |
+| license / public | LICENSE 変更 / README 公開アピール変更 / `package.json` major bump | minor / patch bump 検討 |
+| subagent への委譲拡張 | 上記操作を subagent prompt で許可すること | 上記禁止項目を除外した prompt |
+| 第三者リポ | submodule update / fork 外への push / `gh repo` 操作 | submodule branch 確認 |
+
+## 遵守事項 8 (自律実行禁止リスト) 緩和経緯詳細
+
+**緩和 1: task #39 (2026-05-25) — feature branch push + gh pr create 自律実行可**
+
+| 項目 | 緩和前 | 緩和後 |
+|---|---|---|
+| feature branch への `git push` | user 明示承認必須 | **自律実行可** |
+| `gh pr create` (feature branch から PR 作成) | user 明示承認必須 | **自律実行可** |
+| main / stg* への `git push` | user 明示承認必須 | **継続 user 承認必須** (別 layer `protected-branch-push-deny` に委譲) |
+| `gh pr merge` | user 明示承認必須 | **継続 user 承認必須** |
+
+**起源**: 2026-05-25 task #39 + 2026-05-27 task-48 PR #22 で再実証 (feedback memory `claude_permission_git_push_deny.md` 参照)。
+
+**緩和 2: mode-switch bypass log (2026-05-13、task #9)**
+
+Normal モードで禁止パターン match した cmd 実行は `.claude/.workflow-state/bypass.log` に `mode-normal-restricted-cmd` として記録される:
+
+| 項目 | 仕様 |
+|---|---|
+| OFF env | `HC_AUTONOMOUS_LOG_NORMAL_RESTRICTED=false` |
+| 記録内容 | timestamp / cmd 抜粋 / カテゴリ / mode-normal-restricted-cmd マーカー |
+| audit 用途 | 「Loop モード規律を一時的に外して破壊的操作を実行した」事実が audit log に残るため `/harness-audit` でトレース可能 |
+
+**bypass log の用途分離**:
+
+| カテゴリ | 記録対象 | 用途 |
+|---|---|---|
+| `mode-normal-restricted-cmd` | Normal モードで禁止パターン実行 | audit trail (規律外し痕跡) |
+| `autonomous-action-guard` | Loop モードで `ECC_AUTONOMOUS_ACTION_OVERRIDE=1` bypass | bypass 理由追跡 |
+| `HC_AUTONOMOUS_ACTION_ENABLED=false` | config レベル OFF | config 状態追跡 |
+
+## 遵守事項 9 (Loop モード = list.md 全 task 連続自律実行) 起源 task-47 詳細
+
+**起源**: 2026-05-27 user 直接指示「ループモードはタスクリストから可能な限り進めて欲しい + 閾値到達か続行不可で自動 save-state」、設計 draft `docs/draft/loop-mode-list-md-auto-enque.md`、規範化 task `#47`。
+
+**実装仕様 (Phase 6 詳細)**:
+
+| step | 動作 |
+|---|---|
+| 3a | list.md から **🔄 進行中** task を抽出 |
+| 3b | 続けて **🔲 未着手** task を依存解決順 (DAG 解析) で抽出 |
+| 3c | 各 task の draft frontmatter `approved_at:` を確認、非空のみ自律着手可とフラグ |
+| 3d | draft 不在 / 未承認 task は user 確認必須項目として stop pool に分類 |
+| 3e | 自律着手可 task を順に enque、subagent 並列起動 (run_in_background: true) |
+| 4 | 各 task 完了で `/finish-task <id>` 実行 + 次 task 自動起動 |
+| 5 | 停止条件 3 つ (context 閾値 / 続行不可 / user 明示停止) 監視 |
+| 6 | 停止時に自動 `/save-state` + 残 task 列挙案内 |
+| 7 | 新 session で `/resume-state loop` で継続 (state file から復元) |
+
+詳細は `.claude/commands/resume-state.md` Phase 6 step 3a-3e + step 4-7 を参照。

package/.claude/rules-details/modes/five-layer-enforcement.md

@@ -0,0 +1,46 @@
+> Layer A: [`modes.md`](../../rules/modes.md) §Loop モード自律規律の 5 層強制機構 | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# 5 層強制機構 詳細 (Layer B)
+
+本 file は Layer A の SSoT を補完する詳細解説。5 層強制機構の各層動作 source / smoke list 完全版 / 層 6 起源を含む。
+
+## 各層の動作 source code 参照
+
+| 層 | source path | 主要 logic |
+|---|---|---|
+| 1 | `.claude/rules/modes.md` (本 file 規範) | 遵守事項 7 (subagent 待ち独立作業) + 8 (自律禁止 11 カテゴリ) |
+| 2 | `.claude/hooks/loop-auto-progress-reminder.sh` | UserPromptSubmit hook、毎ターン「待ち中報告」regex 検出 + pending Agent tool_use 数集計 → `<system-reminder>` 注入 |
+| 3 | `.claude/hooks/autonomous-action-guard.sh` | PreToolUse(Bash) hook、11 カテゴリ regex 照合 → Loop なら `{"decision":"block"}` exit 2 / Normal なら context 注入 + bypass.log 記録 |
+| 4 | `.claude/settings.json` (hooks セクション) | UserPromptSubmit 末尾 + PreToolUse Bash 先頭に 5 層 hook を配置 |
+| 5 | `.claude/tests/loop-auto-progress-smoke.sh` | 9 ケース smoke (Loop モード ON/OFF × 待ち中報告検出 / 11 カテゴリ block / bypass 動作) |
+| 6 | `.claude/hooks/loop-confirmation-detector.sh` | Stop hook、AI 最終 message 出力後に確認質問 regex 検出 → `<system-reminder>` 強制注入で次 turn 自律是正 |
+
+## smoke list 完全版 (9 ケース、`loop-auto-progress-smoke.sh`)
+
+| ケース | 入力 | 期待 |
+|---|---|---|
+| 1 | Loop モード + 「subagent 完了待ち」発話 | `<system-reminder>` 注入 |
+| 2 | Loop モード + pending Agent tool_use 数 ≥ 1 | reminder 注入 |
+| 3 | Loop モード + 通常発話 | no-op |
+| 4 | Normal モード + 「待ち中」発話 | no-op (Normal は監視外) |
+| 5 | Loop モード + `git push origin main` | `{"decision":"block"}` (層 3) |
+| 6 | Loop モード + `git push origin feat/xxx` | PASS (task #39 緩和) |
+| 7 | Loop モード + `gh pr create` | PASS (task #39 緩和) |
+| 8 | Loop モード + `ECC_AUTONOMOUS_ACTION_OVERRIDE=1` + `git push origin main` | PASS + bypass.log 記録 |
+| 9 | Loop モード + `HC_AUTONOMOUS_ACTION_ENABLED=false` + `gh pr merge` | PASS + bypass.log 記録 |
+
+## 層 6 (loop-confirmation-detector.sh) task-41 起源
+
+**起源**: 2026-05-26 task-41。
+
+**事案**: 別 session log で「Loop モード自律 patch 着手で OK ですか?」と AI が確認質問を発した事案を user が貼付指摘 (本 session でも user 「Loopモードなのに聞いてきます」指摘あり)。
+
+**設計**:
+- Stop hook (AI 最終 message 出力後) で確認質問 regex 検出: 「進めてよいですか」「OK ですか」「お待ちします」「次の指示お待ち」「どちらにしますか」「どうしますか」等
+- match 時に `<system-reminder>` で次 turn 自律是正を強制 (BLOCK ではなく warn 注入で物理的に止めない、次 turn で AI が自律是正)
+- bypass: `HC_LOOP_CONFIRMATION_DETECTION_ENABLED=false` (config 系統) / `ECC_LOOP_CONFIRMATION_OFF=1` (env 系統)
+
+**他 5 層との差別化**:
+- 層 2 (loop-auto-progress-reminder) = UserPromptSubmit (user 発話を受けた直後の AI 思考前)
+- 層 6 (loop-confirmation-detector) = Stop (AI 最終 message が出力された直後)
+- 両者で「AI の確認質問発話」を時系列の両端から防止

package/.claude/rules-details/modes/mode-hooks.md

@@ -0,0 +1,51 @@
+> Layer A: [`modes.md`](../../rules/modes.md) §強制機構 (mode 系 hook) | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# mode hook 詳細 (Layer B)
+
+本 file は Layer A の SSoT を補完する詳細解説。mode-loader.sh 内部仕様 / mode-session-start.sh / mode-enforce.sh の context 注入詳細 / context-budget.sh tier 算出ロジックを含む。
+
+## mode-loader.sh 内部仕様
+
+`.claude/hooks/lib/mode-loader.sh` は全 mode 系 hook で source される共通 lib。
+
+**API**:
+- `get_mode()` — 現モードを stdout に出力 (`normal` or `loop`)
+- 値解決順: `env(HC_MODE)` > `.claude/mode.yml` の `mode:` キー > `default(normal)`
+- 値検証: 不正値は `normal` にフォールバック + stderr 警告
+
+**fail policy**:
+- `set -uo pipefail` (file-top に書かない、subshell 関数化で局所化、caller の shell flags への leak 防止)
+- yml parse 失敗 → `normal` fallback (fail-open、セッション継続)
+
+## mode-session-start.sh の context 注入
+
+| 状況 | 動作 |
+|---|---|
+| Normal モード | 「現在 Normal モード。Loop モードへの切替は `/mode loop`」を SessionStart で 1 度だけ提案 |
+| Loop モード | 「現在 Loop モード。停止は `/mode normal` or 「ストップ」発話」を表示 |
+| mode.yml 不在 | `normal` 扱いで切替提案 (fail-open) |
+
+## mode-enforce.sh の context 注入
+
+| 状況 | 動作 |
+|---|---|
+| Loop モード | 毎ターン UserPromptSubmit で遵守事項 9 件を `<system-reminder>` で再注入 |
+| Normal モード | no-op |
+| 注入内容 | 遵守事項 9 件の見出しのみ (本文は modes.md 参照と link)、context 節約 |
+
+## context-budget.sh tier 算出ロジック
+
+| tier | ratio 閾値 | 動作 |
+|---|---|---|
+| 60 | `ratio >= 0.60` | `<system-reminder>` で `/save-state` 提案 |
+| 80 | `ratio >= 0.80` | `<system-reminder>` で `/save-state` **強制実行** + 「新 session で `/resume-state` で復元するか継続するか」を user に提示 |
+| 95 | `ratio >= 0.95` | `<system-reminder>` で緊急 `/save-state` + セッション終了案内 |
+
+**spam 防止**:
+- 同一 tier は 1 セッションあたり 1 度のみ発火
+- 状態は `.claude/.workflow-state/context-budget-tiers.json` で永続化
+- bypass: `HC_CONTEXT_BUDGET_ENABLED=false` で hook 全停止
+
+**閾値変更**:
+- `.claude/harness-config.yml` の `context_budget_threshold:` キーで上書き可
+- `hc-config.sh --set context_budget_threshold='[60,80,95]'` で安全に変更可 (atomic backup + type validation)

package/.claude/rules-details/modes/origin.md

@@ -0,0 +1,17 @@
+> Layer A: [`modes.md`](../../rules/modes.md) §関連 artifact (代表) | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# 起源 (history 全体) (Layer B)
+
+本 file は modes.md の歴史全体を記録する。各 task の commit hash / 採用判断は git log + 採用プロジェクト側 `docs/tasks/<task-N>.md` を参照。
+
+## 変更履歴
+
+- **Loop モード規範化**: 2026-05-12 task-21 W0.1 で遵守事項 1-8 を策定 (subagent 並走中の停止事案を機械防止化)
+- **遵守事項 2 例外条項**: 2026-05-23 task-21 W2.1 で「設計→承認→タスク追加フロー」との相反を解消 (recall_poc/docs/01-03 事案起源)
+- **task #9 (2026-05-13)**: mode-switch bypass log 追加、Normal モードで禁止パターン実行を audit trail として記録
+- **task #39 (2026-05-25)**: feature branch push + gh pr create 自律実行可へ緩和、main/stg* は別 layer 委譲
+- **task-40 (2026-05-26)**: 規範変更 (`.claude/rules/*.md` 等) draft skip 事案の再発防止 → 2026-05-28 緩和で機械強制 BLOCK 撤廃、honor system に降格
+- **task-41 (2026-05-26)**: 層 6 (loop-confirmation-detector.sh) 追加、確認質問発話の自律是正
+- **task #47 (2026-05-27)**: 遵守事項 9 (list.md 全 task 連続自律実行) 新設
+- **task-48 (2026-05-27)**: PR #22 で feature branch push + gh pr create の自律実行を再実証 (memory `claude_permission_git_push_deny.md` 更新)
+- **task-51 Step 3 (2026-05-28)**: Layer A/B 2 層分割

package/.claude/rules-details/self-improvement/l4-mechanics.md

@@ -0,0 +1,36 @@
+> Layer A: [`self-improvement.md`](../../rules/self-improvement.md) §メインエージェントへの要請 | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# L4 動作前提 + 信頼度挙動 + 失敗モード対処 詳細 (Layer B)
+
+## L4 動作前提
+
+このハーネスは **すべての tool call を `.claude/skills/continuous-learning-v2/hooks/observe.sh` で観察** する。
+
+- Hook 100% 確実発火
+- 観察先: `~/.claude/homunculus/projects/<hash>/observations.jsonl`
+- 個人データ・コードは送信されない（完全ローカル）
+- `git remote` で project hash 自動検出
+- 検出失敗時は global fallback
+
+## L4 信頼度（confidence）の挙動
+
+| Score | 表示 | 行動 |
+|---|---|---|
+| 0.3 | 提示するが強制せず | suggest |
+| 0.5 | 関連時のみ適用 | apply when relevant |
+| 0.7 | 自動適用承認 | auto-apply |
+| 0.9 | コア行動 | core behavior |
+
+**confidence が上がる**: 同パターン再観察、user 非否定、横断的合意
+**confidence が下がる**: user 修正、長期未観察、矛盾観察
+
+## 失敗モード対処
+
+| 症状 | 層 | 対処 |
+|---|---|---|
+| ループ churn | L2 | scope 縮小、`/harness-audit`、明示 acceptance |
+| Merge stall | L3 | unit 分割、tier 下げ |
+| 信頼度爆発（矛盾 instinct） | L4 | confidence decay、user 確認、`/instinct-status` |
+| プロジェクト混線 | L4 | v2.1 の project-scoped で隔離（既に有効） |
+| Cost drift | L2/L4 | `--max-cost` / Haiku ルーティング |
+| 失敗ループ | L5 | `/agent-introspect`、教訓を L4 へ |

package/.claude/rules-details/self-improvement/origin.md

@@ -0,0 +1,8 @@
+> Layer A: [`self-improvement.md`](../../rules/self-improvement.md) §関連スキル / コマンド (代表) | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# 起源 詳細 (Layer B)
+
+- **L1-L5 + F1/F2 模倣の起源**: ECC (Everything Claude Code) の自己改善アルゴリズム。ECC から `.claude/skills/` 配下の `eval-harness` / `continuous-agent-loop` / `gan-style-harness` / `continuous-learning-v2` / `agent-introspection-debugging` / `gateguard` / `verification-loop` の 7 skill を移植
+- **F1 GateGuard A/B 実測 +2.25 / 10 ポイント**: ECC で計測された ungated 6.75 → gated 9.0 の数値。本ハーネスでも同等効果を期待
+- **L4 を「核心」とする位置付け**: ECC の continuous-learning-v2 が **全 tool call を observation** することで instinct を蓄積 → confidence 0.7 で auto-apply → 0.9 で core behavior 化、というアルゴリズムが自己改善の中核
+- **規範化経緯**: 各層の commit hash / 採用判断は git log + `docs/SELF_IMPROVEMENT.md` を参照

package/.claude/rules-details/self-improvement/related-skills.md

@@ -0,0 +1,35 @@
+> Layer A: [`self-improvement.md`](../../rules/self-improvement.md) §関連スキル / コマンド (代表) | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# 関連スキル / コマンド 完全 (Layer B)
+
+## スキル
+
+- `.claude/skills/eval-harness/SKILL.md` (L1)
+- `.claude/skills/continuous-agent-loop/SKILL.md` (L2)
+- `.claude/skills/gan-style-harness/SKILL.md` (L2+)
+- `.claude/skills/continuous-learning-v2/SKILL.md` (L4 — 核心)
+- `.claude/skills/agent-introspection-debugging/SKILL.md` (L5)
+- `.claude/skills/gateguard/SKILL.md` (F1 — 事前ゲート)
+- `.claude/skills/verification-loop/SKILL.md` (F2 — 事後検証)
+
+## コマンド
+
+```
+/eval {define|check|report} <feature>     # L1
+/gan-design <prompt>                       # L2+ Planner
+/gan-build <spec>                          # L2+ Generator/Evaluator loop
+/instinct-status                           # L4 一覧
+/projects                                  # L4 既知プロジェクト
+/learn                                     # L4 ヒューリスティック抽出
+/evolve                                    # L4 クラスタリング
+/promote [id]                              # L4 project → global
+/instinct-export [opts]                    # L4 export
+/instinct-import <file>                    # L4 import
+/agent-introspect                          # L5 自己診断
+
+/gate-status                               # F1 cleared/pending 状態
+/gate-clear [file|all]                     # F1 state リセット
+/gate-bypass <file>                        # F1 pre-clear
+
+/verify                                    # F2 6 phase 事後検証
+```

package/.claude/rules-details/self-improvement/when-to-use-layers.md

@@ -0,0 +1,39 @@
+> Layer A: [`self-improvement.md`](../../rules/self-improvement.md) §いつどの層を使うか（要約） | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# いつどの層を使うか 詳細 (Layer B)
+
+```
+タスク受領
+  → L1 で合否基準を先に書く（/eval define）
+  → L2 でループ実装（Sequential / Continuous PR / GAN）
+  → L1 で合否確認（/eval check）
+
+ファイルを編集/作成しようとした時
+  → F1 GateGuard が初回 BLOCK（事実調査要求）
+  → 要求された 4 事実を提示
+  → 同ファイルへの retry は通過
+
+破壊的 Bash（rm -rf / git reset --hard 等）
+  → F1 GateGuard が初回 BLOCK
+  → rollback 手順 + 影響範囲 + 逐語引用 を提示
+  → retry で通過
+
+PR 作成直前
+  → F2 /verify で 6 phase 検証
+  → READY なら commit/push
+
+タスク失敗（同じ失敗3連 / context 肥大 / drift）
+  → L5 で自己診断（/agent-introspect）
+  → 教訓を L4 へ送る（/learn）
+
+セッション終了
+  → L4 が Hook 経由で自動観察済み
+  → 余裕があれば /instinct-status 確認
+  → /gate-status で何が cleared か確認
+
+複数プロジェクトで同じ patten 反復
+  → L4 で /promote project → global
+
+大規模・並列必要
+  → L3 Ralphinho（外部 plugin・このハーネスでは雛形のみ）
+```

package/.claude/rules-details/task-management/hook-enforcement.md

@@ -0,0 +1,25 @@
+> Layer A: [`task-management.md`](../../rules/task-management.md) §設計→承認→タスク追加フロー / Hook による強制 | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# Hook 強制 詳細 (Layer B)
+
+## 詳細シナリオ (PreToolUse、`task-rule-guard.sh`)
+
+| シナリオ | 動作 | 備考 |
+|---|---|---|
+| `docs/tasks/task-<id>-<slug>.md` の Write、対応する `docs/draft/{<slug>.md, task-<slug>.md, <basename>}` が無い | **BLOCK** | 「先に `/new-draft` で設計を起こせ」と提示 |
+| `docs/tasks/task-<id>-*.md` / `phase-<id>-*.md` の Write、同 `<id>` が既に存在 | **BLOCK** | 「別 ID を割り当てるか既存を Edit せよ」と提示 |
+| `docs/tasks/` への命名規約外 Write (`task-` `phase-` で始まらない) | 警告 context 注入 (block しない) | 命名規約 hint |
+| `docs/tasks/task-*.md` の **Edit** (既存編集) | context 注入 | 「list.md と同期更新せよ」 |
+| `docs/tasks/parking-lot.md` の Edit | context 注入 | 必須 7 項目の hint |
+| `list.md` `_TASK_TEMPLATE.md` `_DRAFT_TEMPLATE.md` の Edit/Write | exempt (素通り) | 台帳 / template は別系統 |
+| サブエージェント実行中 | 全パス通過 | 多重ゲート防止 |
+
+## subagent 通過理由
+
+メイン専任の原則を機械強制するのは `delegation-guard.sh` (別 hook) の責務。`task-rule-guard.sh` は subagent context では全 path 通過し、メイン context での task ファイル創設 / 編集を主対象とする。
+
+## 違反パターン例
+
+- **設計 draft 不在のまま `/new-task` 強行** → BLOCK + 「`/new-draft <slug>` で設計を起こせ」案内
+- **同 ID で別 slug を `/new-task`** → BLOCK + 既存 task.md path を案内
+- **`docs/` 直下に直接設計書 Write** → `draft-flow-guard.sh` (別 hook) で BLOCK (本 hook 対象外)

package/.claude/rules-details/task-management/mandatory-reading.md

@@ -0,0 +1,20 @@
+> Layer A: [`task-management.md`](../../rules/task-management.md) §開発開始時の必読義務 | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# 開発開始時必読 詳細 (Layer B)
+
+## 起源
+
+user 指示「list.md やタスク詳細へ後続のタスクへどう影響するのかを意識させるために list.md へ依存先タスク (table 列追加)、タスク詳細.md へどのように影響するのかとタスク.md へのリンクを表記すること。開発時はそれとリンク先を必ず読むこと」(2026-05-26)。
+
+## 違反検出 (現状 honor system、将来機械強制化)
+
+| 段階 | 検出方法 | 動作 |
+|---|---|---|
+| **現状 (2026-05-26〜)** | honor system | main agent が `/start-task` 直後に必読対象を Read する宣言 (Why × 5 で「依存先 task-N1 / N2 の影響を確認するため、それぞれの task.md + draft を Read する」と明示) |
+| **将来 (案、別 task で起票)** | `task-rule-guard.sh` 拡張 | `/start-task <id>` 検出時に対象 task ファイル + 依存先 task ファイルが本 session で Read 済か判定、未 Read なら warn 注入 (block しない、honor system 維持で過剰防止) |
+
+## 効果 (3 層 DAG)
+
+- 後続タスクへの影響を **着手前に意識** することで、依存先の設計判断 / 完了状態を踏まえた実装が可能
+- 「依存先 task は完了済と思い込み実装着手 → 実は ⏸️ 保留中で前提崩壊」のような事故を構造的に防止
+- list.md 依存先列で **DAG 視覚化** + task.md 依存先 section で **影響内容明示** + 開始時必読義務で **実 Read 強制** の 3 層で依存関係の暗黙知化を防ぐ

package/.claude/rules-details/task-management/origin.md

@@ -0,0 +1,12 @@
+> Layer A: [`task-management.md`](../../rules/task-management.md) | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# 起源 (Layer B)
+
+- **task-21 W1.7 (paths 廃止 → 常時参照格上げ)**: 2026-05-23、`paths: ["docs/tasks/**", "docs/draft/**"]` では当該 path を Read したターンしか context に load されず、設計→承認→タスク追加フローの認識が落ちる事案 (recall_poc/docs/01-03 が docs/ 直下に直接 Write された) 受けて常時参照化
+- **task-26 W4 (SSoT 集約)**: 設計→承認→タスク追加フロー / メイン専任 / Parking Lot の SSoT を本 file に集約 (development-process.md / workflow.md から重複を吸収)
+- **task-29 Phase 2+3 (採用 5 条規範化)**: 2026-05-23、`docs/draft/phase-step-task-structure.md` 起源、Phase→Step 2 階層構造を採用
+- **採用 6 条規範化 (Task=Phase=N Step)**: 2026-05-25 採用、`docs/draft/task-equals-phase-step-status-list-normative.md` 起源、user 4 ターン連続承認、task-29 採用 5 条を supersede
+- **task-33 (plan-first 規範化)**: 2026-05-25、recall_poc plan-first 不在事案後の規範修正、P1 (本 §plan-first) を担当
+- **task-51 Step 3 (Layer A/B 2 層分割)**: 2026-05-28、context 過剰注入対策、self-improvement.md / development-process.md と同 format で分割
+
+設計の起源と承認履歴は git log + `docs/draft/` 参照。

package/.claude/rules-details/task-management/parking-lot.md

@@ -0,0 +1,26 @@
+> Layer A: [`task-management.md`](../../rules/task-management.md) §Parking Lot | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# parking-lot 詳細 (Layer B)
+
+## 必須 7 項目 format
+
+```markdown
+### 🧊 <task 名>
+
+- **起案日**: YYYY-MM-DD
+- **保留日**: YYYY-MM-DD
+- **保留理由**: <なぜ着手不可か>
+- **設計書**: [docs/draft/<slug>.md](...) or [docs/<existing>.md](...)
+- **実装状態**: <現状把握、partial 実装あれば link>
+- **再検討トリガー**: <何が起きたら 🔍 に昇格するか>
+- **代替現状**: <保留中の代替手段 or 影響範囲>
+```
+
+## 定期レビュー
+
+🔍 entry は四半期 (3 ヶ月) ごとに見直し:
+
+- 保留理由が消えていれば → `list.md` に新規 task として追加 (`/new-task`)、parking-lot.md から削除
+- 未解消なら → 再検討トリガー / 代替現状を更新
+
+❌ 不採用 entry は削除せず履歴として残す (過去意思決定のトレーサビリティ)。

package/.claude/rules-details/task-management/plan-first.md

@@ -0,0 +1,44 @@
+> Layer A: [`task-management.md`](../../rules/task-management.md) §設計→承認→タスク追加フロー / plan-first | 本 file は **明示 Read のみ** (context 自動注入 OFF)
+
+# plan-first 詳細 (Layer B)
+
+## 経路 B 手順 詳細 (4 step)
+
+1. **master roadmap で N 個 task を §plan で確定**: `docs/draft/00_master-roadmap.md` 等で計画段階の task list (id / slug / 概要 / 依存) を確定 + user 承認
+
+2. **main agent が `list.md` に N 行 📝 batch 先置き**: 承認時点で list.md 末尾に N 行を **📝 設計（未承認）** status で append (main 直接 Edit、`task-rule-guard.sh` の exempt case で `list.md` 通過)。各行は draft link 付き。
+   - **ID 払い出し手順**: list.md 既存最大 ID + 1 から連番で N 件割り当て (`grep -oE 'task-[0-9]+' docs/tasks/list.md | grep -oE '[0-9]+' | sort -n | tail -1` で最大値取得、+1 開始)。**結果が空 (list.md に `task-N` 行が 1 件も無い初期状態) の場合は ID=1 を初期値**とする (例: `next_id=$((${max:-0} + 1))` で max 空時 0 fallback、+1 で 1 開始)
+   - **重複検知**: 同 ID が既存 (📝 / 🔲 / 🔄 / ✅ 問わず) なら BLOCK + user 通知
+   - **Loop モード整合**: master roadmap §plan で user 承認済の N task を list.md に転記する **事務作業**なので、`modes.md` 遵守事項 2 例外条項「設計文書の新規追加」には該当せず、main 自律実行可。
+
+3. **個別 draft 起案** (subagent 並列可): 各 task の draft (`docs/draft/<slug>.md`) を起案 → user 承認 → 経路 A step 4 へ
+
+4. **`/new-task <id> <slug>` で 📝 → 🔲 update**: list.md の **同 ID かつ 同 slug** の既存 📝 行を **🔲 未着手** に status update (新規行 append しない、行重複なし)。`/new-task` 実装は list.md grep で既存 📝 行検出 (**ID + slug の AND 一致** 必須、ID 単独 / slug 単独 grep 禁止)。
+   - **複数マッチ**: 同 ID + slug で 2 行以上 hit なら BLOCK + user 通知
+   - **status conflict**: 同 ID で status が 📝 以外 (🔲 / 🔄 / ✅) で既存なら BLOCK + 重複 ID 修正案内
+
+## 機械検出 hook 仕様 (task-33 Phase 3 + 4)
+
+- **SessionStart hook** (`list-plan-first-reminder.sh`):
+  - **task エントリ行 判定基準**: `grep -cE '^\| [0-9]' docs/tasks/list.md` の結果が 0 (行頭 `| <id> |` パターン、📝 / 🔲 / 🔄 / ✅ すべて含む)
+  - **draft カウント基準**: `find docs/draft -name "*.md" -not -name "_*" | wc -l` (アンダースコア prefix の template 除外)
+  - **トリガー**: `docs/draft/*.md` ≥ 3 件 ∧ `list.md` task エントリ行 == 0 → `<system-reminder>` で「経路 B 適用検討」を強制注入
+  - **bypass**: `HC_LIST_PLAN_FIRST_REMINDER_ENABLED=false`
+
+- **PreToolUse(Write `docs/draft/<slug>.md`)** (`task-rule-guard.sh` 拡張):
+  - 新規 draft Write が発生した時点で、`list.md` に対応 slug の 📝 行が不在なら warn context 注入 (block しない、honor system)
+  - **検出 path**: tool_input.file_path が `docs/draft/*.md` pattern に match する場合に slug 抽出 + list.md grep
+  - **⚠️ フィルタ順序注意 (Phase 4 実装者向け)**: 既存 hook は L106-111 で `task_glob="*/${HC_TASK_DIR}/*"` ( = `*/docs/tasks/*`) に match しない path を early `exit 0` する。`docs/draft/*.md` はこのフィルタを通過しないため、新ロジックは **L106 以前** に draft path 判定を挿入する (or 既存フィルタ後の early-exit を draft path の場合 skip する分岐を加える) 必要がある。L111 以降に追記しても到達不能で warn 一切発火しない無音障害になる
+  - **slug マッチ**: 厳密一致 (kebab-case slug)、複数マッチ時は最初の 1 件のみ参照
+  - **理由**: Bash slash command (`/new-draft <slug>`) は task-rule-guard.sh の現アーキ (Edit/Write tool のみ処理) で intercept 不可、Write tool 経由で代替 (R-03 finding 反映)
+
+## 起源 (recall_poc plan-first 不在事案、2026-05-25)
+
+- 2026-05-25 recall_poc で plan-first 不在事案発生 (26 task batch plan で list.md 空継続 + user 明示質問でようやく顕在化)
+- user Post-Mortem 報告で真因 4 階層を特定:
+  1. `/new-task` 1-task-at-a-time gate (経路 B 想定外の sequential 動作)
+  2. 規範矛盾 (採用 6 条との整合性)
+  3. 凡例 📝 用途未明文化 (single draft 中 vs batch plan 中の判別不可)
+  4. AI 運用判断ミス (batch planning 経路 B の認識欠落)
+- task-33 で案 C ハイブリッド (P1+P2+P3+P5、工数 2.5) 採用、規範修正 P1 が本 § に該当
+- task-34 が `/new-task` 📝→🔲 update 動作、task-35 が SessionStart hook、task-36 が PreToolUse(Write `docs/draft/*.md`) warn 注入を担当