@yohakuforce/core 0.4.0

package/dist/scaffold/.claude/commands/change-summary.md.eta

@@ -0,0 +1,79 @@
+---
+description: 直近の差分から PR レビュー用の change-summary Markdown を生成・配置する
+argument-hint: [--from <ref>] [--to <ref>] [--output docs/ai-augmented/change-summaries/]
+---
+
+# /change-summary $ARGUMENTS
+
+## 目的
+
+`/classify-diff` が出力した change_summary JSON を、**PR に貼れる Markdown サマリ**へ変換し、`docs/ai-augmented/change-summaries/<date>-<short-id>.md` に配置する。
+
+## 実行手順
+
+### 1. 既存の change_summary JSON を取得
+
+`/classify-diff` を先に実行している前提:
+- 既存ファイル `docs/ai-augmented/change-summaries/*.json` の最新を採用、または
+- このコマンドから `/classify-diff` を呼び直す (`$ARGUMENTS` にフラグを渡す)
+
+### 2. Markdown 化
+
+以下の構造で出力:
+
+```markdown
+## 差分サマリ: <fromRef>..<toRef>
+
+> 自動生成 (yohaku change-summary): <createdAt>
+
+**集計**
+- 変更ファイル: N 件 (+X / -Y)
+- カテゴリ別: data_model=A, automation=B, permission=C, ui=D, logic=E, operational=F
+
+<!-- DETERMINISTIC_START id="categories" -->
+### data_model (n 件)
+- `Account.Industry` (modified, small)
+  - レビュー観点: ... _(AI)_
+  - 業務影響: ... _(AI)_
+- ...
+
+### automation (n 件)
+- ...
+<!-- DETERMINISTIC_END id="categories" -->
+
+<!-- AI_MANAGED_START id="overall-summary" -->
+**全体所感**: ... (AI 推測、再生成で上書き)
+<!-- AI_MANAGED_END id="overall-summary" -->
+
+<!-- HUMAN_MANAGED_START id="reviewer-notes" -->
+<!-- レビュー担当者の補足はここに -->
+<!-- HUMAN_MANAGED_END id="reviewer-notes" -->
+
+### 手動作業チェックリスト
+- [ ] `Account.Industry`: ピックリスト値追加 → 既存レコード補正
+- [ ] ...
+```
+
+### 3. 大型差分のサンプリング
+
+`raw_diff.truncated === true` または `categories[*].changes.length > 50` の場合:
+- 各カテゴリで **最大 10 件まで詳細表示**、残りは「他 N 件」と集約
+- AI 出力ハルシネーション抑制のため、**サンプル件数を明示**
+
+### 4. ファイル配置とマージ
+
+- 出力先: `docs/ai-augmented/change-summaries/<YYYY-MM-DD>-<short-id>.md`
+- 既存ファイルがあれば **HUMAN_MANAGED ブロックを保護** (yohaku render の merge と同等の挙動)
+- 同時に `<...>.json` も配置 (機械可読バックアップ)
+
+### 5. メトリクス記録
+
+```bash
+yohaku metrics record --model claude-sonnet-4-6 --command /change-summary --in <est> --out <est>
+```
+
+## 禁則
+
+- **業務文脈の捏造禁止**: HUMAN_MANAGED 領域は空のまま。レビュー担当者が記入する
+- **サンプリング時の bias 抑制**: 各カテゴリから先頭 N 件ではなく、`changeKind` 別 (added / modified / removed) で均等にサンプル
+- **PR テンプレートとの統合**: 利用者の `.github/PULL_REQUEST_TEMPLATE.md` から change-summary を参照する仕組みは Phase 6 で

package/dist/scaffold/.claude/commands/classify-diff.md.eta

