@takuma-hirai/hirai-method 0.1.0

package/.claude/rules/git-workflow.md

@@ -0,0 +1,71 @@
+# Git Workflow Rules: ブランチ命名規約（harness 共通）
+
+## 規約
+
+```
+<type>/<short-kebab-description>
+```
+
+- **type**: `feat` / `fix` / `refactor` / `docs` / `test` / `chore` / `perf` / `ci` / `hotfix`
+- **description**: lowercase + 数字 + `-` のみ。3〜49 文字
+- **`main`** は唯一の例外（プレフィックス不要）
+- 例: `feat/proxy-rate-limit`, `fix/perm-401-loop`, `hotfix/gateway-token-rotation`
+
+正規表現（SSoT）:
+
+```
+^(main|(feat|fix|refactor|docs|test|chore|perf|ci|hotfix)/[a-z0-9][a-z0-9-]{2,48})$
+```
+
+## 二重ガード
+
+| 層 | 場所 | 効果 | 既存ブランチへの影響 |
+|---|---|---|---|
+| ローカル | `.githooks/pre-push` | 新規作成 push 時のみ検証 | なし（update push は素通し） |
+| サーバー | GitHub Rulesets (`.github/rulesets/branch-naming.json`) | 創設時 reject | なし（既存 ref には適用しない） |
+
+両ファイルは consuming project 側で個別に配置する（harness 内には現状テンプレ未配布。プロジェクトの実装例: `openclaw-railway-deploy`）。
+
+## セットアップ（プロジェクト側で 1 回）
+
+### A. GitHub Rulesets（サーバー側・必須）
+
+```bash
+gh api --method POST \
+  /repos/{OWNER}/{REPO}/rulesets \
+  --input .github/rulesets/branch-naming.json
+```
+
+### B. ローカル pre-push hook（補助・推奨）
+
+```bash
+chmod +x .githooks/pre-push
+git config core.hooksPath .githooks
+```
+
+クローンごとに 1 回。
+
+## 変更時の同期義務
+
+正規表現を変える場合は **3 箇所同時更新**（drift 禁止）:
+
+1. このファイル
+2. `.githooks/pre-push` の `ALLOWED_REGEX`
+3. `.github/rulesets/branch-naming.json` の `parameters.pattern`
+
+## 緊急バイパス
+
+| 方法 | スコープ | 痕跡 |
+|---|---|---|
+| `git push --no-verify` | 1 push のみ（local 側のみ。Rulesets は依然 reject） | git log に痕跡なし |
+| Rulesets 一時 disable | repo 全体 | GitHub audit log |
+
+honor system: 緊急バイパス時は理由を commit message または PR description に明記。
+
+## 関連
+
+- Commit 規約: Conventional Commits（`<type>(<scope>): <desc>`）
+
+---
+> **project 固有の追補・override は `.claude/project-rules/git-workflow.md` に書く** (本 file は harness 所有、`install.sh --update` で上書きされる。project 固有編集は下記 import 先へ)。
+@../project-rules/git-workflow.md

package/.claude/rules/modes.md

