@takuma-hirai/hirai-method 0.1.0

package/.claude/settings.generated.preview.json

@@ -0,0 +1,211 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "$generated": {
+    "by": "generate-settings.sh",
+    "source": "harness-config.yml + .claude/hooks/dispatcher-manifest.tsv",
+    "note": "hooks block is generated; permissions block is manual (transcribed from live). Do not edit hooks by hand — edit the manifest + re-run generate-settings.sh."
+  },
+  "permissions": {
+    "deny": [
+      "Read(./.env)",
+      "Read(./.env.*)",
+      "Read(./**/.env)",
+      "Read(./**/.env.*)",
+      "Bash(rm -rf:*)",
+      "Bash(rm -rf /:*)",
+      "Bash(git push --force:*)",
+      "Bash(git push -f:*)",
+      "Bash(git reset --hard:*)",
+      "Bash(git branch -D:*)"
+    ],
+    "ask": [
+      "Bash(git push:*)",
+      "Edit(./CLAUDE.md)",
+      "Write(./CLAUDE.md)",
+      "Edit(./.claude/settings.json)",
+      "Write(./.claude/settings.json)",
+      "Edit(./.claude/rules/**)",
+      "Write(./.claude/rules/**)"
+    ],
+    "allow": [
+      "Edit(./.claude/mode.yml)",
+      "Write(./.claude/mode.yml)"
+    ]
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"Edit|Write\"",
+            "timeout": 5,
+            "statusMessage": "PreToolUse dispatcher (Edit|Write)"
+          }
+        ]
+      },
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"Read\"",
+            "timeout": 5,
+            "statusMessage": "PreToolUse dispatcher (Read)"
+          }
+        ]
+      },
+      {
+        "matcher": "Grep",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"Grep\"",
+            "timeout": 5,
+            "statusMessage": "PreToolUse dispatcher (Grep)"
+          }
+        ]
+      },
+      {
+        "matcher": "Glob",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"Glob\"",
+            "timeout": 5,
+            "statusMessage": "PreToolUse dispatcher (Glob)"
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"Bash\"",
+            "timeout": 5,
+            "statusMessage": "PreToolUse dispatcher (Bash)"
+          }
+        ]
+      },
+      {
+        "matcher": "Agent|Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"Agent|Task\"",
+            "timeout": 5,
+            "statusMessage": "PreToolUse dispatcher (Agent|Task)"
+          }
+        ]
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"*\"",
+            "timeout": 3,
+            "statusMessage": "PreToolUse dispatcher (*)"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Agent|Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/post-tool-use-dispatcher.sh \"Agent|Task\"",
+            "timeout": 5,
+            "statusMessage": "PostToolUse dispatcher (Agent|Task)"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/post-tool-use-dispatcher.sh \"Edit|Write\"",
+            "timeout": 90,
+            "statusMessage": "PostToolUse dispatcher (Edit|Write)"
+          }
+        ]
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/post-tool-use-dispatcher.sh \"*\"",
+            "timeout": 3,
+            "statusMessage": "PostToolUse dispatcher (*)"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/notification-dispatcher.sh",
+            "timeout": 5,
+            "statusMessage": "Notification dispatcher (*)"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/stop-dispatcher.sh",
+            "timeout": 5,
+            "statusMessage": "Stop dispatcher (*)"
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/subagent-stop-dispatcher.sh",
+            "timeout": 10,
+            "statusMessage": "SubagentStop dispatcher (*)"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/session-start-dispatcher.sh",
+            "timeout": 15,
+            "statusMessage": "SessionStart dispatcher (*)"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/user-prompt-submit-dispatcher.sh",
+            "timeout": 5,
+            "statusMessage": "UserPromptSubmit dispatcher (*)"
+          }
+        ]
+      }
+    ]
+  }
+}

package/.claude/settings.json