@@ -0,0 +1,107 @@
+---
+description: <%= it.projectName %> の Git 差分を 7 分類で意味づけし、change_summary を生成する
+argument-hint: [--from <ref>] [--to <ref>] [--include-static-analysis <sarif>]
+---
+
+# /classify-diff $ARGUMENTS
+
+## 実行手順
+
+### ステップ 1: 既知ナレッジ確認
+
+`.agents/knowledge/INDEX.md` をスキャンし、以下を確認:
+- `decisions/` で関連エンティティの過去判断
+- `pitfalls/` で類似差分の既知ワナ
+- `wins/` で再利用すべきパターン
+
+### ステップ 2: 決定的差分の取得
+
+```bash
+yohaku diff --from <fromRef> --to <toRef> --json --path-prefix force-app/
+```
+
+`<fromRef>` `<toRef>` は引数 `$ARGUMENTS` から抽出 (デフォルト: `--from origin/main --to HEAD`)。
+
+出力 JSON の `files` 配列を category でグループ化:
+- `data_model`, `automation`, `permission`, `ui`, `logic`, `operational`, `manual`, `unknown`
+
+### ステップ 3: 並列分類器の起動 (Task ツール)
+
+各カテゴリのファイルが 1 件以上ある場合、対応する subagent を **並列で 1 メッセージ内に複数 Task 呼び出し** で起動:
+
+| カテゴリ | subagent | tools |
+|---|---|---|
+| data_model | data-model-classifier | Read, Bash |
+| automation | automation-classifier | Read, Bash |
+| permission | permission-classifier | Read, Bash |
+| ui | ui-classifier | Read, Bash |
+| logic | logic-classifier | Read, Bash |
+
+各 subagent には対応するファイルリストのみを渡す (他カテゴリは扱わない原則)。
+
+### ステップ 4: 結果統合
+
+各 subagent の応答 (`CategorySection`) を集約し、`ChangeSummary` 全体を組み立てる:
+
+```typescript
+{
+  id: { value: "cs-<date>-<short-hash>", source: "deterministic" },
+  createdAt: { value: <ISO 8601>, source: "deterministic" },
+  fromRef: { value: <fromRef>, source: "deterministic" },
+  toRef: { value: <toRef>, source: "deterministic" },
+  staticAnalysisFindings: { value: [...], source: "deterministic" },  // ← --include-static-analysis があれば
+  categories: [<各分類器の結果>],
+  humanAnnotations: {
+    businessContext: { value: "", source: "human" },
+    customerCommunicationNeeded: { value: false, source: "human" }
+  }
+}
+```
+
+### ステップ 5: スキーマ検証
+
+```bash
+echo '<JSON>' | yohaku validate --change-summary --target -
+```
+
+**ajv 検証で source 列未指定が弾かれる**。失敗したら subagent 出力を修正。
+
+### ステップ 6: 出力
+
+`docs/ai-augmented/change-summaries/<date>-<short-id>.md` に Markdown 化して保存。
+さらに JSON は `docs/ai-augmented/change-summaries/<date>-<short-id>.json`。
+
+### ステップ 7: AI コスト記録
+
+`yohaku metrics record` でこのサイクルの token 使用を記録 (各 subagent 終了時にも個別記録推奨)。
+
+## 出力例
+
+```markdown
+## 差分サマリ: <fromRef>..<toRef>
+
+- 生成: <timestamp>
+- 変更ファイル: 12 件 (+340 / -85)
+- カテゴリ別: data_model=4, automation=2, logic=5, operational=1
+
+### data_model
+- `Account.Industry` (modified, small)
+  - レビュー観点: picklist 値の追加が既存レコードに影響しないか確認 _(AI 推測)_
+  - 業務影響: 顧客分類用途、ダッシュボードで使用される可能性 _(AI 推測)_
+- ...
+
+### 手動作業 (要 check)
+- `Account.Industry`: ピックリスト値追加 → 既存レコード補正検討
+- ...
+```
+
+## 大型差分対応
+
+- `yohaku diff --limit 1000` で取得時にトリミング (`truncated: true` がフラグ)
+- 1000 ファイル超なら **カテゴリ別代表サンプル** だけ subagent に渡す (Phase 3-7 で詳細化)
+
+## 禁則
+
+- 業務文脈の **捏造禁止** (HUMAN_MANAGED 領域から引用 or 推測時は曖昧さ語を含める)
+- 各分類器の **責務範囲外を扱わない** (例: data-model-classifier は Flow/Trigger を扱わない)
+- 一致率 CI を意識: **temperature=0** で同一プロンプト同一入力なら同一出力 (再現性ガバナンス層 4)

