@takuma-hirai/hirai-method 0.1.0

package/.claude/commands/resume-state.md

@@ -0,0 +1,187 @@
+# /resume-state — Resume previous session from Serena memory
+
+前セッションの状態を Serena MCP の memory から復元する自前コマンド。SuperClaude `/sc:load` の後継。Serena MCP 必須。
+
+## 前提
+
+- **Serena MCP が `.mcp.json` に登録され、`mcp__serena__*` tool が利用可能であること**
+- 前セッションで `/save-state` が実行され、`session/context` 等の memory key が存在すること
+- 未注入時 / memory 不在時は graceful error で終了
+
+## 動作
+
+このコマンドが呼ばれたら、メインエージェントは以下の手順を順次実行してください。
+
+### Phase 1: Project activation & onboarding check (必須、統合)
+
+1. `mcp__serena__activate_project` (引数 = current project name)
+   - 戻り値が success: 続行 (onboarding 済 + project 登録済を意味する)
+   - 戻り値が error: 内容に応じて分岐:
+     - `onboarding` / `not performed` を含む → error message: 「Serena MCP onboarding が未完了です。`/onboarding` 等で完了させてから再実行してください。」+ 終了
+     - その他 (project 不在等) → error message: 「現プロジェクトが Serena に未登録です。`/save-state` でまず保存してください。」+ 終了
+
+> **設計補足**: 旧版では `mcp__serena__check_onboarding_performed` を Phase 1 で呼んでいたが、現 Serena MCP には該当 tool が存在しない (2026-05-23 確認、deferred tools list にも無し)。代わりに `activate_project` の error response で onboarding 未済 / project 未登録を一括検知する。
+
+### Phase 2: Memory enumeration
+
+1. `mcp__serena__list_memories` で全 key 取得
+2. 期待 key カテゴリ (PM Agent spec 準拠):
+   - `session/context` (必須)
+   - `session/last` (推奨)
+   - `session/checkpoint` (option)
+   - `plan/*` (PDCA Plan 進行中なら)
+   - `execution/*` / `evaluation/*` / `learning/*` (進行中の cycle あれば)
+   - `project/*` (project 全体理解)
+3. `session/context` が不在なら error: 「前 session の memory が見つかりません。新規セッションとして開始してください。」+ 終了
+
+### Phase 3: Sequential restore
+
+1. `mcp__serena__read_memory("session/context")` で完全 snapshot 復元
+2. `mcp__serena__read_memory("session/last")` で last summary
+3. `mcp__serena__read_memory("session/checkpoint")` で進捗 (存在時のみ)
+4. その他存在 key (plan/* / execution/* / evaluation/* / learning/*) を逐次 `read_memory` で復元
+
+### Phase 4: 復元レポート (user 提示)
+
+stdout に以下 4 項目を構造化して提示:
+
+```
+🔄 Previous session restored from Serena memory.
+
+📋 前回 (Last session):
+   <session/last の要約を 1-2 段落>
+
+📊 進捗 (Current progress):
+   <session/context の "TaskList 最終状態" + "累計 commits" から抽出>
+
+🎯 次回 (Planned next actions):
+   <session/context の "次セッション着手手順" を番号付きリストで>
+
+⚠️  課題 (Blockers / open issues):
+   <存在すれば箇条書き、なければ "なし">
+```
+
+### Phase 5: TaskList 再同期 (option)
+
+復元した `session/context` に未完 task (status = `pending` or `in_progress`) が記録されていれば:
+1. TaskCreate で復元 (内部 task list と同期)
+2. TaskUpdate で status を復元
+
+(本 Phase は user 指示で skip 可。標準では実行)
+
+### Phase 6: Loop モード自律実行 (引数 `loop` 時のみ、2026-05-26 追加)
+
+引数 `$ARGUMENTS == "loop"` の場合、復元後に自動的に Loop モードへ切替えて「次セッション着手手順」を自律実行する。引数なしの場合は本 Phase を skip して Phase 4 復元レポート提示で完了 (user 手動指示待ち)。
+
+1. **Loop モード切替**: 現モードが Normal なら `.claude/mode.yml` を `loop` に更新 (or env `HC_MODE=loop` を export)。既に Loop モードなら no-op
+2. **次アクション解析**: `session/context` の「次セッション着手手順」セクションを読み、自律実行可能項目と user 確認必須項目を分類:
+
+   | 分類 | 内容 | 動作 |
+   |---|---|---|
+   | **自律実行可** (modes.md 遵守事項 2 非例外) | 実装 / commit / test / refactor / branch 切替 / status sync / 既存 task の Step 進行 / subagent 並列起動 | 順次自律実行 |
+   | **user 確認必須** (modes.md 遵守事項 2 例外) | 設計文書新規追加 / 仕様変更 / scope 拡張 / 戦略判断 (architecture / 技術スタック / 既存 task 優先順入替) | 提示のみ、user 承認待ち停止 |
+   | **自律実行禁止** (modes.md 遵守事項 8、11 カテゴリ) | 本流 push (policy 連動、下記 3d 参照) / `stg*`・`release*` push / `gh pr merge` / 本番 deploy / DB migration / secrets ローテーション / 等 | 提示のみ、user 明示承認必須 (policy=local-merge-push の本流 push のみ例外) |
+
+3. **自律実行可項目を順次実行** (2026-05-27 task-47 拡張、`docs/tasks/list.md` 自動 enque 統合):
+
+   各 step 前に Why × 5 (v10 1 行 format) 出力 + subagent 委譲時は `run_in_background: true` 必須 + TaskCreate で内蔵 task list に登録 + 並列化義務遵守 + 完了報告に `confidence: 0.X` 必須 + 適切な粒度で commit (modes.md 遵守事項 5、1 機能 / 1 修正 / 1 リファクタごと)。enqueue 順序:
+
+   - **3a**: `session/context` の「次セッション着手手順」を最優先 enque (既存動作)
+   - **3b**: 3a 完了後、`docs/tasks/list.md` から status **🔄 進行中** の task を 1 件選択し、各 Step を順次着手
+   - **3c**: 進行中 task の Step 完遂後、status **🔲 未着手** の task から **依存解決順** で 1 件選択し、着手
+     - **依存解決**: list.md「依存先タスク」列の ID 列挙を参照、依存先が全て ✅ 完了なら着手可 (一部 🔄 / 🔲 / 📝 残存なら skip して次候補へ)
+     - **draft 承認確認**: 各 task の設計 draft で `approved_at:` 非空を必須 (= user 承認済のみ自律着手、設計新規追加は `modes.md` 遵守事項 2 例外条項のため自律 enque 不可、draft 不在 / 未承認 task は user 確認必須項目として step 4 stop)
+   - **3d**: 各 task の DoD 達成で status ✅ 完了 + commit。本流統合は `mainline_integration_policy` 連動 (2026-06-03 task #77、SSoT `docs/draft/git-integration-policy.md` §3.2)。**auto-merge は機械的順序 gate**: ①smoke 実行 (`run-all-smokes.sh`) ②exit 0 確認 (非0 / conflict / security CRIT で stop) ③`local-merge` / `local-merge-push` のみ **merge 前に mainline 存在確認** (`git show-ref --verify --quiet refs/heads/<mainline>` or `git ls-remote --exit-code origin <mainline>`、不在は error 停止 — git-wf H3 / sec H-1) → `git checkout <mainline> && git merge --no-ff <feature>` (conflict は `git merge --abort` + stop) ④`local-merge-push` のみ `git push origin <mainline>` (push 拒否は rebase/retry せず hard stop)。policy 別:
+     - `pr-required` (default): feature branch push + `gh pr create` まで自律可 (task #39 緩和)、本流 merge / push は user 確認必須
+     - `local-merge`: feature push + ローカル本流 merge まで自律可、remote 本流 push は user 確認必須
+     - `local-merge-push`: ローカル merge + remote 本流 push まで自律可
+     - **`stg*` / `release*` push は全 policy で user 確認必須** (`git-deny.sh` Tier1 安全弁)。policy 値は `bash .claude/scripts/hc-config.sh --get mainline_integration_policy` (不正値は fail-safe `pr-required`)
+   - **3e**: 全 task ✅ 完了 or 全 🔲 task が user 確認必須 (draft 不在 / approved_at 空) なら step 4 (user 確認 stop) へ遷移
+
+4. **user 確認必須項目で stop**:
+   - 次アクションが user 確認必須項目 (modes.md 遵守事項 2 例外条項到達 = 設計新規 / 仕様変更 / scope 拡張 / 戦略判断 / 規範変更) に到達したら、「次は <項目>。承認後に進めます」と提示
+   - 提示後 user message を待機 (Phase 7 context 監視は継続)
+
+5. **続行不可 stop** (2026-05-27 task-47 新設):
+   - 同一 error 3 回連続失敗
+   - subagent の「要判断」報告
+   - `security-reviewer` の CRITICAL 検出
+   - 致命的 error (権限拒否 / 復旧不能 / データ破壊リスク)
+   - いずれかで step 7 (自動 /save-state) へ遷移
+
+6. **context 閾値到達 stop** (Phase 7 統合):
+   - tier 80 (`context_budget_threshold` 越え + 上位 tier) 到達で **強制 stop**
+   - 自動 `/save-state` 実行 (step 7 に遷移)
+   - 次 session 案内: 「新 session で `/resume-state loop` で継続。残 task: <id 列挙>」
+
+7. **stop 時自動 /save-state** (2026-05-27 task-47 新設、step 4/5/6 で stop 時の共通処理):
+   - 上記 4 / 5 / 6 のいずれかで stop 時、即時 `/save-state` 実行
+   - `session/context` に「Loop モード自律実行で <stop 理由> 到達、次 session で `/resume-state loop` で継続。残 task: <id 列挙>」を記録
+   - stdout に再開コマンド提示
+   - 全 task ✅ 完了で step 3e 経由到達した場合は「全自律実行項目完遂、未着手 task 0 / draft 承認待ち task <list>」と報告して継続待機 (自動 /save-state は context tier 80 以上の場合のみ)
+
+### Phase 7: Context budget 監視 + 自動 `/save-state` (引数 `loop` 時のみ、2026-05-26 追加)
+
+Phase 6 実行中、context 使用率を継続監視し、`harness-config.yml` の `context_budget_threshold` に達したら `/save-state` を自動実行して session を区切る。**閾値・上限値は全て yml の値を SSoT として参照** (hardcode 禁止)。
+
+1. **設定 SSoT (yml 参照、env 上書き可)**:
+
+   | yml key (`.claude/harness-config.yml`) | env override | 役割 | 現 hirai-method 値 |
+   |---|---|---|---|
+   | `context_budget_enabled` | `HC_CONTEXT_BUDGET_ENABLED` | hook 全体の有効化 | `true` |
+   | `context_budget_limit` | `HC_CONTEXT_BUDGET_LIMIT` | context window サイズ (tokens、Opus 1M = `1000000` / Sonnet & Haiku 200K = `200000`、モデル切替時手動更新) | `1000000` |
+   | `context_budget_threshold` | `HC_CONTEXT_BUDGET_THRESHOLD` | warning 開始 ratio (`0.0`〜`1.0`、これ未満は silent) | `0.66` |
+   | `context_budget_state_dir` | `HC_CONTEXT_BUDGET_STATE_DIR` | 警告済 tier marker の保管 dir | `.claude/.context-budget-state` |
+
+2. **既存 hook 機構利用**: `.claude/hooks/context-budget.sh` (UserPromptSubmit) が yml の `context_budget_threshold` を warning 開始ラインとし、tier 3 段階 (`60` / `80` / `95`、`.claude/hooks/context-budget.sh` L141-146 で `ratio >= 0.60 / 0.80 / 0.95` で発火) で escalation 警告を `<system-reminder>` で強制注入。各 tier は 1 セッションあたり 1 度のみ発火 (spam 防止、上位 tier 発火時は下位 tier 再警告 skip)
+
+3. **Loop モードでは tier 警告 = stop signal** (tier 閾値は context-budget.sh で hardcode、yml `context_budget_threshold` は warning 開始ライン制御):
+   - **tier 60 警告** (yml `context_budget_threshold` 越え時に最初発火): 1 度だけ「`/save-state` 推奨タイミング」表示、自律実行は継続
+   - **tier 80 警告** (`ratio >= 0.80` で発火): **強制 `/save-state` 実行** + 次 session 移行案内 (「新 session で `/resume-state loop` で継続」)
+   - **tier 95 警告** (`ratio >= 0.95` で発火): 即時 `/save-state` + session 終了 (context overflow 直前の緊急停止)
+
+4. **`/save-state` 自動実行**: tier 80 以上で main agent が `/save-state` を実行、`session/context` に「Loop モード自律実行で context 閾値到達、次 session で `/resume-state loop` で継続」と記録、stdout に再開コマンドを表示して Phase 7 exit
+
+5. **無効化**: yml で `context_budget_enabled: false` (or env `HC_CONTEXT_BUDGET_ENABLED=false`) で context 監視 OFF (Phase 7 全 skip)、Phase 6 は無限ループ可能性あるため非推奨
+
+6. **閾値調整の運用**:
+   - 早めに warning したい → yml `context_budget_threshold: 0.50` (= 50% で warning 開始)
+   - 一時的に厳しく → env `HC_CONTEXT_BUDGET_THRESHOLD=0.40` (env-set 中のみ有効)
+   - tier 閾値 (60/80/95) を変更したい場合は `.claude/hooks/context-budget.sh` L141-146 を直接編集 (subagent 委譲 + staging 戦略必須)
+
+## 引数
+
+| 引数 | 動作 |
+|---|---|
+| **(なし、default)** | 復元のみ mode (Phase 1-5)。user が手動で次アクション選択 |
+| **`loop`** | 復元 + Loop モード自律実行 mode (Phase 1-7)。context 閾値到達まで継続、user 確認必須項目で stop |
+| **その他** | warning 出力 + 復元のみ mode で続行 |
+
+引数解析: `$ARGUMENTS` の値で分岐 (case-insensitive 推奨、`loop` / `Loop` / `LOOP` 受理)。
+
+特定 memory key のみ復元したい場合: 本コマンドの Phase 3 を modify した後継 command を別途検討 (本 task scope 外)。
+
+## エラーハンドリング
+
+| 状況 | 動作 |
+|---|---|
+| Serena MCP 未注入 | Phase 1 で停止 + 案内 + exit |
+| onboarding 未済 | Phase 1 で `activate_project` error として停止 + 案内 + exit |
+| project 未登録 | Phase 1 で `activate_project` error として停止 + 案内 + exit |
+| `session/context` key 不在 | Phase 2 で停止 + 「新規 session として開始」案内 |
+| 個別 key の `read_memory` fail | warning 出力 + 残 key 復元続行 |
+| Phase 5 TaskList 再同期 fail | warning + 復元レポートは出力 (Phase 4 は成功扱い) |
+| Phase 6 自律実行中の subagent fail | confidence-gate で BLOCK、main が自律 retry / user 通知 / 次 task 進行のいずれかを判断 |
+| Phase 7 context tier 警告 + `/save-state` fail | warning 出力 + Phase 6 自律実行は緊急 stop、user に手動 `/save-state` 案内 |
+
+## 関連
+
+- `/save-state` — 保存コマンド (本コマンドの逆)
+- `/pm-start` — PM Agent (Session Start Protocol で本コマンドを auto-invoke)
+- `.claude/hooks/mode-session-start.sh` — SessionStart 時に memory 存在を検出して `/resume-state` を提案 (W2)
+- `.claude/hooks/context-budget.sh` — context 使用率監視 (Phase 7 で利用)
+- `.claude/rules/modes.md` — Loop モード規範 (遵守事項 2 例外条項 / 5 commit 粒度 / 7 並走中独立作業 / 8 自律実行禁止 11 カテゴリ) / context-budget 設定
+- `.claude/rules/development-process.md` — subagent 委譲 3 必須要件 (background 起動 / 並列化義務 / agent type 選定) / TaskCreate 義務
+- `.claude/rules/why-x5-output.md` — Why × 5 v10 1 行 format (Phase 6 各 step 前に必須出力)
+- `.claude/harness-config.yml` — `context_budget_threshold` (Phase 7 閾値) / `auto_loop_resume_*` (将来拡張用キー、現状未実装)
+- Memory key schema: `/save-state` の §関連 参照

package/.claude/commands/reviewpr.md

@@ -0,0 +1,118 @@
+---
+description: GitHub PR を既存 8 ルール + Critical Operational Lessons + CI 状況と照合してレビュー。引数: PR 番号 or URL。
+---
+
+# /reviewpr — PR 多軸レビュー
+
+GitHub MCP / `gh` CLI で PR を取得し、本リポの精緻なルール群と照合してレビューを実施します。
+
+## 使い方
+
+```
+/reviewpr 123                       # PR 番号
+/reviewpr https://github.com/ORG/REPO/pull/123
+/reviewpr 123 --quick                # CI + diff 行数のみ高速確認
+/reviewpr 123 --focus auth           # 特定ルールに絞る (auth/db/cache/style/posting)
+```
+
+## 動作
+
+### Phase 1: 取得
+
+GitHub MCP の `mcp__github__pull_request_read` を使用(失敗時は `gh pr view` フォールバック):
+
+1. PR タイトル / 説明 / リンク issue
+2. 変更ファイル一覧 + 差分行数
+3. CI 状況 (`gh pr checks`)
+4. レビューコメント既存分
+
+### Phase 2: 8 ルール照合
+
+変更ファイルパスから該当する `.claude/rules/` を特定し、各ルールの観点で違反を検出:
+
+| 変更パス | 該当ルール | 主要チェック観点 |
+|---------|-----------|---------------|
+| `src/**` `tests/**` `scripts/**` | development-process.md | TDD・委譲・1 ファイル責任 |
+| `src/**/*.{css,tsx}` | styling.md | Tailwind v4 `dark:` 禁止・モノトーン・見出し階層 |
+| `src/lib/supabase*.ts` `src/types/**` `supabase/migrations/**` | database.md | RLS・モックモード・CLI 経由 |
+| `src/lib/auth.ts` `middleware.ts` | auth.md | Google SSO・`allowed_emails.role` SSoT・PUBLIC_PATHS |
+| `docs/tasks/**` `docs/draft/**` | development-process.md | 設計→承認→タスク化フロー |
+| `next.config.ts` `src/app/**` `src/components/**` | nextjs-cache-components.md | `dynamic`/`runtime`/`revalidate` 禁止・Suspense 境界・`'use cache'` 内非決定値禁止 |
+| `src/lib/{extract-mermaid,highlight,rewrite-images}.ts` `src/__tests__/fixtures/**` | posting-html-fixture-sync.md | 投稿側-消費側 fixture 共有 |
+| 全変更 | CLAUDE.md "Autonomous Progression" | 自律進行範囲内か・破壊的 DB 変更がないか |
+
+### Phase 3: Critical Operational Lessons 照合
+
+CLAUDE.md の HIGH 教訓 5 件を必ずチェック:
+
+- [ ] RLS 一元化、`queries.ts` への `.not()` 追加なし
+- [ ] `.single()` を chunked テーブルで使っていない(`.limit(1)[0]` 必須)
+- [ ] `--update` フローで snapshot を伴う実装か(関連箇所のみ)
+- [ ] 独自 secret 認証 API を増やしている場合、middleware `PUBLIC_PATHS` も更新済か(3 点セット)
+- [ ] Cache Components 影響変更がある場合、`npm run build` を CI で必ず実行しているか
+
+### Phase 4: 構造化レビュー出力
+
+```markdown
+## PR #<NUMBER>: <TITLE>
+
+**サマリ:** <1 行>
+**ファイル数:** <N> / **追加行:** <+X> / **削除行:** <-Y>
+**CI:** ✅ all green / ⚠ 一部失敗 / ❌ blocking
+**該当ルール:** auth.md, database.md, ...
+
+### CRITICAL(blocking)
+- <ファイル>:<行> — <指摘>
+  - 違反ルール: `auth.md` "PUBLIC_PATHS 3 点セット"
+  - 提案: ...
+
+### HIGH(merge 前修正推奨)
+- ...
+
+### MEDIUM(可能なら修正)
+- ...
+
+### LOW / 提案
+- ...
+
+### Critical Operational Lessons チェック
+- [x] RLS 一元化 OK
+- [ ] Cache Components ビルド検証 — **未確認、要 `npm run build`**
+- ...
+
+### 総評
+<1-2 行>
+```
+
+### Phase 5: 反映オプション
+
+ユーザー指示があれば:
+- `gh pr review --request-changes -b "<上記サマリ>"` で review 提出
+- 修正提案を inline コメントとして `mcp__github__pull_request_review_write` で送信
+- 修正自体は **コードレビューだけが役割**。実装は別途 subagent 委譲
+
+## サブエージェント並列起動
+
+複数観点を並列で評価する場合(推奨):
+
+```
+Agent 1 (subagent_type=code-reviewer, グローバル) — 一般品質
+Agent 2 (subagent_type=security-reviewer, グローバル) — 認証/権限変更時
+Agent 3 (subagent_type=typescript-reviewer, グローバル) — TS 意味論
+Agent 4 (subagent_type=database-reviewer, グローバル) — migration 含む場合
+```
+
+メインは 4 つの結果を集約して上記フォーマットで出力。
+
+## 制約
+
+- **コード修正は行わない**(指摘までが役割)
+- 推測で書かない(diff から読める事実だけを根拠にする)
+- 既存の review コメントと**重複**しない(Phase 1 で取得して exclude)
+- CRITICAL は `.claude/rules/` 違反 or Critical Operational Lessons 違反のみに限定
+
+## 関連
+
+- 既存ルール: [`.claude/rules/`](../rules/)
+- 教訓: [CLAUDE.md](../../CLAUDE.md) の Critical Operational Lessons セクション
+- GitHub MCP: `mcp__github__pull_request_read` `mcp__github__pull_request_review_write`

package/.claude/commands/save-state.md

@@ -0,0 +1,100 @@
+# /save-state — Save session state to Serena memory
+
+セッション状態を Serena MCP の memory に永続化する自前コマンド。SuperClaude `/sc:save` の後継。Serena MCP 必須。
+
+## 前提
+
+- **Serena MCP が `.mcp.json` に登録され、`mcp__serena__*` tool が利用可能であること**
+- 未注入時は Phase 1 で error 終了し、user に Serena 導入手順を案内する
+
+## 動作
+
+このコマンドが呼ばれたら、メインエージェントは以下の手順を順次実行してください。
+
+### Phase 1: Project activation & onboarding check (必須、統合)
+
+1. `mcp__serena__activate_project` を実行 (引数 = current project name 推定 or git remote の repo name)
+   - 戻り値が success: 続行 (onboarding 済 + project 登録済を意味する。既に activated なら no-op)
+   - 戻り値が error: 内容に応じて分岐:
+     - `onboarding` / `not performed` を含む → stdout に error message: 「Serena MCP onboarding が未完了です。`/onboarding` 等で完了させてから再実行してください。」+ 以降の Phase を skip して終了
+     - その他 (project 不在等) → warning 出力 + 続行 (memory 書き込みは試行)
+
+> **設計補足**: 旧版では `mcp__serena__check_onboarding_performed` を別 step で呼んでいたが、現 Serena MCP には該当 tool が存在しない (2026-05-23 確認、deferred tools list にも無し)。代わりに `activate_project` の error response で onboarding 未済を検知する。
+
+### Phase 2: Session context snapshot
+
+1. 現在のセッション状態を構造化 summary に整理:
+   - **Project**: 現在 branch / 直近 commit hash / 進捗概要
+   - **TaskList 最終状態**: TaskList ツールで取得した全 task の (id / status / subject) 一覧
+   - **累計 commits**: 本セッション中の commit 一覧 (`git log` で取得、新しい順 max 10 件)
+   - **主要 artifact**: 本セッション中に追加・変更した主要ファイル (一覧)
+   - **user 要求への対応**: user の主要指示と対応結果
+   - **次セッション着手手順**: 番号付きリストで明示
+   - **教訓**: 本セッション末で memory `feedback_*.md` に追加すべき教訓 (あれば)
+2. `mcp__serena__write_memory("session/context", <full_state_markdown>)` で保存
+
+### Phase 3: Last-session summary
+
+1. 本セッションの achievement / user 指摘 / 次セッション着手 を 1-2 段落に要約 (`session/context` より簡潔版)
+2. `mcp__serena__write_memory("session/last", <summary>)`
+
+### Phase 4: Incremental checkpoint (option)
+
+PDCA cycle 中の進捗が `session/context` より新しい場合のみ:
+1. 直近 30 分相当の進捗を抽出
+2. `mcp__serena__write_memory("session/checkpoint", <progress>)`
+
+### Phase 5: docs/temp/ cleanup (option)
+
+`docs/temp/` 配下に PDCA cycle の hypothesis-* / experiment-* / lessons-* ファイルがあれば:
+- 成功 pattern → `docs/patterns/<name>.md` に昇格 (write)
+- 失敗 case → `docs/mistakes/<feature>-YYYY-MM-DD.md` に昇格
+- 該当 temp file は削除
+
+(本 cleanup は optional、user 指示がなければ skip 可)
+
+### Phase 6: 完了報告
+
+stdout に以下を出力:
+
+```
+✅ Session 状態を Serena memory に保存しました。
+   - session/context (完全 snapshot)
+   - session/last (1-2 段落の要約)
+   - session/checkpoint (進捗 checkpoint がある場合)
+
+次セッションでの復元オプション:
+  - `/resume-state`      — 復元のみ (Phase 1-5)。user が手動で次アクション選択
+  - `/resume-state loop` — 復元 + Loop モード自律実行 (Phase 1-7)。context 閾値 (`harness-config.yml` `context_budget_threshold`、現 0.66) 到達まで継続、user 確認必須項目 (設計新規 / 仕様変更 / 戦略判断 / 自律禁止 11 カテゴリ) で停止
+```
+
+## 引数
+
+引数なし。常に full session state を保存する。
+
+## エラーハンドリング
+
+| 状況 | 動作 |
+|---|---|
+| Serena MCP 未注入 (`mcp__serena__*` tool 不在) | Phase 1 で停止 + 案内 message + exit |
+| `activate_project` の error response が onboarding 未済を示す | Phase 1 で停止 + `/onboarding` 案内 + exit |
+| `activate_project` が fail (project 不在 / hash 不一致) | warning 出力 + 続行 (memory 書き込みは試行) |
+| `write_memory` の各 key が fail | 該当 key を skip + 残り key を試行、最後に集計報告 |
+
+## 関連
+
+- `/resume-state` — 復元コマンド (本コマンドの逆)
+- `/pm-start` — PM Agent (Session End Protocol で本コマンドを自動呼び出し)
+- Serena MCP: `~/.claude/projects/<project_hash>/memory/` 配下に Markdown ファイルとして物理保存
+- Memory key schema (PM Agent spec 準拠):
+  - `session/context` — 完全 snapshot
+  - `session/last` — 前 session summary
+  - `session/checkpoint` — 進捗 checkpoint
+  - `plan/<feature>/hypothesis` — Plan 仮説
+  - `execution/<feature>/do` — Do 実験ログ
+  - `evaluation/<feature>/check` — Check 評価
+  - `learning/patterns/<name>` — 成功 pattern
+  - `learning/solutions/<error>` — error 解決 DB
+  - `learning/mistakes/<timestamp>` — 失敗分析
+  - `project/context` — project 全体理解
+  - `project/architecture` — system architecture

package/.claude/commands/sentry-pr.md

@@ -0,0 +1,157 @@
+---
+name: sentry-pr
+description: "Sentry導入PR作成 - apply-rules実行後のコミット・プッシュ・PR作成を自動実行"
+category: workflow
+complexity: basic
+model: opus
+mcp-servers: []
+---
+
+# /sentry-pr - Sentry導入PR自動作成
+
+## 概要
+
+`/apply-rules` 実行後の変更をコミット・プッシュし、PRを作成するコマンド。
+変更点のサマリーを自動生成する。
+
+## 使用方法
+
+```
+/sentry-pr $ARGUMENTS
+```
+
+**引数:** 対象ファイル名（例: `TaskTriggerHandler.cls`）
+
+---
+
+## 実行手順
+
+### Step 1: 引数の検証
+
+- `$ARGUMENTS` が空の場合 → エラー: `対象ファイルを指定してください。例: /sentry-pr TaskTriggerHandler.cls`
+- 現在のブランチが `Sentry-` で始まることを確認
+
+### Step 2: 変更サマリーの生成
+
+`git diff` を実行し、以下の情報を抽出する：
+
+1. **変更ファイル一覧**（`git diff --name-only`）
+2. **変更統計**（`git diff --stat`）
+3. **コード変更の要約**:
+   - Phase 1 (コーディングルール): `with sharing` 追加、Javadoc追加 等
+   - Phase 2 (Sentry): breadcrumb追加箇所、try-catch変更 等
+   - Phase 3 (設計書): 更新セクション
+4. **関連テストクラスの探索**:
+   以下の順序で対応するテストクラスを探索する。
+   - `{クラス名}Test.cls` が存在するか確認（例: `TaskTriggerHandler.cls` → `TaskTriggerHandlerTest.cls`）
+   - 見つからない場合、`force-app/main/default/classes/` 内で `@IsTest` かつクラス名の一部を含むファイルを検索
+   - 見つからない場合、「⚠️ テストクラスなし」とレポートに記載
+   - 複数見つかった場合はすべて列挙する
+
+### Step 3: コミット
+
+変更ファイルをステージングし、以下の形式でコミットする：
+
+```
+[Sentry] {ファイル名} - コーディングルール適用 & Sentryエラー追跡追加
+
+Phase 1: コーディングルール適用
+- with sharing 追加
+- クラス/メソッド Javadoc 追加
+
+Phase 2: Sentry エラー追跡追記
+- メソッド開始・終了ブレッドクラム追加
+- 既存 catch に Sentry.preserveStackTrace/record 追加
+
+Phase 3: 詳細設計書更新
+- エラーハンドリングセクションに Sentry 情報追記
+- 改訂履歴更新
+```
+
+### Step 4: プッシュ
+
+```bash
+git push -u origin {ブランチ名}
+```
+
+### Step 5: PRのbaseブランチ選択と確認
+
+ユーザーにPRのbaseブランチ（マージ先）を選択してもらう。
+
+**選択肢:**
+- `main`
+- `dev`
+- `stg`
+- `STG` で始まるブランチ（例: `STG-release-2026-02`）
+
+`STG` で始まるブランチを選択肢に含める場合は、`git branch -r` でリモートの `STG*` ブランチを一覧取得して候補に追加する。
+
+**選択後、必ず以下の確認を行う:**
+
+> 「`{選択されたブランチ}` ブランチにPRしてもよろしいでしょうか？」
+
+ユーザーが承認した場合のみ、次のStep 6に進む。
+拒否された場合は、再度ブランチ選択に戻る。
+
+### Step 6: PR作成
+
+`gh pr create --base {選択されたブランチ}` で PR を作成する。以下のテンプレートを使用：
+
+```markdown
+## 概要
+{ファイル名} に Sentry エラー追跡を導入
+
+## ドメイン
+{ドメイン名}（git diff またはファイル内容から推定）
+
+## 変更内容
+- [x] Phase 1: コーディングルール適用
+- [x] Phase 2: Sentry エラー追跡追記
+- [x] Phase 3: 詳細設計書更新
+
+### Phase 1: コーディングルール
+{自動生成: 修正した項目リスト}
+
+### Phase 2: Sentry 追記
+{自動生成: 追加したブレッドクラム/catch変更のサマリー}
+
+### Phase 3: 設計書
+{自動生成: 更新したセクション}
+
+## ファイル種別
+{TriggerHandler / Batch / REST API / Controller / Service 等}
+
+## リリース時に実行するテストクラス
+| # | テストクラス | パス |
+|---|------------|------|
+| 1 | {テストクラス名} | `force-app/main/default/classes/{テストクラス名}.cls` |
+
+**デプロイコマンド例:**
+```bash
+sf project deploy start -m ApexClass:{変更クラス名} -m ApexClass:{テストクラス名} --test-level RunSpecifiedTests --tests {テストクラス名} --target-org {org}
+```
+
+{テストクラスが見つからない場合は以下を記載}
+> ⚠️ 対応するテストクラスが見つかりません。リリース前にテストクラスの作成または特定が必要です。
+
+## テスト確認
+- [ ] 上記テストクラスが PASS すること
+- [ ] Sentry のブレッドクラム・エラー送信が適切なこと（コードレビューで確認）
+
+## 関連
+- Asana タスク: [Sentry追加プロジェクト](https://app.asana.com/0/1213212167180469)
+- /apply-rules 実行結果: 下記レポート参照
+```
+
+### Step 7: 結果表示
+
+PR の URL を表示する。
+
+---
+
+## 注意事項
+
+- コミット前に `git diff` で変更内容を確認する
+- PR の base ブランチはユーザーが選択（main / dev / stg / STG*）
+- base ブランチは必ずユーザーに確認してから PR を作成する
+- レビュアーは指定しない（手動で追加）

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

@@ -0,0 +1,87 @@
+---
+description: タスク開始の定型化。docs/tasks/list.md からタスクを取得し、関連 design doc を読み、branch を切り、status を in_progress に更新する。
+---
+
+# /start-task — タスク開始フロー
+
+`docs/tasks/list.md` の真実源と branch / status を同期させる。
+
+## 使い方
+
+```
+/start-task 41                  # task-41-*.md を起動
+/start-task 41 --branch feature/issue-41-snapshot   # branch 名指定
+/start-task 41 --no-branch      # branch を切らない (main で進める)
+```
+
+## 動作
+
+### Phase 0: 台帳の存在確認（auto-init）
+
+1. `docs/tasks/list.md` が存在するか確認
+2. 無ければ `bash .claude/scripts/init-tasks.sh` を実行してテンプレから初期化
+3. それでも無ければ「`/init-tasks` を先に実行してください」と中断
+
+### Phase 1: タスク存在確認
+
+1. `docs/tasks/list.md` を読み、`#41` (or 指定 ID) のステータスを確認
+2. `docs/tasks/task-41-*.md` の存在確認
+   - **見つからない**: `docs/draft/` を探索 → 設計が draft 段階なら「**まず承認を得てください**」と中断
+   - 承認済 draft はあるが task ファイル未生成: 「`/new-task <ID> <slug>` でタスクを起こしてください」と案内
+3. ステータスが `done` / `in_progress` の場合は警告(再開 or 重複の意図確認)
+
+### Phase 2: 依存タスク確認
+
+`task-41-*.md` 内の "Depends on:" セクションを解析し、依存タスクの状態を確認:
+
+- 依存タスクが未完了 → 警告して中断 / 強制続行を選択
+- 依存タスクが parking-lot 行き → 設計再確認を促す
+
+### Phase 3: branch 操作
+
+CLAUDE.md "Autonomous Progression" のルールに従い:
+
+```bash
+# 既に同名 branch があれば checkout
+git switch -c feature/issue-41-snapshot 2>/dev/null || git switch feature/issue-41-snapshot
+```
+
+`--no-branch` 指定時は main のまま進める。
+
+### Phase 4: ステータス更新
+
+`docs/tasks/list.md` の該当行を `todo` → `in_progress` に変更。
+個別ファイル `task-41-*.md` の `Status:` 行も同期。
+
+### Phase 5: 設計書サマリ + 着手点提示
+
+```markdown
+## #41 開始: <タスク名>
+
+**設計書**: `docs/tasks/task-41-snapshot-content-version-management.md`
+**Status**: `todo` → `in_progress` ✅
+**Branch**: `feature/issue-41-snapshot` (current)
+**依存**: #33 ✅ done / #38 ✅ done
+
+### 設計サマリ(設計書の要約)
+- Wave 1: スナップショット取得 (post.ts 改修)
+- Wave 2: ロールバック CLI (rollback.ts 新設)
+- ...
+
+### 着手推奨
+1. (TDD) Wave 1 のテスト観点出し → `Agent(tdd-guide)` (or `Agent(test-automator)` / `Agent(qa-expert)`)
+2. その後 Red → Green → Refactor
+```
+
+## 制約
+
+- **設計なしでタスクを開始しない**(development-process.md 違反、PreToolUse hook でも block される)
+- ブランチ名は CLAUDE.md "Autonomous Progression" に従い main 直 push が許される範囲を尊重
+- main 直編集を避けたい時は `--branch` 指定を user に確認
+
+## 関連
+
+- [`/finish-task`](finish-task.md) — タスク完了の対の動作
+- [`development-process.md`](../rules/development-process.md) — 設計→承認→タスク化フロー
+- [CLAUDE.md "Autonomous Progression"](../../CLAUDE.md#autonomous-progression自律進行ルール) — branch / push 範囲
+- [`docs/tasks/list.md`](../../docs/tasks/list.md) — タスク台帳真実源