@@ -0,0 +1,189 @@
+<!--
+task-21 W0.1: Loop モード遵守事項規範化 (主に遵守事項 7+8 起源)。
+task-39 (2026-05-25): feature branch push + gh pr create 自律実行可へ緩和。
+task-41 (2026-05-26): Loop モード確認質問検出 (層 6) 追加。
+task-47 (2026-05-27): 遵守事項 9 (list.md 全 task 連続自律実行) 新設。
+task-51 Step 3 (2026-05-28): Layer A/B 2 層分割。
+task-67 (2026-06-01): Layer B を 5 断片に分割、断片直リンク方式へ移行。
+-->
+
+# HIRAI メソッド 動作モード
+
+HIRAI メソッドは **Normal / Loop** 2 つの動作モードを持つ。Loop モードはユーザの明示停止指示まで AI 推奨方法を即採用して実装継続。本 rule は **9 遵守事項 / 自律実行禁止 11 カテゴリ / 5 層強制機構 / mode 切替方法 / context-budget hook tier** の SSoT。常時参照 (frontmatter 無し、毎セッション AI が読む)。
+
+> **Layer B (詳細版) Read trigger** (4 条件):
+> 1. **違反検出時**: hook BLOCK / warn 注入受領 / regex 不一致
+> 2. **規範変更時**: rule 編集 / draft 起案 / 採用 N 条改定
+> 3. **新規事案**: 初遭遇 keyword / 例外パターン疑い
+> 4. **学習 / dogfood**: task 着手前依存先必読 / harness audit / 副産物整理
+>
+> 通常運用は Layer A のみで判断、Layer B Read skip (token 節約)。
+> 詳細: 各 § 末尾 pointer から該当断片を直リンク Read (断片群: [`../rules-details/modes/`](../rules-details/modes/))
+
+## モード一覧
+
+### Normal モード（既定値）
+
+- 重要分岐でユーザに確認を求めながら進める
+- Why × 5 出力（`why-x5-output.md`）は常時 ON
+- セッション開始時に Loop モードへの切替を **1 度だけ提案** する
+
+### Loop モード
+
+ユーザの明示的な停止指示まで、AI が推奨する方法を即採用して実装を継続する。
+
+## Loop モード遵守事項 (9 件)
+
+1. **AI 推奨方法を即採用**: 複数選択肢がある場合、ユーザに確認を求めず Why × 5 で評価して推奨を採用
+2. **中間確認の停止**: 「進めてもよいですか?」「どちらにしますか?」等の質問は禁止
+   - **例外**: 以下は禁止対象外、引き続き user 確認必須:
+     - **設計文書の新規追加** (`docs/draft/<slug>.md` の新規起こし + user 承認依頼)
+     - **仕様変更 / scope 拡張** (承認済 draft の §3 採用案からの逸脱)
+     - **戦略的判断** (architecture 選択 / 採用技術スタック変更 / 既存 task の優先順入替)
+     - **規範変更** (`.claude/rules/*.md` / `.claude/commands/*.md` / `.claude/templates/docs/**/*.md` への Edit/Write) — honor system (機械強制 BLOCK は 2026-05-28 撤廃)
+   - 禁止対象は **戦術判断のみ**: 実装中の方式選択 / branch 命名 / commit メッセージ / 一時的なエラー対処 / build green までの試行錯誤
+3. **自律分解と継続**: 大きなタスクは自ら分解し最後まで通す
+4. **Why × 5 表示の維持**: 確認は省くが、思考過程の透明性は失わない
+5. **適切な粒度でコミット** (必須): 自律実装中も論理単位 (1 機能 / 1 修正 / 1 リファクタ) ごとに `git commit` を切る
+   - 各 commit は **独立して動作する状態** を保つ (テスト通過 / build green)
+   - メッセージは Conventional Commits 形式 (`feat:` `fix:` `refactor:` 等)
+   - 失敗時 `git revert <sha>` / `git reset --hard <sha>` で **戻せる**粒度を維持
+   - 巨大コミット (複数機能を 1 つに混ぜる) は禁止
+6. **Context 使用率の自動監視と保存** (必須): `context-budget.sh` hook が毎ターン context 使用率を監視
+   - **60% / 80% / 95%** の各 tier を初めて超えた時、`<system-reminder>` で警告注入
+   - 警告受領 → **このターン内で必ず `/save-state` 実行** + 「新 session で `/resume-state` で復元するか継続するか」を提案
+   - 同一 tier は 1 セッションあたり 1 度のみ発火 (spam 防止)
+   - 閾値は `.claude/harness-config.yml` の `context_budget_threshold` で変更可
+   - 一時無効化: `HC_CONTEXT_BUDGET_ENABLED=false`
+7. **subagent 並走中の独立作業義務** (必須): subagent を `run_in_background: true` で起動後、completion 通知を **受動的に待つだけ** は禁止
+   - メインは以下のいずれかを並行進行: (a) 別の独立 task 着手 (b) メイン専任作業 (タスク管理 / list.md sync / task ファイル生成 / draft 起こし) (c) 規範文書化 (d) memory / next-actions.md 整理
+   - 並行作業ができない場合 (依存関係 / 既に全 task 着手済) のみターン区切り報告で停止可
+   - **「subagent 完了通知後のメイン報告 → 即次タスク自動起動」を default 動作**
+   - **多数 fan-out は構造化** (task-68): 3 件以上の独立 subagent 起動は `Workflow` ツール default 検討 / 手書きは 2 件/ターン上限 (長 prompt は file 経由) で markup 崩れ loop を防ぐ。詳細は [`development-process.md`](./development-process.md) §「多数 fan-out の Workflow 標準化 + 1 ターン tool block 上限」
+8. **自律実行禁止リスト** (必須): Loop モードでも以下 11 カテゴリは **user 明示承認が必要**。準備 (draft / 設計 / ローカル `git commit`) のみ自律可。**2026-05-25 task #39 で緩和**: feature branch (= mainline / stg* / release* 以外) への `git push` および `gh pr create` を自律実行可とした。**2026-06-03 task #77 で本流統合を `mainline_integration_policy` (3 状態) に対応** (`git-integration-policy.md` §3.2/§3.3/§3.4 が SSoT)。
+
+   - **remote 反映 (本流 push、policy 連動)**: `mainline_branch` (= 統合先、default `main`) への remote push は **`mainline_integration_policy` に連動**する:
+     - `pr-required` (team/prod 既定): 本流 merge / push とも **user**。AI は feature branch に commit → push → `gh pr create` まで。
+     - `local-merge` (solo): AI は **ローカル本流 merge まで自律可**、remote push は **user**。
+     - `local-merge-push` (solo/実験): AI が **ローカル merge + remote 本流 push まで自律可**。
+     - **local merge 自体は hook 非 gate (push のみ `git-deny.sh` Tier2 が gate)** のため、`pr-required` / `local-merge` 時に AI が remote 本流 push しないのは push gate (hook) が、AI が `pr-required` 時にローカル本流 merge しないのは **honor-system 統治** (現「main 操作」honor-system と整合)。
+     - **`stg*` / `release*` への remote push は全 policy で常に user** (Tier1 安全弁、policy で緩めない)。`mainline_branch` を別ブランチに変えても **`main` は常時 block 維持** (mainline 移動で main 無保護化しない)。不正 / 未知 policy 値は fail-safe で `pr-required` 扱い。
+     - **conflict 時** (`git merge --no-ff` で衝突): `git merge --abort` して user 報告・停止 (遵守事項 9「続行不可」該当、自動解決禁止)。**push 拒否時** (non-fast-forward 等): auto-retry / rebase せず **hard stop** + user 通知。
+   - **PR / リリース**: `gh pr merge` / `gh release create` / `git tag <name> origin` (`gh pr create` は自律可)
+   - **main 操作**: main checkout 後の編集 (本流 merge は上記「remote 反映 (本流 push、policy 連動)」が SSoT)
+   - **DB 作業**: migration 実行 / `INSERT/UPDATE/DELETE` 直接実行 / dump / restore
+   - **本番 deploy**: `vercel --prod` / `supabase deploy` / production environment 触る操作
+   - **secrets**: `.env*` 編集 / API key 生成・ローテーション / OAuth token 操作
+   - **外部通知**: Slack post / メール送信 / Asana タスク作成・更新
+   - **CI/CD**: `.github/workflows/` 編集 + push
+   - **license / public**: LICENSE 変更 / README 公開アピール変更 / `package.json` major bump
+   - **subagent への委譲拡張**: 上記操作を subagent prompt で許可すること
+   - **第三者リポ**: submodule update / fork 外への push / `gh repo` 操作
+
+   違反検出時の hook 強制: `.claude/hooks/autonomous-action-guard.sh` が PreToolUse(Bash) で対象コマンドを `exit 2` BLOCK。bypass: `ECC_AUTONOMOUS_ACTION_OVERRIDE=1` (`.claude/.workflow-state/bypass.log` に記録)。honor system (hook 未実装パスの場合): メインは自律実行せず user に「実行を承認しますか?」と提示してから実行。各カテゴリの例外 (準備として OK) 詳細は Layer B 参照。
+
+9. **Loop モード = list.md 全 task 連続自律実行** (必須、2026-05-27 task-47 新設): `/resume-state loop` 起動時、`session/context` 着手手順完遂後も `docs/tasks/list.md` の **🔄 進行中 + 🔲 未着手** task を依存解決順で自動 enque + 着手。draft `approved_at:` 非空 (= user 承認済) task のみ自律着手可、draft 不在 / 未承認 task は user 確認必須項目として stop。停止条件 3 つ:
+   - context 閾値到達 (tier 80 以上で強制 `/save-state`、`context-budget.sh` `ratio >= 0.80` で発火)
+   - 続行不可 (同一 error 3 連続失敗 / 致命的 error / security CRITICAL / subagent 「要判断」報告)
+   - user 明示停止 (`stop` / 「止めて」等)
+
+   停止時は **自動 `/save-state`** + 「新 session で `/resume-state loop` で継続。残 task: <id 列挙>」案内を実行。Phase 6 実装仕様は `.claude/commands/resume-state.md` Phase 6 step 3a-3e + step 4-7 参照。
+
+**停止条件は以下 3 つのみ**:
+- ユーザの明示的な停止指示 ("stop" / "ストップ" / "止めて" 等)
+- タスクの完了
+- 致命的エラー (権限拒否 / 復旧不能 / 重大なデータ破壊リスク)
+
+> **遵守事項 2 例外条項の起源 / 遵守事項 7 違反例 / 遵守事項 8 緩和経緯 / 遵守事項 9 Phase 6 実装仕様**: [modes/compliance-items.md](../rules-details/modes/compliance-items.md)
+
+## Loop モード自律規律の 5 層強制機構
+
+タスク実装中・Loop モード稼働中の「subagent 完了待ち停止」「破壊的操作の自律実行」「確認質問発話」を **5 層強制** で構造防止する。
+
+| 層 | 機構 | 発火 | 動作 |
+|---|---|---|---|
+| 1 | `.claude/rules/modes.md` 遵守事項 7+8 | (規範) | subagent 待ち中独立作業義務 + 自律禁止 11 カテゴリ明文化 |
+| 2 | `.claude/hooks/loop-auto-progress-reminder.sh` (UserPromptSubmit) | 毎ターン | 待ち中報告キーワード検出 + pending Agent tool_use 数集計 → `<system-reminder>` 強制注入 |
+| 3 | `.claude/hooks/autonomous-action-guard.sh` (PreToolUse Bash) | Bash 実行前 | 11 カテゴリ regex 照合 → Loop なら `{"decision":"block"}` / Normal なら context 注入 |
+| 4 | `.claude/settings.json` 配線 | (機構接続) | UserPromptSubmit 末尾 + PreToolUse Bash 先頭に配置 |
+| 5 | `.claude/tests/loop-auto-progress-smoke.sh` | 検証 | 9 ケースで両 hook の動作検証 |
+| 6 | `.claude/hooks/loop-confirmation-detector.sh` (Stop) | AI 最終 message 出力後 | 確認質問 regex 検出 (「進めてよいですか」「OK ですか」「お待ちします」等) → `<system-reminder>` 強制注入で次 turn 自律是正 |
+
+### 禁止 11 カテゴリ (default、`HC_AUTONOMOUS_ACTION_PATTERNS` で上書き可)
+
+- remote 反映: `git push origin main|stg*` のみ (feature branch push は task #39 緩和で自律可)
+- PR / リリース: `gh pr merge` / `gh release` / `git tag <name> origin|upstream` (`gh pr create` は task #39 緩和で自律可)
+- 第三者リポ: `gh repo (delete|transfer|archive)`
+- 本番 deploy: `vercel --prod` / `supabase deploy` / `supabase db (push|reset)`
+- infra apply: `kubectl (apply|delete)` / `terraform (apply|destroy)`
+- AWS 破壊操作: `aws *-delete-*|terminate-*|destroy-*`
+
+### bypass
+
+| 経路 | env | スコープ | 痕跡 |
+|---|---|---|---|
+| autonomous-action-guard 無効化 | `ECC_AUTONOMOUS_ACTION_OVERRIDE=1` | 1 セッション | bypass.log (autonomous-action-guard 行) |
+| config レベル OFF | `HC_AUTONOMOUS_ACTION_ENABLED=false` | 1 セッション | bypass.log |
+| reminder 無効化 | `HC_LOOP_AUTO_PROGRESS_ENABLED=false` | 1 セッション | (記録なし、reminder のみ) |
+| パターン上書き | `HC_AUTONOMOUS_ACTION_PATTERNS=...` | env-set 中 | 上書き内容は env のみ |
+| 確認質問検出 OFF | `HC_LOOP_CONFIRMATION_DETECTION_ENABLED=false` / `ECC_LOOP_CONFIRMATION_OFF=1` | 1 セッション | (記録なし) |
+
+honor system: bypass 時は理由を `docs/tasks/<task-N>.md` または `ECC_BYPASS_REASON` env に記録。
+
+> **各層の動作 source code 参照 / smoke list 9 ケース完全版 / 層 6 task-41 起源**: [modes/five-layer-enforcement.md](../rules-details/modes/five-layer-enforcement.md)
+
+## 設定
+
+モードは `.claude/mode.yml` で永続化。値は `normal` か `loop`。
+
+```yaml
+mode: normal  # または loop
+```
+
+## 切替方法
+
+| 方法 | 用途 |
+|---|---|
+| `/mode loop` / `/mode normal` slash command | セッション中の切替 (推奨) |
+| `.claude/mode.yml` 直接編集 | 手動切替 |
+| `HC_MODE=loop` 環境変数 | YAML を触らず一時切替 |
+
+値解決の優先順 (高 → 低): `env(HC_MODE)` > `mode.yml` > `default(normal)`
+
+## 強制機構 (mode 系 hook)
+
+| Hook | タイミング | 役割 |
+|---|---|---|
+| `.claude/hooks/mode-session-start.sh` | SessionStart | 現モード表示 / normal 時に切替提案 |
+| `.claude/hooks/mode-enforce.sh` | UserPromptSubmit | Loop モード時に毎ターン遵守事項を再注入 |
+| `.claude/hooks/context-budget.sh` | UserPromptSubmit | Loop モード時に context 使用率を監視し、60/80/95% 超で `/save-state` 実行 + 再開提案を強制 |
+
+全て `.claude/hooks/lib/mode-loader.sh` で現モードを解決する (Normal モードでは全て no-op)。
+
+> **mode-loader.sh 内部仕様 / mode-session-start.sh / mode-enforce.sh context 注入詳細 / context-budget.sh tier 算出ロジック**: [modes/mode-hooks.md](../rules-details/modes/mode-hooks.md)
+
+## モードと既存ルールの関係
+
+| ルール | Normal | Loop |
+|---|---|---|
+| `why-x5-output.md` (Why × 5 表示) | ON | ON |
+| 中間確認質問 | 要 | 禁止 |
+| サブエージェント委譲 (`delegation-guard.sh`) | 要 | 要 |
+| 事実検証 (`gateguard.sh`) | 要 | 要 |
+
+Loop モードでも委譲・事実検証等の安全ガードは無効化されない。**省略するのはユーザ確認のみ**。
+
+## 関連 artifact (代表)
+
+- [`.claude/hooks/loop-auto-progress-reminder.sh`](../hooks/loop-auto-progress-reminder.sh) (層 2)
+- [`.claude/hooks/autonomous-action-guard.sh`](../hooks/autonomous-action-guard.sh) (層 3)
+- [`.claude/hooks/loop-confirmation-detector.sh`](../hooks/loop-confirmation-detector.sh) (層 6)
+- [`.claude/tests/loop-auto-progress-smoke.sh`](../tests/loop-auto-progress-smoke.sh) (層 5)
+
+> **関連 artifact 完全 list (mode 系 hook + 5 層強制機構 + smoke 群 + 設計起源 draft path)**: [modes/artifacts.md](../rules-details/modes/artifacts.md)
+
+> **各規範の起源 (history 全体、task-21 W0.1 〜 task-51 Step 3 の変更履歴) / commit hash**: [modes/origin.md](../rules-details/modes/origin.md)
+
+---
+> **project 固有の追補・override は `.claude/project-rules/modes.md` に書く** (本 file は harness 所有、`install.sh --update` で上書きされる。project 固有編集は下記 import 先へ)。
+@../project-rules/modes.md

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

@@ -0,0 +1,76 @@
+# 自己改善 5 層 + 事実性レイヤー（ECC 由来）
+
+このハーネスは ECC（Everything Claude Code）の自己改善アルゴリズム **5 層 + 事実検証 2 層** を完全模倣している。タスク受領時・失敗時・完了時に「どの層を使うか」を意識する。
+
+> **Layer B (詳細版) Read trigger** (4 条件):
+> 1. **違反検出時**: hook BLOCK / warn 注入受領 / regex 不一致
+> 2. **規範変更時**: rule 編集 / draft 起案 / 採用 N 条改定
+> 3. **新規事案**: 初遭遇 keyword / 例外パターン疑い
+> 4. **学習 / dogfood**: task 着手前依存先必読 / harness audit / 副産物整理
+>
+> 通常運用は Layer A のみで判断、Layer B Read skip (token 節約)。
+> 詳細: 各 § 末尾 pointer から該当断片を直リンク Read (断片群: [`../rules-details/self-improvement/`](../rules-details/self-improvement/))
+
+## 層構造
+
+| 層 | 名称 | 改善対象 | 観察粒度 | 永続化先 |
+|---|---|---|---|---|
+| **L1** | Eval-Driven Dev | 1 機能の正しさ | コミット単位 | `.claude/evals/` |
+| **L2** | Continuous Loop / GAN | 1 タスクの品質 | 1 反復 | `feedback-NNN.md` |
+| **L3** | Ralphinho RFC-DAG | プロジェクト構造 | 作業ユニット | jj worktree |
+| **L4** | Continuous Learning v2.1（核心） | エージェントの行動 | ツール呼び出し | `~/.claude/homunculus/` |
+| **L5** | Introspection Debugging | エージェント自身 | 失敗パターン | introspection report |
+| **F1** | **GateGuard**（事前ゲート） | **Edit/Write/Bash の事実性** | **初回ファイル/コマンド** | `.claude/.gateguard-state/` |
+| **F2** | **Verification Loop**（事後検証） | **PR 直前の品質** | **6 phases** | `/verify` レポート |
+
+## いつどの層を使うか（要約）
+
+```
+タスク受領 → L1 で合否基準 → L2 でループ実装 → L1 で合否確認
+Edit/Write 初回 → F1 BLOCK → 4 事実提示 → retry 通過
+破壊的 Bash 初回 → F1 BLOCK → rollback/影響/逐語引用 → retry
+PR 直前 → F2 /verify 6 phase → READY なら commit/push
+失敗 3 連 → L5 /agent-introspect → L4 /learn で教訓化
+セッション終了 → L4 自動観察済 (Hook 経由)
+複数 project 反復 → L4 /promote project → global
+```
+
+> **判断フロー full / 大規模・並列ケース詳細**: [self-improvement/when-to-use-layers.md](../rules-details/self-improvement/when-to-use-layers.md)
+
+## 事実性レイヤー（F1/F2）の効果
+
+| 層 | 検出 | 効果 |
+|---|---|---|
+| **F1 GateGuard** | 初回の Edit/Write/破壊的 Bash | A/B 実測で **+2.25 / 10 ポイント**（ungated 6.75 → gated 9.0） |
+| **F2 Verification** | Build/Type/Lint/Test/Security/Diff の 6 軸 | PR 直前の事故防止 |
+
+両者の役割分離:
+- F1 = "**実行前**に事実を強制"（投機的な Edit を防ぐ）
+- F2 = "**実行後**に網羅検証"（バグの作り込みを止める）
+
+## メインエージェントへの要請
+
+1. **タスク受領時**: `/eval define` で先に合否基準を書く（できるなら）
+2. **失敗が3連した時**: `/agent-introspect` を即起動して盲目リトライしない
+3. **完了時**: `/instinct-status` で増えた instinct を確認、user に報告
+4. **新規スキル提案時**: `/evolve` で既存 instinct クラスタから派生提案
+5. **共通ルール抽出時**: `/promote` で project → global 昇格
+
+> **L4 動作前提 / 信頼度挙動 / 失敗モード対処詳細**: [self-improvement/l4-mechanics.md](../rules-details/self-improvement/l4-mechanics.md)
+
+## 関連スキル / コマンド (代表)
+
+- L1: `/eval {define|check|report}` ([eval-harness](../skills/eval-harness/SKILL.md))
+- L2: `/gan-design` `/gan-build` ([continuous-agent-loop](../skills/continuous-agent-loop/SKILL.md), [gan-style-harness](../skills/gan-style-harness/SKILL.md))
+- L4: `/instinct-status` `/learn` `/evolve` `/promote` ([continuous-learning-v2](../skills/continuous-learning-v2/SKILL.md) — 核心)
+- L5: `/agent-introspect` ([agent-introspection-debugging](../skills/agent-introspection-debugging/SKILL.md))
+- F1: `/gate-status` `/gate-clear` `/gate-bypass` ([gateguard](../skills/gateguard/SKILL.md))
+- F2: `/verify` ([verification-loop](../skills/verification-loop/SKILL.md))
+
+> **全 skill / command 完全 list**: [self-improvement/related-skills.md](../rules-details/self-improvement/related-skills.md)
+
+> **L1-L5 + F1/F2 模倣の起源 (ECC 由来 / skill 移植 provenance) / 規範化経緯**: [self-improvement/origin.md](../rules-details/self-improvement/origin.md)
+
+---
+> **project 固有の追補・override は `.claude/project-rules/self-improvement.md` に書く** (本 file は harness 所有、`install.sh --update` で上書きされる。project 固有編集は下記 import 先へ)。
+@../project-rules/self-improvement.md

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

@@ -0,0 +1,261 @@
+<!--
+task-21 W1.7: paths 条件付き受動 load を廃止し、常時参照 rule に格上げ。
+task-26 W4: 設計→承認→タスク追加フロー / メイン専任 / Parking Lot の SSoT として確立。
+task-29 Phase 2+3 (2026-05-23): Phase→Step 規範化。
+2026-05-25 採用 6 条 (Task=Phase=N Step) で task-29 採用 5 条を supersede。
+task-51 Step 3 (2026-05-28): Layer A/B 2 層分割。
+task-67 Step 3 (2026-06-01): Layer B 断片化、Layer A pointer 直リンク化。
+-->
+
+# タスク管理ルール
+
+本 rule は **メイン専任 / 採用 6 条 (Task=Phase=N Step) / 設計→承認→タスク追加フロー / plan-first 行先置き 2 経路 / 開発開始時必読義務 / parking-lot 運用** の SSoT。常時参照 (frontmatter 無し、毎セッション AI が読む)。
+
+> **Layer B (詳細版) Read trigger** (4 条件):
+> 1. **違反検出時**: hook BLOCK / warn 注入受領 / regex 不一致
+> 2. **規範変更時**: rule 編集 / draft 起案 / 採用 N 条改定
+> 3. **新規事案**: 初遭遇 keyword / 例外パターン疑い
+> 4. **学習 / dogfood**: task 着手前依存先必読 / harness audit / 副産物整理
+>
+> 通常運用は Layer A のみで判断、Layer B Read skip (token 節約)。
+> 詳細: 各 § 末尾 pointer から該当断片を直リンク Read (断片群: [`../rules-details/task-management/`](../rules-details/task-management/))
+
+## bypass env naming convention (SSoT)
+
+本 harness の全 bypass env は **2 系統に分離** され、用途・痕跡・スコープが明確に区別される。各規範文書 (`task-management.md` / `workflow.md` / `modes.md` / `development-process.md`) の bypass table はこの規約に従う。
+
+| prefix | 系統 | 用途 | 痕跡 |
+|---|---|---|---|
+| `ECC_*` | env 系統 | 1 セッション限定 bypass、操作の audit trail を `.claude/.workflow-state/bypass.log` に append | bypass.log |
+| `HC_*` | config 系統 | feature toggle / yml override (`harness-config.yml` 経由で永続化される可能性あり) | yml + bypass.log (一部) |
+
+両系統併存は意図的 (env 系統と config 系統から独立に bypass 可能、片方の誤った enabled 状態放置を防ぐ)。
+
+## メインエージェント専任（必須）
+
+タスク管理はメインエージェントのみが行う。サブエージェントにタスク管理を委譲してはならない。
+
+- `docs/tasks/list.md` のステータス更新 → メインが必ず実行
+- 個別タスクファイルの作成・更新 → メインが必ず実行
+- サブエージェント起動前にタスクを「進行中」に更新
+- サブエージェント完了後にタスクを「完了」に更新
+
+## タスク構造規範 — 採用 6 条 (Task=Phase=N Step、Phase 中間階層廃止)
+
+**起源**: 2026-05-25 採用、`docs/draft/task-equals-phase-step-status-list-normative.md`。task-29 採用 5 条を supersede。Phase 中間階層を廃止し「Task = Phase = N Step」の 2 階層に圧縮。
+
+### 採用 6 条 (条文)
+
+1. **Task = Phase = N Step (2 階層、Phase 廃止)** — 1 task は 1 Goal + N Steps。Phase / Wave / Sub-Phase 等の中間階層は禁止。既存 Wave / Phase 構造は次回着手時に再構造化。
+
+2. **Task 必須項目 (5 件)**: 「**ゴール** (1 文、観察可能)」+ 「**作業概要** (箇条書き 3-5 件)」+ 「**完了条件** (定量 or 観察可能な事実、DoD)」+ 「**概要欄** (list.md 用、「**何のため × 何をやる × 何ができるようになる**」3 要素必須)」+ 「**依存先タスク** (`task-N1, task-N2` 形式で ID 列挙、依存なしは `—`、空欄禁止 + Task header section に **影響内容 + 依存先 task.md リンク** 記載)」。`/start-task` 直後に依存先 task.md + 関連 draft を **必ず Read** (§「開発開始時の必読義務」)。
+
+3. **Step 必須項目 (4 件)**: 「**作業概要** (1-2 文 actionable)」+ 「**完了条件** (再現可能な検証コマンド)」+ 「**Step status** (📝/🔲/🔄/✅/⏸️)」+ 「**概要欄** (list.md 用、**作業概要のみ**、3 要素不要)」。
+
+4. **Task 最終 = テスト設計レビュー → テスト合格 → リファクタリング (3 段必須)**:
+   - **テスト設計レビュー**: メイン agent がテスト設計を分析 → reviewer を **`review_min_count_test`〜`review_max_count_test` の範囲で動的選定** (`tdd-guide` / `test-automator` / `qa-expert` / `pr-test-analyzer` base、UI/DB/API/言語/security で加味)。**起動前に必ず `bash .claude/scripts/hc-config.sh --get review_max_count_test` で上限を確認し、並列起動数 N が `min ≤ N ≤ max` に収まることを保証する** (`review_required_test: false` なら本 step skip 可、青天井「5+」は廃止 = task-64) → 並列起動 (`run_in_background: true`) → 修正提案集約 → 再起動。**収束条件**: 全 reviewer approve / no objection。**反復上限**: `review_iteration_max` (`hc-config.sh --get review_iteration_max` で確認、default 5、`ECC_TEST_DESIGN_REVIEW_OFF=1` で bypass)。値解決順: `env(HC_REVIEW_*)` > `harness-config.local.yml` > `harness-config.yml` > default。reviewer prompt は [workflow.md §reviewer prompt 共通規約](./workflow.md) 5 必須項目 (対象 Read / 観点 / findings format / confidence / **プロジェクト整合性 + 他 task 影響確認**) を必ず含める (2026-05-28 追加、`HC_REVIEW_PROJECT_CONTEXT_REQUIRED=false` で bypass 可だが採用 6 条 4 初回 round-1 は NG ケース)。
+   - **テスト合格**: UI 含 Task → **E2E 必須 + ビジュアル検証必須** (agent-browser skill で screenshot、主要 breakpoint / 状態 / theme 撮影)。UI なし → unit/integration PASS で OK。terminal TUI 対象外。
+   - **リファクタリング**: 持続可能性 / 汎用性 / 非冗長化 の 3 観点。不要なら `skip: <reason>` 明示記録。
+
+5. **小タスク許容**: hot fix / typo 修正 / config 1 行追加 等は「1 Task + 1 Step」OK。条 4 の最終 3 Step は「1 Step 内に test + refactor 判定を併記」で代替可。
+
+6. **list.md 表現規約 (6 列、2026-05-26 依存先列追加)**:
+   - **column**: `# | Step Status | Task / Step | 概要 | 依存先 | 詳細`
+   - **Task header row**: `| <id> | <集約 status> | **Task: <名>** | <Task 概要 3 要素> | <依存先 ID or —> | [task-<id>-<slug>.md] |`
+   - **Step sub-row**: `|    | <Step status> | Step N | <作業概要> | | |` (#列 + 依存先列空)
+   - **集約 status**: 全 ✅ → ✅、🔄/🔲 混在 → 🔄、全 🔲 → 🔲、全 📝 → 📝、⏸️ 含む → ⏸️
+   - **status 凡例**: SSoT は直下の Step status emoji 凡例 mini-table 参照 (5 種限定: 📝🔲🔄✅⏸️)
+   - **概要欄 2 種規約**: Task = 3 要素 (purpose × work × outcome) / Step = 作業概要のみ
+
+> **Step status emoji 凡例 (SSoT)**: 📝 設計未承認 / 🔲 未着手 / 🔄 進行中 / ✅ 完了 / ⏸️ 保留 — 本 harness の全 rule / template / list.md / task.md で本 5 種のみ使用。他の emoji (例: 🟢 🟡 🔴 等) は緊急度や別軸用途で混同禁止。
+
+> **3 観点 (リファクタリング、採用 6 条 4)**: 持続可能性 (Sustainability) / 汎用性 (Generality) / 非冗長化 (Deduplication)。詳細 sub-checklist は [`workflow.md`](./workflow.md) §「リファクタリング強制 (W3)」参照。
+
+> **OK/NG 例詳細 (条 2/3/6) / task-29 採用 5 条 supersede 経緯**: [task-management/six-articles.md](../rules-details/task-management/six-articles.md)
+
+### bypass
+
+| 経路 | env | スコープ | 痕跡 |
+|---|---|---|---|
+| Task=Phase 構造強制無効化 | `ECC_PHASE_STEP_STRUCTURE_OFF=1` | 1 セッション | `.claude/.workflow-state/bypass.log` |
+| テスト設計レビュー (条 4) 無効化 | `ECC_TEST_DESIGN_REVIEW_OFF=1` | 1 セッション | `.claude/.workflow-state/bypass.log` |
+
+honor system: bypass 時は理由を CLAUDE.md or `docs/tasks/<task-N>.md` に記録。機械強制 hook は本規範採用フェーズでは未実装。
+
+## 開発開始時の必読義務 (2026-05-26 採用)
+
+採用 6 条 2 の **依存先タスク** を実効化するため、Task 開発開始時 (`/start-task <id>` 直後) に以下を **必ず Read**。
+
+### 必読対象
+
+| 対象 | 読み方 |
+|---|---|
+| **本 task の `docs/tasks/task-<id>-<slug>.md`** | 全文 Read |
+| **本 task の `docs/draft/<slug>.md`** (存在時) | 全文 Read |
+| **依存先 task の `docs/tasks/task-<N>-<slug>.md` 全件** | Task ゴール + 完了条件 + 影響範囲を最低限 Read |
+| **依存先 task の `docs/draft/<dep-slug>.md`** (存在時) | 採用案 + リスク sections を Read |
+
+### 例外
+
+- **依存先 0 件**: 本 task の task.md + draft.md のみで OK
+- **小タスク (1 Task + 1 Step、条 5)**: 本 task ファイルのみで OK
+- **依存先が parking-lot の 🧊 / ❌**: 履歴として Read 推奨
+
+違反検出は当面 honor system (main agent が Why × 5 で必読宣言)、将来 `task-rule-guard.sh` 拡張で warn 注入予定。
+
+> **必読義務の起源 (2026-05-26 user 指示) / 効果 3 層 (list.md DAG + task.md 影響内容 + 開始時 Read 強制)**: [task-management/mandatory-reading.md](../rules-details/task-management/mandatory-reading.md)
+
+## 既存 task 移行ガイド
+
+**適用範囲**: 2026-05-25 以降の新規 task のみ採用 6 条必須。それ以前は段階移行。
+
+| 世代 | 採用規範 | 既存 task | 扱い |
+|---|---|---|---|
+| **G1 (Wave、〜2026-05-23)** | 自由 Wave 構成 | task-1〜20 + 22/25/26 | 移行不要、履歴保持 |
+| **G2 (Phase→Step、2026-05-23〜25)** | task-29 採用 5 条 | task-21/23/24/27/28/29〜32/33 | 次回着手時に新採用 6 条へ再構造化推奨 (honor system) |
+| **G3 (Task=Phase=N Step、2026-05-25〜)** | 新採用 6 条 | task-34〜 | 必須適用 |
+
+> **移行優先度 task 個別 table / task-33 即 restructure 経緯**: [task-management/task-migration.md](../rules-details/task-management/task-migration.md)
+
+## UI 変更検出基準
+
+採用 6 条 4 の「UI 含 Task は E2E + ビジュアル検証必須」発動判定。本規範採用フェーズでは **手動運用** (機械強制 hook は future work)。
+
+### 判定基準 (OR 条件、過検知許容)
+
+- **拡張子**: `*.tsx` / `*.jsx` / `*.vue` / `*.svelte` / `*.html` / `*.css` / `*.scss` / `*.sass` / `*.less`
+- **path**: `src/components/**` / `src/pages/**` / `src/app/**` / `apps/**/components/**` / `apps/**/pages/**` / `components/**`
+
+### 検出コマンド (手動)
+
+```bash
+git diff --name-only <base>...HEAD | grep -E '\.(tsx|jsx|vue|svelte|html|css|scss|sass|less)$|^(src|apps/[^/]+)/(components|pages|app)/|^components/'
+```
+
+### 手動 skip format
+
+UI 変更だが view 影響なし時、Step 完了条件に明示:
+
+```
+完了条件: skip: UI 変更だが view 影響なし (CSS 変数 rename のみ、レンダリング結果同一)
+```
+
+> **機械強制 hook 案 (future work) 詳細**: [task-management/ui-detection.md](../rules-details/task-management/ui-detection.md)
+
+## 設計→承認→タスク追加フロー（必須）
+
+**設計なしのタスク追加は禁止**。下記 4 ステップ厳守:
+
+> **Loop モードでも本フローは免除されない** (task-21 W2.2)。`modes.md` 遵守事項 2 例外条項参照。`draft-flow-guard.sh` が **team-default / strict preset では機械強制 BLOCK / harness-dev preset では advisory** (`feature_draft_flow_guard_enabled`、現 effective 状態は `bash .claude/scripts/hc-config.sh --summary` 参照)。
+
+1. **テンプレ初期化** (SessionStart hook で自動、明示は `/init-tasks`)
+2. **設計起こし**: `/new-draft <slug>` で `docs/draft/<slug>.md` 生成 → §1〜9 を埋める
+3. **承認依頼**: user レビュー・承認、履歴を draft §8 に記録
+4. **タスク化**: `/new-task <id> <slug>` で `task-<id>-<slug>.md` 生成 + list.md 行追加 (📝 既存 → 🔲 update、不在なら append)
+
+### plan-first 行先置きフロー (batch planning) — 2 経路分岐 (task-33 規範化、2026-05-25)
+
+| 経路 | 用途 | 手順 |
+|---|---|---|
+| **A (単発、default)** | hot fix / 1 機能 / 副産物 entry 由来 | 1 task ずつ draft 起案 → 承認 → `/new-task` で 1 行 append |
+| **B (batch planning)** | master roadmap で N 個 task を一括計画 (N ≥ 3) | (1) master roadmap §plan で N task 確定 + 承認 → (2) main が list.md に N 行 📝 先置き → (3) 個別 draft 起案 (subagent 並列可) → (4) `/new-task` で 📝 → 🔲 update |
+
+#### 経路 B 適用判定 (3 基準、OR)
+
+- master roadmap で **N ≥ 3 個 task 一括計画** (機械検出: SessionStart hook で `draft ≥ 3 ∧ task 行 == 0`)
+- 全 task 完了まで複数セッション跨る見込み (honor system)
+- task 間に強い順序依存 / Phase 区分 (honor system)
+
+#### 凡例 📝 の 2 用途
+
+| 用途 | 状態 |
+|---|---|
+| (1) draft 起案中 / user 承認待ち | 単発 task の `/new-task` 前中間状態 (経路 A) |
+| (2) batch plan 計画段階先置き | master roadmap 承認済 N task の list.md 先置き (経路 B) |
+
+両用途で `/new-task` 実行時に 🔲 に update。
+
+> **経路 B ID 払い出し / 重複検知 / Loop モード整合 / 機械検出 hook フィルタ順序注意 / 起源 (recall_poc plan-first 不在事案)**: [task-management/plan-first.md](../rules-details/task-management/plan-first.md)
+
+### テンプレート
+
+- `.claude/templates/docs/tasks/list.md` / `parking-lot.md` / `_TASK_TEMPLATE.md`
+- `.claude/templates/docs/draft/_DRAFT_TEMPLATE.md`
+
+### 自動生成のセーフティ
+
+- **冪等**: 既存 file は上書きしない (`/init-tasks --force` のみ例外)
+- **ID 重複検知**: `/new-task` は同 ID 既存で中断
+- **設計欠落検知**: `/new-task` は対応 draft 不在で中断 (`--no-draft` で hot fix 例外)
+- **fail-open**: SessionStart hook 失敗もセッション継続
+
+### Hook による強制 (PreToolUse、`task-rule-guard.sh`)
+
+> **preset aware (task-70 Phase 2)**: 下表の **BLOCK** は `feature_task_rule_guard_enabled` に依存する。team-default / strict preset では BLOCK、harness-dev preset (本 repo 採用) では advisory (緩和理由: ハーネス自身の task.md / list.md 編集を妨げないため、`enforcement_matrix.task_rule_guard.disabled_reason`)。現 effective 状態は `bash .claude/scripts/hc-config.sh --summary` 参照。
+
+| シナリオ | 動作 |
+|---|---|
+| `task-<id>-<slug>.md` Write、対応 draft 不在 | **BLOCK** |
+| `task-<id>-*.md` / `phase-<id>-*.md` Write、同 ID 既存 | **BLOCK** |
+| `docs/tasks/` 命名規約外 Write | 警告 context 注入 |
+| `task-*.md` Edit (既存編集) | 「list.md 同期更新せよ」context 注入 |
+| `parking-lot.md` Edit | 必須 7 項目の hint 注入 |
+| `list.md` / `_*_TEMPLATE.md` Edit/Write | exempt |
+| サブエージェント実行中 | 全パス通過 |
+
+### Bypass
+
+| 方法 | 用途 |
+|---|---|
+| `ECC_TASKGUARD=off` | セッション全体 OFF |
+| `/task-bypass <slug>` | 1 file 分 pre-clear |
+| `/task-bypass --clear-all` | 全 marker 削除 |
+
+> **Hook 検出仕様詳細 / subagent 通過理由 / 違反パターン例**: [task-management/hook-enforcement.md](../rules-details/task-management/hook-enforcement.md)
+
+## チェックリスト
+
+タスク追加時の確認:
+
+- [ ] `docs/draft/` に設計ドキュメントが存在するか
+- [ ] user 承認を得たか
+- [ ] `docs/tasks/list.md` の一覧テーブルを更新したか
+- [ ] 個別タスクファイルを作成したか
+- [ ] 設計ドキュメントへのリンクを含めたか
+- [ ] task ファイルが採用 6 条 (Task=Phase=N Step) に準拠しているか
+
+## 承認されていない設計
+
+未承認設計は `docs/draft/` に置く。承認済のみ `docs/tasks/` にリンク可。
+
+## Parking Lot（今後検討タスク）
+
+着手不可保留タスクは [`docs/tasks/parking-lot.md`](../../docs/tasks/parking-lot.md) で管理。
+
+- **追加条件**: 既存設計書 or `docs/draft/` 承認済設計へのリンク必須 (設計なし追加禁止)
+- **必須項目 7 つ**: 起案日 / 保留日 / 保留理由 / 設計書 / 実装状態 / 再検討トリガー / 代替現状
+- **status**: 🧊 保留 / 🔍 再検討予定 / ❌ 不採用
+- **移行**: 再検討トリガー成立時に `parking-lot.md` から削除 → `list.md` に新規 task 追加 (`/new-task`)
+- **定期レビュー**: 🔍 entry は四半期見直し
+- **不採用**: ❌ entry は削除せず履歴保持
+
+`list.md` 冒頭に parking-lot.md リンクを明記し、全タスク台帳として発見可能にする。
+
+> **必須 7 項目 format / 定期レビュー手順**: [task-management/parking-lot.md](../rules-details/task-management/parking-lot.md)
+
+## タスク管理の関連コマンド
+
+| コマンド | 役割 |
+|---|---|
+| `/init-tasks` | 台帳テンプレ初期化 (SessionStart 自動) |
+| `/new-draft <slug>` | 設計 draft 起こし |
+| `/new-task <id> <slug>` | タスク化 + list.md 行追加 |
+| `/start-task <id>` | 着手 (branch 切替 + status 同期) |
+| `/finish-task <id>` | 完了 (検証 + done 化 + commit 提案) |
+| `/task-bypass <slug>` | task-rule-guard 1 file 分 bypass |
+
+> **各規範の起源 / 採用経緯 (task-21 W1.7 / task-26 W4 / 採用 6 条 supersede 経緯 / plan-first 規範化)**: [task-management/origin.md](../rules-details/task-management/origin.md)
+
+---
+> **project 固有の追補・override は `.claude/project-rules/task-management.md` に書く** (本 file は harness 所有、`install.sh --update` で上書きされる。project 固有編集は下記 import 先へ)。
+@../project-rules/task-management.md