@@ -0,0 +1,215 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "$generated": {
+    "by": "generate-settings.sh",
+    "source": "harness-config.yml + .claude/hooks/dispatcher-manifest.tsv",
+    "note": "hooks block is generated; permissions block is manual (transcribed from live). Do not edit hooks by hand — edit the manifest + re-run generate-settings.sh."
+  },
+  "permissions": {
+    "deny": [
+      "Read(./.env)",
+      "Read(./.env.*)",
+      "Read(./**/.env)",
+      "Read(./**/.env.*)",
+      "Bash(rm -rf:*)",
+      "Bash(rm -rf /:*)",
+      "Bash(git push --force:*)",
+      "Bash(git push -f:*)",
+      "Bash(git reset --hard:*)",
+      "Bash(git branch -D:*)"
+    ],
+    "ask": [
+      "Bash(git push:*)",
+      "Edit(./CLAUDE.md)",
+      "Write(./CLAUDE.md)",
+      "Edit(./.claude/settings.json)",
+      "Write(./.claude/settings.json)",
+      "Edit(./.claude/rules/**)",
+      "Write(./.claude/rules/**)"
+    ],
+    "allow": [
+      "Edit(./.claude/mode.yml)",
+      "Write(./.claude/mode.yml)"
+    ]
+  },
+  "statusLine": {
+    "type": "command",
+    "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/scripts/statusline.sh"
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"Edit|Write\"",
+            "timeout": 5,
+            "statusMessage": "PreToolUse dispatcher (Edit|Write)"
+          }
+        ]
+      },
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"Read\"",
+            "timeout": 5,
+            "statusMessage": "PreToolUse dispatcher (Read)"
+          }
+        ]
+      },
+      {
+        "matcher": "Grep",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"Grep\"",
+            "timeout": 5,
+            "statusMessage": "PreToolUse dispatcher (Grep)"
+          }
+        ]
+      },
+      {
+        "matcher": "Glob",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"Glob\"",
+            "timeout": 5,
+            "statusMessage": "PreToolUse dispatcher (Glob)"
+          }
+        ]
+      },
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"Bash\"",
+            "timeout": 5,
+            "statusMessage": "PreToolUse dispatcher (Bash)"
+          }
+        ]
+      },
+      {
+        "matcher": "Agent|Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"Agent|Task\"",
+            "timeout": 5,
+            "statusMessage": "PreToolUse dispatcher (Agent|Task)"
+          }
+        ]
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/pre-tool-use-dispatcher.sh \"*\"",
+            "timeout": 3,
+            "statusMessage": "PreToolUse dispatcher (*)"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Agent|Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/post-tool-use-dispatcher.sh \"Agent|Task\"",
+            "timeout": 5,
+            "statusMessage": "PostToolUse dispatcher (Agent|Task)"
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/post-tool-use-dispatcher.sh \"Edit|Write\"",
+            "timeout": 90,
+            "statusMessage": "PostToolUse dispatcher (Edit|Write)"
+          }
+        ]
+      },
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/post-tool-use-dispatcher.sh \"*\"",
+            "timeout": 3,
+            "statusMessage": "PostToolUse dispatcher (*)"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/notification-dispatcher.sh",
+            "timeout": 5,
+            "statusMessage": "Notification dispatcher (*)"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/stop-dispatcher.sh",
+            "timeout": 5,
+            "statusMessage": "Stop dispatcher (*)"
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/subagent-stop-dispatcher.sh",
+            "timeout": 10,
+            "statusMessage": "SubagentStop dispatcher (*)"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/session-start-dispatcher.sh",
+            "timeout": 15,
+            "statusMessage": "SessionStart dispatcher (*)"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PROJECT_DIR}/.claude/hooks/user-prompt-submit-dispatcher.sh",
+            "timeout": 5,
+            "statusMessage": "UserPromptSubmit dispatcher (*)"
+          }
+        ]
+      }
+    ]
+  }
+}

