diff-analysis

差分分析の方法論

概要

変更セットを分析するための体系的な方法です。変更を分類し、リスクを評価して、知見を導き出します。Git の差分、設定変更、API 移行、スキーマ更新、ドキュメントの改訂に対応します。

使用する場面

• 生の変更データから知見を抽出するとき
• コードレビューの前に変更を分類し、優先順位を付けるとき
• リリースノートや変更履歴を作成するとき
• 移行の範囲とリスクを評価するとき

使用しない場面

• 素早く状況を把握するときは、代わりに catchup を使用します
• PR 全体をレビューするときは、pensive スキルを備えた review-core を使用します

有効化パターン

トリガーキーワード：diff、changes、release notes、changelog、migration、impact、risk assessment

自動読み込みの条件：Git の差分がある場合、変更分析が依頼された場合、影響評価が必要な場合。

段階的な読み込み

ワークフローの段階に応じてモジュールを読み込みます。

常に読み込む

• 変更分類のワークフローには modules/semantic-categorization.md を使用します

条件に応じて読み込む

• リスク評価が必要な場合は modules/risk-assessment-framework.md を使用します
• Git リポジトリを扱う場合は modules/git-diff-patterns.md を使用します

連携

• Git データの収集には sanctum:git-workspace-review を使用します
• 分析の根拠を記録するには imbue:proof-of-work を使用します
• 最終成果物の形式を整えるには imbue:structured-output を使用します

必須の進捗項目

1. diff-analysis:baseline-established
2. diff-analysis:changes-categorized
3. diff-analysis:risks-assessed
4. diff-analysis:summary-prepared

対応する手順を終えたら、各項目を完了としてマークします。

4 ステップの方法論

ステップ 1：ベースラインの確立（diff-analysis:baseline-established）

比較範囲を定義します。比較する状態、分析の境界、規模を示す指標を明確にします。

Git のコンテキストでは modules/git-diff-patterns.md を読み込みます。それ以外のコンテキストでは、関連する成果物を比較します。

ステップ 2：変更の分類（diff-analysis:changes-categorized）

変更を意味的な種類ごとにグループ化します。変更カテゴリ、意味カテゴリ、優先順位付けについては modules/semantic-categorization.md を読み込みます。

ステップ 3：リスクの評価（diff-analysis:risks-assessed）

影響を評価します。リスクの指標、レベル、スコアリングの方法論については modules/risk-assessment-framework.md を読み込みます。

ステップ 4：概要の作成（diff-analysis:summary-prepared）

調査結果をまとめます。テーマ、件数を含む範囲、リスクレベル、レビューの重点、依存関係を整理します。後続の用途（PR の説明、リリースノート、レビュー）に合わせて形式を整えます。

完了条件

• すべての diff-analysis: 進捗項目が完了としてマークされている
• すべての変更にカテゴリとリスクレベルが割り当てられている
• 概要にベースラインと想定読者（レビュー、リリースノート、計画）が明記されている