package/dist/scaffold/.claude/commands/explain.md.eta

@@ -0,0 +1,63 @@
+---
+description: <%= it.projectName %> の特定エンティティを詳細説明する
+argument-hint: <object|field|flow|apex|permissionSet 名>
+---
+
+# /explain $ARGUMENTS
+
+知識グラフ経由でエンティティの詳細を取得し、構造化して説明する。
+
+## 実行手順
+
+1. **エンティティ種別の判定**
+   - `$ARGUMENTS` を以下の順で照合:
+     ```bash
+     yohaku graph query "SELECT 'object' AS kind, fqn FROM objects WHERE fqn = '$ARGUMENTS'"
+     yohaku graph query "SELECT 'field' AS kind, fqn FROM fields WHERE fqn = '$ARGUMENTS'"
+     yohaku graph query "SELECT 'flow' AS kind, fqn FROM flows WHERE fqn = '$ARGUMENTS'"
+     yohaku graph query "SELECT 'apex' AS kind, fqn FROM apex_classes WHERE fqn = '$ARGUMENTS'"
+     yohaku graph query "SELECT 'trigger' AS kind, fqn FROM apex_triggers WHERE fqn = '$ARGUMENTS'"
+     ```
+
+2. **見つかったエンティティの詳細表示**
+
+   - **object**: `docs/generated/objects/$ARGUMENTS.md` を読み、要約 + フィールド一覧 + 依存関係を提示
+   - **field**: 親オブジェクトと型・参照先・必須フラグを提示
+   - **flow**: type / status / triggeringObject を提示し、`docs/human/` に業務注記があれば併記
+   - **apex / trigger**: API バージョン、テストフラグ、関連オブジェクトを提示
+
+3. **依存関係の可視化** (オプション)
+   ```bash
+   yohaku graph query "SELECT * FROM dependencies WHERE from_fqn = '$ARGUMENTS' OR to_fqn = '$ARGUMENTS'"
+   ```
+   → 「このエンティティを参照しているもの」「このエンティティが参照しているもの」を整理
+
+4. **業務文脈の引用** (HUMAN_MANAGED 領域)
+   - `docs/generated/objects/$ARGUMENTS.md` の HUMAN_MANAGED ブロックを読む
+   - 業務文脈が記述されていればそれを引用
+   - 空ブロックなら「業務文脈は未記述」と明示
+
+## 出力フォーマット
+
+```markdown
+## $ARGUMENTS — <エンティティ種別>
+
+### 構造 (決定的、知識グラフより)
+- ...
+
+### 依存関係
+- 参照元: ...
+- 参照先: ...
+
+### 業務文脈 (人手記述、引用元: docs/generated/.../$ARGUMENTS.md HUMAN_MANAGED)
+- ...
+
+### 関連
+- 詳細: docs/generated/objects/$ARGUMENTS.md
+- 関連 ADR: (.agents/knowledge/decisions/ から検索)
+```
+
+## 禁則
+
+- 該当エンティティが見つからなければ「未登録 / 名前違い」を確認、推測しない
+- 業務文脈の捏造禁止 (HUMAN_MANAGED にあるものだけ引用)

package/dist/scaffold/.claude/commands/impact.md.eta

