@takuma-hirai/hirai-method 0.1.0

package/.claude/commands/new-task.md

@@ -0,0 +1,156 @@
+---
+description: 承認済 draft からタスクファイルを生成し、list.md に行を追加する。設計→承認→タスク化フローの最終ステップ。
+---
+
+# /new-task — 新規タスクファイル作成
+
+`docs/draft/<slug>.md` の承認済設計から `docs/tasks/task-<id>-<slug>.md` を起こし、`docs/tasks/list.md` に新規行を追加する。
+
+## 前提
+
+**設計→承認→タスク追加フロー**（rules/development-process.md）を厳守:
+1. `docs/draft/<slug>.md` を `_DRAFT_TEMPLATE.md` から起こす
+2. user に承認を得る
+3. **このコマンド**で task ファイルを生成 + list.md 行追加
+
+設計が無い状態でこのコマンドは使わない（hook が block する）。
+
+## 使い方
+
+```
+/new-task <id> <slug>                              # 既定: phase 推定 / 依存自動解析
+/new-task <id> <slug> --phase "Phase 11"           # phase 明示
+/new-task <id> <slug> --depends "#33,#38"          # 依存明示
+/new-task <id> <slug> --draft docs/draft/foo.md    # 設計 draft 明示指定
+/new-task <id> <slug> --no-draft                   # 設計なしで作成（hot fix 等の例外、要 user 承認）
+```
+
+## 引数
+
+- `<id>` — タスク番号（連番、または "11.3a" 形式の sub-id 可）
+- `<slug>` — kebab-case の短縮名（例: `link-card-componentize`）
+
+## 動作
+
+### Phase 1: 前提チェック
+
+1. `docs/draft/<slug>.md` の存在 + ステータスが「承認済」か確認
+2. 既存 `docs/tasks/task-<id>-*.md` が無いことを確認（衝突回避）
+3. `docs/tasks/list.md` 既存 📝 行 (**同 ID かつ 同 slug の AND 一致**、ID 単独 / slug 単独 grep 禁止) を検出:
+   - **既存あり (📝 status)** → update mode (Phase 3 で 📝 → 🔲 update、新規行 append しない)
+   - **不在** → append mode (Phase 3 で新規行 append、経路 A default 動作)
+   - **同 ID で 📝 以外 status (🔲 / 🔄 / ✅) 既存** → **BLOCK** (重複 ID 修正案内: 別 ID を払い出すか既存 task を Edit せよ)
+   - **複数マッチ (同 ID + 同 slug で 2 行以上 hit)** → **BLOCK** (list.md の行重複を user が手動修正してから再実行)
+
+### Phase 2: テンプレ展開
+
+1. `.claude/templates/docs/tasks/_TASK_TEMPLATE.md` をコピー
+2. プレースホルダ置換:
+   - `<ID>` → タスク番号
+   - `<タスク名>` → draft の H1 タイトル
+   - 起案日 → 今日
+   - 設計起源 → draft への相対リンク
+
+### Phase 3: list.md 📝 行 update or append
+
+`task-management.md` §「plan-first 行先置きフロー (batch planning) — 2 経路分岐」に従って 2 mode 分岐 (Phase 1 step 3 で判定済の mode に従う):
+
+#### update mode (経路 B、batch planning 中間状態): 既存 📝 行を 🔲 に書き換え
+
+`list.md` に **同 ID + 同 slug の AND 一致 📝 行** が既存なら status のみ更新 (行重複なし、新規行 append しない):
+
+旧行:
+```markdown
+| <id> | 📝 | <Phase> | <概要> | <依存> | [task-<id>-<slug>.md](task-<id>-<slug>.md) |
+```
+
+新行:
+```markdown
+| <id> | 🔲 | <Phase> | <概要> | <依存> | [task-<id>-<slug>.md](task-<id>-<slug>.md) |
+```
+
+`📝` を `🔲` に置換、他列維持。`<Phase>` / `<概要>` / `<依存>` は draft の最新情報で更新可 (batch planning 起案時点から内容が進化している場合)。
+
+#### append mode (経路 A、単発 default): 新規行 append
+
+`list.md` 同 ID 不在 (Phase 1 step 3 判定) なら末尾に新規行 append:
+
+```markdown
+| <id> | 🔲 | <Phase> | <概要> | <依存> | [task-<id>-<slug>.md](task-<id>-<slug>.md) |
+```
+
+`<概要>` は draft の「真因サマリ」または「目的」から 1 行抽出。
+
+#### 実装 helper (task-34 Step 2 で実装、iter3 で parallel race 等修正)
+
+helper script: `.claude/scripts/new-task-helper.sh` の `update_or_append_task_row()` 関数 (subshell 関数化 / kebab-word boundary 照合 / atomic-mkdir lock 内蔵)。
+
+CLI 呼出 (経路 A / B 共通):
+
+```bash
+bash .claude/scripts/new-task-helper.sh update_or_append_task_row <id> <slug> <row_content> [<list_md>]
+```
+
+引数:
+- `<id>` — タスク ID (非負整数、leading zero は `printf '%d'` で正規化、**18 桁上限** = signed 64-bit overflow 防止 / 規範 §plan-first 経路 B では ID 払い出し時 `next_id=$((${max:-0} + 1))` で 1 始まり連番のため実用上 18 桁に到達しない)
+- `<slug>` — kebab-case slug (英数字 + `-` のみ)
+- `<row_content>` — 完成済 list.md 行 (`| <id> | 🔲 | ... |`、**改行 `\n` / `\r` 不可** = input validation で reject、CR-only / CRLF も検出)
+- `<list_md>` — optional、既定は `${HC_TASK_DIR:-docs/tasks}/list.md`
+
+動作 (Phase 1 step 3 判定と整合):
+1. id 数値正規化 + non-negative integer validation (非数値 / leading zero / 改行 row_content は exit 2 = system-level error)
+2. atomic-mkdir lock 取得 (`<list_md>.lock.d`、最大 100 retries × 50ms = 5 秒、timeout で exit 2)
+3. `^\| <id> \|` で同 ID 行を取得、`(^|[^a-zA-Z0-9-])<slug>([^a-zA-Z0-9-]|$)` (kebab-word boundary) で同 slug 判定
+4. 同 ID + 別 slug + 📝 既存 → BLOCK 「誤連番」(exit 1)
+5. 同 ID + 同 slug + 📝 以外 (🔲/🔄/✅) → BLOCK 「重複起動 / 完了済 task の上書き」(exit 1)
+6. 同 ID + 同 slug + 📝 単数 → status 列のみ 🔲 へ書換 (update mode、行数増えず)
+7. 同 ID + 同 slug + 📝 複数 → BLOCK 「list.md 行重複、user 手動修正必須」(exit 1)
+8. 同 ID 不在 → 末尾 append (append mode、`_new_task_ensure_eol` で末尾改行担保)
+
+exit code 仕様 (caller の error path 設計に必須):
+- `0` — 成功 (update / append いずれか)
+- `1` — data-level BLOCK (誤連番 / 重複起動 / 行重複)
+- `2` — system-level error (引数不正 / lock timeout / mktemp 失敗 / 改行 row_content)
+
+caller 責務 (`/new-task` command 内で本 helper を呼ぶ Bash script):
+- `HC_TASK_DIR` を本 helper に伝える必要がある場合は、caller 側で `.claude/hooks/lib/config-loader.sh` を source して `HC_TASK_DIR` を export してから helper を呼ぶ
+- helper 自身は `config-loader.sh` を source せず env fallback (`${HC_TASK_DIR:-docs/tasks}`) のみ実装、CLI 単独実行 (smoke test) と caller 経由実行の両用途に対応 (Design Constraints 遵守)
+
+並列実行安全性 (task-34 iter3 で確保):
+- atomic-mkdir lock により subagent 並列 `/new-task` 実行時の race condition を防止
+- iter2 では 3 並列で 10/10 race 再現 → iter3 lock 実装で 0/10 race 達成
+- bash-whitelist 登録: `^bash \.claude/scripts/new-task-helper\.sh( |$)` (`.claude/bash-whitelist.txt`)
+
+### Phase 4: draft の取り扱い
+
+- draft は `docs/draft/<slug>.md` に **残す**（設計履歴として）
+- task ファイルから「設計起源」リンクで参照
+
+### Phase 5: 承認確認 + 着手提案
+
+```
+✅ Task #<id> 起こしました。
+  - docs/tasks/task-<id>-<slug>.md
+  - docs/tasks/list.md に行追加 (🔲 未着手)
+
+次の操作:
+  /start-task <id>     ← 着手するなら
+  /finish-task         ← この task は不要なら delete + parking-lot へ
+```
+
+## 制約
+
+- **設計なし起こしは原則禁止**（`--no-draft` は hot fix 等で user 承認下のみ）
+- **ID + slug AND 一致 📝 行が既存 → update mode** (経路 B、batch planning)、**不在 → append mode** (経路 A、単発 default)
+- **同 ID + 別 slug 既存** → BLOCK (重複 ID 修正案内、別 ID 払い出し or 既存 task Edit 要)
+- **同 ID + 同 slug で 📝 以外 status (🔲 / 🔄 / ✅) 既存** → BLOCK (既存 task 進行中の可能性)
+- **複数マッチ (同 ID + 同 slug で 2 行以上 hit)** → BLOCK (list.md の行重複を user 手動修正必須)
+- list.md と個別ファイルを **必ず同時更新**
+- 規範参照: [`.claude/rules/task-management.md` §「plan-first 行先置きフロー (batch planning) — 2 経路分岐」](../rules/task-management.md#plan-first-行先置きフロー-batch-planning--2-経路分岐)
+
+## 関連
+
+- `/init-tasks` — テンプレ初期化
+- `/start-task <id>` — 着手フロー
+- `/new-draft <slug>` — 設計 draft 起こし（このコマンドの前段）
+- rule: `.claude/rules/development-process.md`

package/.claude/commands/notification.md

@@ -0,0 +1,107 @@
+---
+name: notification
+description: "通知送信 - Slack/Asanaへ通知を送信"
+category: skill
+complexity: basic
+model: haiku
+mcp-servers: [asana, slack]
+---
+
+# /notification - 通知送信スキル
+
+## 概要
+
+Slack・Asanaへ通知を送信するヘルパースキル。
+各コマンドから内部的に呼び出されます。
+
+## 使用方法
+
+```
+/notification [通知タイプ] [宛先] [メッセージ]
+```
+
+例:
+```
+/notification approval 平井 "設計承認をお願いします"
+/notification review engineer "PRレビューをお願いします"
+/notification complete all "タスクが完了しました"
+```
+
+## 通知タイプ
+
+| タイプ | 説明 | 送信先 |
+|--------|------|--------|
+| `approval` | 承認依頼 | Slack + Asana |
+| `review` | レビュー依頼 | Slack + GitHub |
+| `complete` | 完了通知 | Slack |
+| `progress` | 進捗報告 | Asana |
+| `alert` | 警告・問題報告 | Slack |
+
+## 通知テンプレート
+
+### 承認依頼 (approval)
+
+```
+:memo: 【承認依頼】{タスク名}
+
+設計書の承認をお願いします。
+
+- タスク: {Asana URL}
+- PR: {GitHub PR URL}
+- 工数: {合計工数}
+
+確認後、承認または修正依頼をお願いします。
+```
+
+### レビュー依頼 (review)
+
+```
+:eyes: 【レビュー依頼】{タスク名}
+
+コードレビューをお願いします。
+
+- PR: {GitHub PR URL}
+- 変更ファイル: {ファイル数}
+
+レビュー観点:
+- ガバナ制限
+- バルク処理対応
+- セキュリティ
+```
+
+### 完了通知 (complete)
+
+```
+:white_check_mark: 【完了】{タスク名}
+
+タスクが完了しました。
+
+- PR: {GitHub PR URL} (マージ済み)
+- Asana: {Asana URL}
+
+お疲れ様でした！
+```
+
+## MCP連携
+
+| MCP | 用途 |
+|-----|------|
+| `slack` | Slack通知送信 |
+| `asana` | Asanaコメント追加、タスク更新 |
+
+## 送信先解決
+
+| 宛先キーワード | 実際の送信先 |
+|---------------|-------------|
+| `平井` | 平井さんのSlack DM |
+| `engineer` | 担当エンジニア |
+| `requester` | 依頼者 |
+| `all` | 関連者全員 |
+| `channel` | プロジェクトチャンネル |
+
+## 注意事項
+
+- 通知は適切なタイミングで送信
+- 重複通知を避ける
+- 緊急度に応じてメンション方法を調整
+- 営業時間外の通知は控える（設定可能）

package/.claude/commands/pm-start.md

@@ -0,0 +1,119 @@
+# /pm-start — PM Agent orchestration with Serena memory
+
+PM Agent (Project Manager) として user request を分析、適切な subagent に委譲し、PDCA cycle 全段階で Serena memory に永続化する自前コマンド。SuperClaude `/sc:pm` の後継。Serena MCP 必須。
+
+## 前提
+
+- **Serena MCP が `.mcp.json` に登録され、`mcp__serena__*` tool が利用可能であること**
+- 命名衝突回避: 既存 `orchestrate` (Legacy slash-entry shim) との shadow を避けるため `/pm-start` を採用
+- session 中断耐性 (`/save-state` / `/resume-state`) と相補関係
+
+## 動作
+
+このコマンドが呼ばれたら、メインエージェントは以下の手順を順次実行してください。
+
+### Phase 1: Session Start Protocol (auto-restore)
+
+新規 session 開始 / `/pm-start` 初回呼出時、`/resume-state` 相当の auto-restore を内包:
+
+1. `mcp__serena__activate_project` (引数 = current project name)
+   - 戻り値が success: 続行 (onboarding 済 + project 登録済を意味する)
+   - 戻り値が error で `onboarding` / `not performed` を含む: 「Serena MCP onboarding が未完了です。`/onboarding` で完了させてください。」+ 終了
+   - その他 error: warning 出力 + Phase 2 へ続行 (新規 session 扱い)
+2. `mcp__serena__list_memories` で全 key 取得
+
+> **設計補足**: 旧版では `mcp__serena__check_onboarding_performed` を呼んでいたが、現 Serena MCP には該当 tool が存在しない (2026-05-23 確認、deferred tools list にも無し)。代わりに `activate_project` の error response で onboarding 未済を検知する。
+3. `session/context` が存在すれば:
+   - `read_memory("session/context")` で完全 snapshot 復元
+   - `read_memory("session/last")` で last summary
+   - 復元レポートを user に提示 (`/resume-state` Phase 4 と同 format):
+     - 📋 前回 (Last session) / 📊 進捗 / 🎯 次回 / ⚠️ 課題
+4. `session/context` 不在なら新規 session として開始 (Phase 2 へ)
+
+### Phase 2: User request analysis
+
+user の最新 prompt から request の本質を抽出:
+
+1. **request type 判定**:
+   - **brainstorm**: 「〇〇について検討」「アイディアを出して」等の発散思考 → Socratic 対話モード
+   - **direct**: 「〇〇を実装」「修正して」等の明確タスク → 即実行
+   - **multi-agent**: 複数領域横断 (frontend + backend + DB 等) → parallel subagent
+   - **wave**: 大規模機能 (W1-Wn の段階実装) → sequential subagent + 各 Wave 検証
+2. **複雑度判定** (0-100):
+   - 影響ファイル数 / 設計判断点数 / セキュリティ影響 / migration 有無 をスコア化
+   - 50 以上なら draft → 承認 → `/new-task` フローを推奨
+3. **TaskCreate** で全 sub-task を登録 (依存関係を `addBlockedBy` で明示)
+
+### Phase 3: Subagent delegation
+
+選択した request type に基づき subagent 起動:
+
+1. Agent tool で subagent を起動 (`run_in_background: true` 必須 — `.claude/rules/modes.md` 遵守事項 7)
+2. 並列可能なら独立 task を同 turn で複数 subagent 起動
+3. 依存関係ある task は完了通知後に次 subagent 起動
+4. メインは subagent 待ち中も独立作業を継続 (loop-auto-progress-reminder hook の規範遵守)
+
+### Phase 4: PDCA cycle (continuous)
+
+作業進行に応じて 4 段階で Serena memory を更新:
+
+1. **Plan (仮説形成)**:
+   - `mcp__serena__write_memory("plan/<feature>/hypothesis", <仮説>)` で目的 + 期待結果 + リスク
+   - 例: `plan/auth/hypothesis` = "JWT validation を middleware に追加。期待: 全 protected route で 401 統一"
+2. **Do (実装・試行錯誤)**:
+   - `mcp__serena__write_memory("execution/<feature>/do", <試行ログ>)` で実装ステップ + error + 解決
+   - root cause first 原則: error は必ず investigate (context7 / WebFetch / Grep) してから fix
+   - 同じ failure を盲目 retry しない
+3. **Check (評価)**:
+   - `mcp__serena__write_memory("evaluation/<feature>/check", <評価>)` で test 結果 + 期待 vs 実測
+   - `think_about_task_adherence` 相当の自己評価
+4. **Act (改善・教訓)**:
+   - 成功 pattern → `mcp__serena__write_memory("learning/patterns/<name>", <pattern>)`
+   - error 解決 → `mcp__serena__write_memory("learning/solutions/<error_type>", <solution>)`
+   - 失敗 case → `mcp__serena__write_memory("learning/mistakes/<timestamp>", <分析>)`
+   - 教訓は CLAUDE.md Critical Operational Lessons / `feedback_*.md` memory にも転載
+
+### Phase 5: Session End
+
+session 終了が予見される (`/save-state` 明示呼出 / context budget 警告 / user 中断指示) 時:
+
+1. `/save-state` を自動呼出 (Phase 1-6 順次実行)
+2. user に再開手順を案内:
+   ```
+   ✅ Session ended. State saved to Serena memory.
+   Resume with `/pm-start` (auto-restore) or `/resume-state` (manual) in next session.
+   ```
+
+## 引数
+
+- `<user-request>` (option): request text を直接渡す。省略時は最新 user prompt を analysis 対象とする
+- `--no-restore`: Phase 1 を skip (新規 session 強制)
+- `--mode <brainstorm|direct|multi-agent|wave>`: Phase 2 request type 判定を override
+
+## エラーハンドリング
+
+| 状況 | 動作 |
+|---|---|
+| Serena MCP 未注入 | Phase 1 で停止 + 案内 |
+| onboarding 未済 | 同上 |
+| `session/context` 復元失敗 | Phase 1 で warning + 新規 session として続行 |
+| subagent 起動失敗 | Phase 3 で再試行 (1 回)、失敗継続なら user 報告 |
+| PDCA `write_memory` fail | warning + cycle 続行 (memory なし状態の継続実行) |
+
+## 関連
+
+- `/save-state` — session 状態保存 (Phase 5 で auto-invoke)
+- `/resume-state` — session 復元 (Phase 1 で auto-invoke 相当)
+- `.claude/hooks/mode-session-start.sh` — SessionStart 時に `/pm-start` 起動を suggesting (W2)
+- `.claude/rules/modes.md` 遵守事項 7 (subagent 並走中の独立作業義務)
+- Memory key schema:
+  - `session/context` / `session/last` / `session/checkpoint` (session 永続化)
+  - `plan/<feature>/{hypothesis,architecture,rationale}` (Plan)
+  - `execution/<feature>/{do,errors,solutions}` (Do)
+  - `evaluation/<feature>/{check,metrics,lessons}` (Check)
+  - `learning/{patterns,solutions,mistakes}/<name>` (Act, 横断的)
+  - `project/{context,architecture,conventions}` (project 全体理解)
+
+## 設計起源
+
+`docs/draft/custom-pm-commands.md` §3 W1 + `docs/tasks/task-7-custom-pm-commands.md` §設計 W1 (採用プロジェクト側で詳細参照)

package/.claude/commands/projects.md

@@ -0,0 +1,32 @@
+---
+description: List all known projects observed by continuous-learning-v2 with their instinct counts.
+---
+
+# /projects
+
+このマシン上で observe された全プロジェクトと、各プロジェクトの instinct 数・最終観察日時を一覧。
+
+## 使い方
+
+```
+/projects
+```
+
+## 動作
+
+`python3 .claude/skills/continuous-learning-v2/instinct-cli.py projects` を実行。
+
+## 出力例
+
+```
+HASH           NAME                           INSTINCTS  LAST_SEEN
+--------------------------------------------------------------------------------
+a1b2c3d4e5f6   my-app                                12  2026-05-04T10:32:00Z
+e5d4c3b2a1f6   infra-deploy                           3  2026-05-04T09:15:00Z
+123456789abc   scratch                                7  2026-05-03T18:22:00Z
+```
+
+## 関連
+
+- `/instinct-status` — 全 instinct
+- `/promote` — project → global

package/.claude/commands/promote.md

@@ -0,0 +1,43 @@
+---
+description: Promote project-scoped instincts to global when seen in 2+ projects with avg confidence ≥0.8.
+---
+
+# /promote
+
+project-scoped instinct を global へ昇格させる。
+
+## 使い方
+
+```
+/promote               # 全候補を一括昇格
+/promote <id>          # 特定 ID のみ
+/promote --dry-run     # 候補一覧のみ（書き込まない）
+```
+
+## 自動候補条件
+
+- 同じ instinct ID が **2+ プロジェクト** で観察されている
+- 平均 confidence **≥ 0.8**
+
+## 動作
+
+1. `python3 .claude/skills/continuous-learning-v2/instinct-cli.py promote [target] [--dry-run]` を実行
+2. 候補を提示
+3. （`--dry-run` でなければ）最高 confidence の instinct を `~/.claude/homunculus/instincts/personal/` へコピー
+4. scope を `global` に書き換え、project_id/project_name を除去
+
+## 出力例
+
+```
+=== Promotion Candidates (2) ===
+
+  prefer-explicit-errors  avg=0.85  projects=3
+    → promoted to ~/.claude/homunculus/instincts/personal/prefer-explicit-errors.md
+  always-test-edge-cases  avg=0.82  projects=2
+    → promoted to ~/.claude/homunculus/instincts/personal/always-test-edge-cases.md
+```
+
+## 関連
+
+- `/projects` — どのプロジェクトに何があるか
+- `/instinct-status`