Impact Analysis（影響範囲分析）

Impact Analysis（影響範囲分析）

コード変更（差分・設計変更・設定変更）が引き起こし得る影響を、影響面ごとに漏れにくく整理し、「どこをレビューし、何をテストし、何を観測すべきか」を根拠つきで提示する。

Non-Goals（このスキルがやらないこと）

• 変更の是非の最終判断（意思決定は人間が行う）
• 実行時にしか分からない挙動の断定（断定ではなく推定と不確実性を提示）
• すべてのファイルを無差別に列挙（探索境界と優先度ルールに従う）

設計原則

入力

impact_analysis_input:
  change_set:
    diff: optional<string>           # 可能ならdiff
    changed_files: optional<list>    # 変更ファイル一覧
    commit_or_pr: optional<string>   # コミットSHA or PR番号
    change_summary: optional<string> # 変更の説明

  target:                            # 指定があれば優先
    - file: optional<string>
      symbol: optional<string>
      kind: optional<function|class|method|module|endpoint|sql|config>
      location: optional<string>     # "path:line"

  context:
    language: optional<string>       # ts/​go/​java...
    framework: optional<string>      # express/​nest/​next...
    architecture: optional<string>   # monolith/​microservices...
    entrypoints_hint: optional<list> # routes, handlers, jobs
    risk_profile: optional<string>   # "auth/​payment" 等の重要領域
    constraints:
      max_graph_depth: optional<int> # default 3
      max_items_per_section: optional<int> # default 20

出力

詳細なスキーマは references/​output-schema.md を参照。

出力構造概要

impact_analysis:
  meta:
    schema_version: "2.0"
    confidence:
      overall: 0.0-1.0
      notes: ["静的解析で追えないDIがある"]

  change_overview:
    summary: "<何が変わるか>"
    change_type: <behavior_change|refactor|bugfix|perf|security|config|data_migration|unknown>
    risk_domain_tags: ["auth", "session"]
    blast_radius_hint: <local|module|service|system|unknown>

  targets: [...]           # 変更対象のエンティティ

  impacts:
    code:                  # 呼び出し関係
      direct: [...]
      transitive: [...]
    interface:             # 公開IF・契約
      exports: [...]
      api_endpoints: [...]
    data:                  # データストア
      stores: [...]
    external:              # 外部依存
      dependencies: [...]
    config:                # 設定・環境
      items: [...]
    runtime_quality:       # 性能・可用性
      performance: [...]
      availability: [...]
    security_privacy:      # セキュリティ
      concerns: [...]

  risk_assessment:         # リスク評価（因子ベース）
    overall:
      level: <high|medium|low>
      score: 0-100
    applied_factors: [...]
    matrix: {high: N, medium: N, low: N}

  recommended_verification:  # 検証計画
    tests_to_run: [...]
    tests_to_add_or_update: [...]
    rollout_and_safety: [...]

  observation_plan:          # 観測計画
    logs: [...]
    metrics: [...]
    traces: [...]

  unknowns_and_assumptions:  # 不確実性
    unknowns: [...]
    assumptions: [...]
    suggested_followups: [...]

影響面（Impact Surfaces）

詳細は references/​impact-surfaces.md を参照。

8つの影響面

リスク評価

詳細は references/​risk-scoring.md を参照。

スコアリング因子

リスクレベル

処理フロー

Step 1: 入力の正規化

diff/変更ファイル/説明/ターゲットを統合し「変更集合」を作る。

Step 2: ターゲット抽出

変更箇所からシンボル・公開IF・設定キー・SQLを候補化。

Step 3: 依存グラフ探索（複線）

• 呼び出しグラフ（caller/​callee）
• import/型依存（type_depends）
• ルーティング・ミドルウェア・DIなど"ランタイム経路"の推定

Step 4: 副作用・データフロー分析

DB操作、キャッシュ、メッセージング、外部API、ファイルI/​O。

Step 5: 影響面ごとに分類

8つの影響面（code/​interface/​data/​external/​config/​runtime/​security/​observability）に分類。

Step 6: 根拠と確度付与

各impactに根拠（evidence）と確度（confidence）を付与。断定可能か推定かを明確化。

Step 7: リスク評価

定義済み因子でスコア化し、上位因子を説明可能な形で出す。

Step 8: 検証計画

テスト（層・優先度・目的）、ロールアウト安全策、観測プランへ接続。

Step 9: 探索境界の明示

深さ上限、列挙上限、解析不能領域（unknowns）を必ず出す。

根拠（Evidence）の記載

各impactには必ず根拠を付与する。

impact:
  ref: "src/​middleware/​auth.ts:45"
  relation: "caller"
  risk_level: "high"
  confidence: 0.85
  evidence:
    - "authenticateUser() を直接呼び出している"
    - "import { authenticateUser } from '../​auth/​login'"

関係タイプ（relation）

不確実性の明示

静的解析で追えない影響は必ずunknownsに記載。

unknowns_and_assumptions:
  unknowns:
    - "動的ディスパッチによる呼び出し経路が追跡不能"
    - "文字列ベースのルーティングで静的解析不可"
    - "設定値依存の分岐は実行時まで不明"

  assumptions:
    - "DIコンテナの設定は本番と同一と仮定"
    - "Feature Flagは全てONと仮定"

  suggested_followups:
    - "DIバインディング設定の確認"
    - "実行時ログで呼び出し経路を確認"

ガードレール

1. 根拠なしのimpactを出さない: 必ずevidenceを付与
2. 過剰確信の禁止: 静的解析の限界を認め、confidence/​unknownsで表現
3. 探索境界の明示: max_graph_depthを超えた探索は行わない
4. 網羅より精度: 大量列挙より、根拠のある影響を優先

使用例

User: この変更の影響範囲を分析して
[diff: src/​auth/​login.ts の修正]

Claude:
## Impact Analysis

### Change Overview
- summary: "認証関数のnullチェック追加"
- change_type: bugfix
- risk_domain_tags: ["auth", "session"]
- blast_radius_hint: module

### Targets
| file | symbol | kind | role |
|------|--------|------|------|
| src/​auth/​login.ts | authenticateUser | function | modified |

### Impacts

#### Code (Direct)
| ref | relation | risk | confidence | evidence |
|-----|----------|------|------------|----------|
| src/​middleware/​auth.ts:45 | caller | high | 0.90 | authenticateUser()を直接呼び出し |
| src/​api/​session.ts:23 | caller | medium | 0.85 | ログイン時にセッション作成 |

#### Data
| store | entity | operation | risk | evidence |
|-------|--------|-----------|------|----------|
| postgres | users | read | medium | SELECT FROM users |
| redis | sessions | write | high | セッション書き込み |

### Risk Assessment
- overall: medium (score: 55)
- applied_factors:
  - security_critical_path: 25 (認証フロー)
  - data_write: 20 (セッション書き込み)
  - unknowns_present: 10 (DI経路)

### Recommended Verification
| test | layer | priority | purpose |
|------|-------|----------|---------|
| login.test.ts | unit | p0 | nullケースのカバー |
| auth.integration.ts | integration | p0 | E2Eログインフロー |

### Unknowns
- "DIコンテナ経由の呼び出しは静的解析不可"
- "Feature Flag状態による分岐は実行時依存"

リファレンス

• references/​output-schema.md - 完全な出力スキーマ
• references/​impact-surfaces.md - 影響面の詳細定義
• references/​risk-scoring.md - リスクスコアリング詳細
• references/​relation-types.md - 関係タイプ一覧