@@ -0,0 +1,67 @@
+---
+description: <%= it.projectName %> でエンティティを変更する際の影響範囲を表示
+argument-hint: <object|field|flow|apex 名>
+---
+
+# /impact $ARGUMENTS
+
+知識グラフの dependencies テーブルを使って、`$ARGUMENTS` を変更したときの影響範囲を提示。
+
+## 実行手順
+
+1. **直接の依存元 (Inbound) — このエンティティを参照しているもの**
+   ```bash
+   yohaku graph query "SELECT from_kind, from_fqn, kind FROM dependencies WHERE to_fqn = '$ARGUMENTS'"
+   ```
+
+2. **直接の依存先 (Outbound) — このエンティティが参照しているもの**
+   ```bash
+   yohaku graph query "SELECT to_kind, to_fqn, kind FROM dependencies WHERE from_fqn = '$ARGUMENTS'"
+   ```
+
+3. **間接 (2 ホップ) の依存元** (オプション、件数が多い時はサンプリング)
+   ```bash
+   yohaku graph query "SELECT DISTINCT d2.from_fqn FROM dependencies d1 JOIN dependencies d2 ON d1.from_fqn = d2.to_fqn WHERE d1.to_fqn = '$ARGUMENTS' LIMIT 20"
+   ```
+
+4. **影響カテゴリの分類** (Phase 3 で `/classify-diff` と統合予定)
+   - データモデル: 参照される field / object
+   - 自動化: 参照する Flow / Trigger
+   - 権限: PermissionSet / Profile
+   - UI: (Phase 7 で Layout / LWC 対応)
+
+5. **業務影響の注記**
+   - `docs/generated/objects/$ARGUMENTS.md` の HUMAN_MANAGED ブロックに「customer_communication_needed: true」等の記述があれば必ず引用
+
+## 出力フォーマット
+
+```markdown
+## $ARGUMENTS — 影響範囲
+
+### Inbound (このエンティティを参照しているもの, n 件)
+- <kind>: <fqn> via <relationship>
+
+### Outbound (このエンティティが参照しているもの, n 件)
+- <kind>: <fqn> via <relationship>
+
+### 業務影響 (HUMAN_MANAGED より)
+- ...
+
+### 推奨レビュー観点
+- 変更が壊しうる Inbound 参照 (上記)
+- データ移行が必要なケース (フィールド型変更時)
+- 権限への影響 (PermissionSet/Profile が参照しているか)
+```
+
+<% if (it.profile === 'full') { %>
+## オプション (full プロファイル)
+
+- `/impact $ARGUMENTS --include-static-analysis` で Code Analyzer SARIF を併用 (Phase 3 で実装)
+- `/impact $ARGUMENTS --change-summary` で直近の変更サマリを引用 (Phase 3 で実装)
+<% } %>
+
+## 禁則
+
+- 直接依存と間接依存を混同しない (件数が大きく違うため)
+- 「影響なし」と断言しない: 知識グラフは標準形のみ対応 (Phase 1)、例外形は別途確認推奨
+- 業務影響を推測で書かない

package/dist/scaffold/.claude/commands/manual-steps.md.eta