package/.claude/settings.local.example.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "_comment": "Template for .claude/settings.local.json. Copy this file to settings.local.json and fill in real secrets. settings.local.json is gitignored. Required env keys are referenced by .mcp.json (GITHUB_PAT / ASANA_PAT / SLACK_MCP_XOXP_TOKEN / SLACK_MCP_ADD_MESSAGE_TOOL). Other keys are optional, used by additional MCP servers or tooling.",
+  "env": {
+    "GITHUB_PAT": "ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+    "SLACK_MCP_XOXB_TOKEN": "xoxb-xxxxxxxxxxxx-xxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx",
+    "SLACK_MCP_XOXP_TOKEN": "xoxp-xxxxxxxxxxxx-xxxxxxxxxxxx-xxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+    "SLACK_MCP_CHANNEL_ID": "C0XXXXXXXXX",
+    "SLACK_MCP_ADD_MESSAGE_TOOL": "true",
+    "SALESFORCE_CONNECTION_TYPE": "User_Password",
+    "SALESFORCE_USERNAME": "you@example.com",
+    "SALESFORCE_PASSWORD": "REPLACE_WITH_PASSWORD",
+    "SALESFORCE_TOKEN": "REPLACE_WITH_SECURITY_TOKEN",
+    "SALESFORCE_INSTANCE_URL": "https://login.salesforce.com",
+    "ASANA_PAT": "1/xxxxxxxxxxxxxxxx:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+  },
+  "permissions": {
+    "allow": []
+  }
+}

package/.claude/settings.local.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json.schemastore.org/claude-code-settings.json",
+  "env": {
+    "GITHUB_PAT": "",
+    "SLACK_MCP_XOXB_TOKEN": "",
+    "SLACK_MCP_XOXP_TOKEN": "",
+    "SLACK_MCP_CHANNEL_ID": "",
+    "SLACK_MCP_ADD_MESSAGE_TOOL": "",
+    "SALESFORCE_CONNECTION_TYPE": "User_Password",
+    "SALESFORCE_USERNAME": "",
+    "SALESFORCE_PASSWORD": "",
+    "SALESFORCE_TOKEN": "",
+    "SALESFORCE_INSTANCE_URL": "https://login.salesforce.com",
+    "ASANA_PAT": ""
+  },
+  "permissions": {
+    "allow": [
+      "Bash",
+      "Edit",
+      "Write",
+      "Bash(HC_MODE=loop bash .claude/hooks/context-budget.sh)",
+      "Bash(echo \"EXIT=$?\")",
+      "Bash(mkdir -p /Users/t.hirai/work/hirai-method/.claude/.confidence-gate-state)",
+      "Bash(touch /Users/t.hirai/work/hirai-method/.claude/.confidence-gate-state/bypass.marker)",
+      "Bash(rm -f /Users/t.hirai/work/hirai-method/.claude/.confidence-gate-state/bypass.marker)",
+      "Bash(echo \"smoke test transcript flush timing — subagent reply not in snapshot\")",
+      "Bash(git add *)",
+      "Bash(git commit *)",
+      "Bash(gh pr *)",
+      "Bash(git push:*)",
+      "Bash(mkdir -p /Users/t.hirai/work/hirai-method/.claude/.taskguard-state)",
+      "Bash(touch /Users/t.hirai/work/hirai-method/.claude/.taskguard-state/list-md-plan-first-normative-rules.cleared /Users/t.hirai/work/hirai-method/.claude/.taskguard-state/list-md-plan-first-new-task-update.cleared /Users/t.hirai/work/hirai-method/.claude/.taskguard-state/list-md-plan-first-session-hook.cleared /Users/t.hirai/work/hirai-method/.claude/.taskguard-state/list-md-plan-first-draft-warn.cleared /Users/t.hirai/work/hirai-method/.claude/.taskguard-state/list-md-plan-first-integration.cleared)",
+      "Bash(git branch *)"
+    ]
+  }
+}

