Migration, Rollout & Rollback Plan v0.1.0A

Immutable. This exact content is served forever at /api/v1/blob/24be119c247342db.

---
id: 'migration-rollout-rollback'
name: Migration, Rollout & Rollback Plan
description: Ensure design/ADR changes include a concrete migration plan, rollout strategy, rollback conditions, and compatibility considerations.
version: 0.1.0
category: upstream
phase: upstream
applyTo:
  - 'docs/**/*'
  - 'pages/**/*'
  - '**/*migration*.md'
  - '**/*rollout*.md'
  - '**/*rollback*.md'
  - '**/*release*.md'
  - '**/*deploy*.md'
tags: [migration, rollout, rollback, release, upstream]
severity: major
inputContext: [diff, adr]
outputKind: [summary, findings, actions, questions]
modelHint: balanced
dependencies: [repo_metadata]
---

## Pattern declaration

Primary pattern: Reviewer
Secondary patterns: Inversion
Why: 設計変更の差分から移行計画・段階リリース・ロールバックの曖昧さをレビューし、ロールバック不能シナリオを逆照射する。

## Goal / 目的

- 仕様/設計変更の差分から、移行計画・段階リリース・ロールバックが曖昧なまま実装に入るリスクを減らす。

## Non-goals / 扱わないこと

- CI/CD や運用基盤の詳細設計そのもの（ただし “必要な前提” が抜けていれば指摘する）。
- 実装レベルの最適化や手順の細部（設計として必要な骨子に絞る）。

## Pre-execution Gate / 実行前ゲート

このスキルは以下の条件がすべて満たされない限り`NO_REVIEW`を返す。

- [ ] 差分に設計ドキュメント・移行計画・ロールアウト/ロールバック・リリース・デプロイに関するファイルが含まれている
- [ ] inputContextにdiffが含まれている

ゲート不成立時の出力: `NO_REVIEW: migration-rollout-rollback — 移行/ロールアウト/ロールバックに関する差分がない`

## False-positive guards / 抑制条件

- 影響範囲が明確に “実験/検証のみ・本番影響なし” と書かれている場合は、過度に厳しくしない。

## Rule / ルール

- まず「何が変わるか（互換性/データ/動作）と、移行の要否」を 1 行で要約する。
- 指摘は最大 8 件まで。ロールバック不能・データ損失・互換性破壊につながるものを優先。
- “追記案（手順テンプレ）” を最短で貼れる形で付ける。

## Checklist / 観点チェックリスト

- 互換性
  - 旧/新クライアント（API/スキーマ/設定）の両対応期間が必要か。
  - 破壊的変更なら、バージョニングや移行ガイドがあるか。
- 段階移行
  - ステップ（準備→並行稼働→切替→清掃）が明示されているか。
  - Feature flag / 段階リリースの単位と切替条件があるか。
- ロールバック
  - ロールバック条件（どのメトリクス/症状で戻すか）が明示されているか。
  - 戻したときの整合性（データ/互換性/二重書き込み）が説明されているか。
- 観測性
  - リリース中に見るべきメトリクス、ログ、ダッシュボード、アラートがあるか。
  - 失敗時の切り分けに必要な相関IDなどが設計に含まれるか。

## Output / 出力フォーマット

すべて日本語。`<file>:<line>: <message>` 形式で出力する。

- 先頭に要約を 1 行: `(summary):1: <変更点と移行の要点>`
- 以降は指摘（最大 8 件）:
  - `<message>` に `[severity=critical|major|minor|info]` を含める。
  - 可能なら “追記案（テンプレ）” を付ける。

追記テンプレ例:

- `移行ステップ: 1) 準備, 2) 並行稼働, 3) 切替, 4) 清掃（各ステップの完了条件も）`
- `ロールバック条件: <監視指標/閾値/期間> / 手順: <戻す操作> / 注意: <データ整合性>`

## 評価指標（Evaluation）

- 合格基準: 差分に紐づく移行/ロールバックの不足が、優先度付きで短く指摘され、貼れる追記案がある。
- 不合格基準: 実装前提の断定、差分と無関係な運用一般論、指摘過多。

## 人間に返す条件（Human Handoff）

- ロールバック不能（不可逆）やデータ削除を伴う場合、判断が組織/法務/顧客影響に跨るため人間レビューへ返す。