@@ -0,0 +1,62 @@
+---
+description: <%= it.projectName %> の手動作業レジストリを横断参照する
+argument-hint: [--release <version>] [--status pending|done] [--category pre_release|during_release|post_release]
+---
+
+# /manual-steps $ARGUMENTS
+
+## 目的
+
+過去 / 未来のリリースで生成された **手動作業** を一覧表示。
+リリース時の TODO 管理 + 過去のパターン学習に活用。
+
+## 実行手順
+
+### ステップ 1: レジストリ読み込み
+
+`ops/registry/manual-steps-registry.md` をパース:
+- 各 manual_step の id / title / category / target / relatedChange / status
+- Markdown のチェックリスト形式で記述された status (`[ ]` / `[x]`) を解釈
+
+### ステップ 2: フィルタ適用
+
+- `--release <version>`: 該当リリースの manual_step のみ
+- `--status pending`: チェック未完了のみ
+- `--status done`: チェック完了のみ
+- `--category pre_release` (etc.): カテゴリ絞り込み
+
+### ステップ 3: 出力
+
+```markdown
+## 手動作業一覧 (n 件)
+
+### Pending (m 件)
+- [ ] **<title>** (release: <version>, target: `<entity>`)
+  - 手順: ...
+  - 確認: ...
+  - 担当: <role>
+
+### Done (k 件)
+- [x] ...
+```
+
+## レジストリ更新は他コマンドが行う
+
+- `/release-prep` が新規 manual_step を append
+- 利用者が手動でチェックボックスを更新
+- 本コマンドは **読むだけ**
+
+## 過去事例学習 (Phase 7 で詳細化)
+
+横断参照で「同じ target に対する過去の手動作業」を引っ張れるようにする (現状は単純フィルタ、過去事例の自動引用は Phase 7)。
+
+## 禁則
+
+- 手動作業を **勝手に done にしない** (利用者の手動更新のみ)
+- 手動作業を **削除しない** (履歴として残す、status=done で表現)
+- レジストリの構造を破壊しない (各 entry のフォーマット統一)
+
+## 関連
+
+- /release-prep
+- decisions/[Phase 4 計画](../../.agents/knowledge/decisions/2026-05-07-phase-4-plan.md)

package/dist/scaffold/.claude/commands/onboard.md.eta

@@ -0,0 +1,107 @@
+---
+description: <%= it.projectName %> プロジェクトのオンボーディングを persona 別に行う
+argument-hint: [--role new_joiner|reviewer|release_manager|customer_facing]
+---
+
+# /onboard $ARGUMENTS
+
+このプロジェクト (<%= it.projectName %>) のオンボーディングを **persona 別** に最適化された読み順 + subagent で実施。
+
+## ステップ 0: persona の決定
+
+`$ARGUMENTS` から `--role` を抽出:
+- 指定なし → `new_joiner` (既定)
+- `--role reviewer` → reviewer 向け
+- `--role release_manager` → リリース担当向け
+- `--role customer_facing` → 顧客対応担当向け
+
+## ステップ 1: コンテキスト取得
+
+```bash
+yohaku onboard context --role <persona>
+```
+
+返ってきた JSON から:
+- `goal`: persona のゴール
+- `readOrder`: 推奨読み順 (`domains:*` は実際のドメイン ID 配列に展開済)
+- `primaryAgent`: 起動すべき subagent
+
+## ステップ 2: 既存ナレッジ確認
+
+`.agents/knowledge/INDEX.md` をスキャン。persona に関連する `decisions/` / `pitfalls/` / `wins/` を最大 3 件確認。
+
+## ステップ 3: persona 別 subagent を起動
+
+`primaryAgent` フィールドに応じて Task ツールでサブエージェントを起動:
+
+<% if (it.profile === 'minimal') { %>
+- minimal プロファイルでは `onboarding-guide` のみ。他 role はメインエージェントで擬似動作
+<% } else { %>
+| persona | subagent | 起動内容 |
+|---|---|---|
+| new_joiner | onboarding-guide | 段階的提示、対話的深掘り |
+| reviewer | review-assistant | 直近 change_summary をレビュー観点で要約 |
+| release_manager | release-advisor | 直近 release_doc + 抜け漏れ pitfalls 検出 |
+| customer_facing | customer-impact-explainer | 顧客視点に翻訳、業務用語化 |
+<% } %>
+
+## ステップ 4: 進捗記録
+
+セッション開始時:
+```bash
+yohaku onboard state record-step --role <persona> --step "session-start"
+```
+
+主要ステップ完了ごとに:
+```bash
+yohaku onboard state record-step --role <persona> --step "<step-id>" --entities <comma-separated>
+```
+
+質問を受けるたびに:
+```bash
+yohaku onboard state increment-questions --role <persona>
+```
+
+## ステップ 5: ロール別アウトプット指針
+
+### new_joiner
+- 段階的に提示 (一度に全部見せない)
+- 主要オブジェクト 5 件から開始
+- 質問駆動で深掘り
+- 30 分以内に「主要ドメイン理解」が達成目標
+
+### reviewer
+- 直近 change_summary を 5 分で要約
+- 重点確認ポイント 3〜5 件
+- 過去類似差分の pitfalls 引用
+
+### release_manager
+- 直近 release_doc の抜け漏れチェック
+- manualSteps の依存順序確認
+- rollback ドラフトの妥当性確認
+- Go/No-Go 追認
+
+### customer_facing
+- 技術用語 → 業務用語 翻訳
+- 営業 / 経理 / 管理者別の影響整理
+- 想定 FAQ 提示
+- 顧客周知文ドラフトの確認 (HUMAN_MANAGED 領域、勝手に書き換えない)
+
+## ステップ 6: 不明点の対処
+
+- 業務文脈は **推測しない** → `docs/human/` から引用 or 「分かりません」
+- 知識グラフから取れない情報は不確かさ語 ("〜の可能性") で表現
+- 過去の判断は `.agents/knowledge/decisions/` から引用
+- 新規発見は `.agents/knowledge/pitfalls/` または `improvements/` に **必ず記録**
+
+## 禁則
+
+- HUMAN_MANAGED ブロックを書き換えない
+- 業務文脈の捏造禁止
+- 顧客周知文の自由生成禁止 (テンプレート埋め込み or HUMAN_MANAGED 経由)
+- 「分からない」を恐れない (ハルシネーションより信頼)
+
+## 関連 ADR
+
+- decisions/[Phase 5 計画](../../.agents/knowledge/decisions/2026-05-08-phase-5-plan.md)
+- decisions/[source 列必須化](../../.agents/knowledge/decisions/2026-05-07-source-column-three-layer-boundary.md)