package/.claude/skills/agent-introspection-debugging/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: agent-introspection-debugging
+description: Structured self-debugging workflow for AI agent failures using 4-phase capture / diagnose / recover / report loop. Replicated from ECC.
+origin: ECC
+---
+
+# Agent Introspection Debugging — 自己改善 L5
+
+Claude セッションが失敗を繰り返す・ループする・ドリフトするときに **盲目リトライではなく系統的に自己診断** するワークフロー。
+
+## When to Activate
+
+- 最大ツール呼び出し / ループ制限到達
+- 同コマンド3回連続失敗
+- context 肥大で出力品質が劣化
+- ファイルシステム/環境状態が期待と乖離
+- 復旧可能と思われるツール失敗
+
+## Scope Boundaries
+
+**使う場面**:
+- 失敗状態を捕捉してから retry する
+- 既知失敗パターンとの照合
+- 含意の小さい復旧アクション
+- 人間向け debug report 生成
+
+**使わない場面**:
+- コード変更後の機能検証 → `verification-loop`
+- フレームワーク固有の debug → 専用スキル
+
+## Four-Phase Loop
+
+### Phase 1: Failure Capture
+
+```markdown
+## Failure Capture
+- Session / task:
+- Goal in progress:
+- Error:
+- Last successful step:
+- Last failed tool / command:
+- Repeated pattern seen:
+- Environment assumptions to verify:
+```
+
+### Phase 2: Root-Cause Diagnosis
+
+| パターン | 推定原因 | 検査 |
+|---|---|---|
+| 最大ツール呼出 / 同コマンド連発 | ループ・無出口観察パス | 直近 N tool call の繰返検査 |
+| Context overflow / 推論劣化 | 無制限ノート・重複プラン | 重複・低信号の混入確認 |
+| `ECONNREFUSED` / timeout | サービス断・ポート違い | service health / URL / port |
+| `429` / quota 枯渇 | retry storm・backoff 欠如 | 連続呼出回数・retry 間隔 |
+| 書込後ファイル消失 | race / cwd違い / branch ドリフト | path 再確認・git status |
+| "fix"後もテスト失敗 | 仮説違い | 失敗テスト 1 つに絞り再導出 |
+
+**診断質問**:
+- これは logic / state / environment / policy のどの失敗？
+- agent は本来の目的を見失って違うサブタスクを最適化している？
+- 決定的か transient か？
+- 仮説を検証する **最小可逆アクション** は何か？
+
+### Phase 3: Contained Recovery
+
+```markdown
+## Recovery Action
+- Diagnosis chosen:
+- Smallest action taken:
+- Why this is safe:
+- What evidence would prove the fix worked:
+```
+
+**安全な復旧アクション**:
+- リトライを止めて仮説を再記述
+- 低信号 context をトリミング
+- 実ファイルシステム / branch / process を直接観察
+- タスクを 1 つの failing command に絞る
+- 推測でなく直接観察に切り替え
+- リスクが高ければ人間にエスカレーション
+
+### Phase 4: Introspection Report
+
+```markdown
+## Agent Self-Debug Report
+- Session / task:
+- Failure:
+- Root cause:
+- Recovery action:
+- Result: success | partial | blocked
+- Token / time burn risk:
+- Follow-up needed:
+- Preventive change to encode later:  ← L4 instinct 候補へ
+```
+
+## Recovery Heuristics（優先順）
+
+1. 真の目的を 1 文で再定義
+2. メモリではなく現実状態を確認
+3. 失敗範囲を縮小
+4. 1 つだけ判別検査
+5. 検査が仮説を支持したときのみリトライ
+
+> ❌ 同じアクションを微妙な言い換えで 3 回試す
+> ✅ capture → 分類 → 1 つだけ直接検査 → 検査が支持したら計画変更
+
+## Integration
+
+- 復旧後に `verification-loop` でコード変更を検証
+- 失敗パターンが instinct 化価値あれば `continuous-learning-v2` へ送る
+- 技術ではなく決定の曖昧さなら `council`
+- ローカル状態の競合なら `workspace-surface-audit`
+
+## Output Standard
+
+「直しました」だけで終わらない。必ず以下を提示:
+- failure pattern
+- root-cause hypothesis
+- recovery action
+- 状況改善 / 依然ブロック の証拠
+
+## Slash command
+
+`/agent-introspect` — 上記 4 フェーズをガイドする