package/dist/scaffold/.claude/commands/release-prep.md.eta

@@ -0,0 +1,147 @@
+---
+description: <%= it.projectName %> のリリース資材 (release_doc) を 6 セクションで自動生成する
+argument-hint: --from <previous-release-tag> [--to <ref>] [--version <vX.Y.Z>] [--include-static-analysis <sarif>]
+---
+
+# /release-prep $ARGUMENTS
+
+## 目的
+
+Git の 2 リビジョン間の差分を意味づけし、**リリースドキュメント** を `docs/releases/<version>.md` に配置する。
+リリース事故の最大要因「手動作業の抜け」を構造的に防ぐ。
+
+## 実行手順
+
+### ステップ 1: 既知ナレッジ確認
+
+`.agents/knowledge/INDEX.md` をスキャン:
+- `decisions/` で過去のリリース判断
+- `pitfalls/` でリリース時の既知ワナ
+- `docs/releases/` の過去リリース doc
+
+### ステップ 2: change_summary を生成 (まだ無ければ)
+
+```
+/classify-diff --from <fromRef> --to <toRef>
+```
+
+生成済みなら最新の `docs/ai-augmented/change-summaries/*.json` を読む。
+
+### ステップ 3: 手動作業抽出
+
+**まずルールベース** で `extractManualSteps` を呼ぶ (core 内部で決定的):
+
+```bash
+# 内部的には yohaku が呼ぶ。Claude Code からは change_summary を読み込んで結果を表示する想定。
+```
+
+**続けて** `manual-step-extractor` subagent を Task 起動して、ルールベースで拾えない手動作業を補完:
+
+```
+Task: manual-step-extractor
+Input: <change_summary.json>, <ルールベース抽出済 manual_steps[]>
+Output: 追加すべき manual_step[] (id 帯 100..199)
+```
+
+### ステップ 4: release-composer + rollback-drafter を **並列起動**
+
+1 メッセージ内で 2 つの Task ツール呼び出し:
+
+| subagent | 入力 | 出力 |
+|---|---|---|
+| release-composer | change_summary + manual_steps | release_doc 全体 (rollbackDraft は空) |
+| rollback-drafter | change_summary + manual_steps | rollbackDraft (Tracked<string[]>) |
+
+### ステップ 5: 統合 + スキーマ検証
+
+- composer 出力の `rollbackDraft` を drafter 出力で置き換え
+- ajv で `release-doc.schema.json` 適合確認
+- 失敗したら subagent 出力を修正
+
+### ステップ 6: Markdown 出力
+
+`docs/releases/<version>.md` に以下構造で書き出す:
+
+```markdown
+# Release <version>
+
+> 自動生成 (yohaku release-prep): <createdAt>
+> ⚠ ロールバック手順は ドラフト です。実行前に必ず人手で精査してください。
+
+<!-- DETERMINISTIC_START id="targets" -->
+## 1. リリース対象
+- ...
+<!-- DETERMINISTIC_END id="targets" -->
+
+<!-- DETERMINISTIC_START id="manual-steps" -->
+## 2. 手動作業チェックリスト
+
+### Pre-Release
+- [ ] **<title>** (target: `<entity>`, ロール: <role>, 所要: <min>分)
+  - 手順: ...
+  - 確認: ...
+
+### During-Release
+...
+
+### Post-Release
+...
+<!-- DETERMINISTIC_END id="manual-steps" -->
+
+<!-- AI_MANAGED_START id="checks" -->
+## 3. 事前確認 / 4. 事後確認 (AI ドラフト)
+...
+<!-- AI_MANAGED_END id="checks" -->
+
+<!-- AI_MANAGED_START id="go-no-go" -->
+## 5. Go / No-Go 判断材料 (AI ドラフト、人手承認前提)
+- 判定: <verdict>
+- 根拠: ...
+<!-- AI_MANAGED_END id="go-no-go" -->
+
+<!-- AI_MANAGED_START id="rollback-draft" -->
+## 6. ロールバック手順 (⚠ ドラフト、人手精査必須)
+...
+<!-- AI_MANAGED_END id="rollback-draft" -->
+
+<!-- HUMAN_MANAGED_START id="customer-comm" -->
+## 7. 顧客周知文 (テンプレート + 人手仕上げ)
+<!-- HUMAN_MANAGED_END id="customer-comm" -->
+```
+
+JSON も `docs/releases/<version>.json` として配置 (機械可読バックアップ)。
+
+### ステップ 7: 手動作業レジストリ更新
+
+`ops/registry/manual-steps-registry.md` に新規 manual_step を追記 (重複検出して dedupe)。
+
+### ステップ 8: メトリクス記録
+
+```bash
+yohaku metrics record --model claude-sonnet-4-6 --command /release-prep --in <est> --out <est>
+```
+
+## 出力フォーマットの厳守
+
+- HUMAN_MANAGED ブロックは AI 上書き禁止
+- ロールバック手順には必ず ⚠ 警告を含める
+- 顧客周知文は **テンプレート埋め込み** で自由生成しない
+- AI 推測の値には source: ai と promptHash を必ず付与
+
+## 大型リリース対応
+
+- 100+ ファイル変更時はカテゴリ別代表サンプルで manual_step を抽出
+- truncate された旨を release_doc 冒頭に記載
+- 詳細は本サイクルでは扱わず Phase 7 で
+
+## 禁則
+
+- **ロールバック手順を実行しない**: ドラフト生成のみ
+- **顧客周知文の自由生成禁止**: テンプレート埋め込み方式
+- **手動作業の見逃しを許容しない**: 過剰検出 > 見逃し
+- **HUMAN_MANAGED ブロックの上書き禁止**
+
+## 関連
+
+- decisions/[Phase 4 計画](../../.agents/knowledge/decisions/2026-05-07-phase-4-plan.md)
+- decisions/[source 列必須化](../../.agents/knowledge/decisions/2026-05-07-source-column-three-layer-boundary.md)