migration-architect

Migration Architect

データベース、サービス、インフラストラクチャ、API の移行について、リスク評価、互換性分析、ロールバック手順書を含む段階的な移行計画を生成します。スキーマの互換性を検証し、破壊的変更を検出するとともに、トリガー条件とコミュニケーション用テンプレートを含むロールバック手順を作成します。

主な機能

• 段階的な計画 — JSON 仕様から、検証ゲート、タイムライン、ステークホルダー体制を含む、リスク評価済みの複数フェーズにわたる移行計画を生成します。
• 互換性分析 — 移行前後のデータベースまたは REST/JSON スキーマを比較し、破壊的変更、型の不一致、制約違反を検出するとともに、移行スクリプトとロールバックスクリプトを作成します。
• ロールバック手順書 — フェーズごとの復旧手順、自動トリガー条件、データ復旧計画、エスカレーションマトリクス、コミュニケーション用テンプレートを作成します。
• パターンカタログ — Expand-Contract、Dual-Write、CDC、Strangler Fig、Parallel Run、Canary、Blue-Green。
• リスクフレームワーク — 技術、ビジネス、運用、コンプライアンスのリスクカテゴリ。

使用する場面

• データベース、API、インフラストラクチャ、サービスを、異なるプラットフォームやバージョンへ移行する場合。
• 切り替え前にスキーマ/API の互換性を検証し、破壊的変更を検出する場合。
• ロールバック手順書や、ダウンタイムなしで実行する計画を作成する場合。

まず確認すること

移行を計画する前に、以下の入力を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。

• 移行対象 — データベース、API、インフラストラクチャ、サービスのいずれか（--type と適用するパターンカタログを決定します）
• 成果物 — 段階的な計画、互換性の差分、ロールバック手順書のいずれか（migration_planner.py、compatibility_checker.py、rollback_generator.py のどれを使用するかを決定します）
• 許容ダウンタイムとパターン — ダウンタイムなしの要件と、使用するパターン（expand-contract、dual-write、strangler fig、blue-green）（フェーズと切り替え手法を決定します）

質問の制限：出力を最も左右する2～3項目だけを質問してください。ユーザーが「とりあえず下書きを」と言った場合は作業を進め、成果物の冒頭に前提条件を列挙してください。

ツール

ツール	目的	コマンド
migration_planner.py	リスク評価を含む段階的な移行計画を生成します	python scripts/migration_planner.py --input spec.json --output plan.json --format both
compatibility_checker.py	スキーマ/API を比較し、破壊的変更を検出します	python scripts/compatibility_checker.py --before v1.json --after v2.json --type database
rollback_generator.py	計画からロールバック手順書を生成します	python scripts/rollback_generator.py --input plan.json --output runbook.json --format both

参考資料

タスクに合った参考資料を読み込んでください。このファイルは簡潔に保ち、必要に応じて詳細を参照してください。

• references/workflows-patterns-and-quality.md — クイックスタートコマンド、検証チェックポイントを含む3つの主要なワークフロー、移行パターンのカタログ表、アンチパターン、トラブルシューティング、成功基準を掲載しています。移行を計画するときに読んでください。
• references/tool-reference.md — 3つのスクリプトすべてについて、各ツールの目的、使い方、フラグの表、入力形式、出力構造を詳しく説明しています。スクリプトを実行またはデバッグする前に読んでください。
• references/migration_patterns_catalog.md — 各移行パターンの仕組みとトレードオフを詳しく説明しています。パターンを選択するときに読んでください。
• references/zero_downtime_techniques.md — ダウンタイムなしで切り替える手法（expand-contract、dual-write、トラフィックシフト）を説明しています。許容ダウンタイムがほぼゼロの場合に読んでください。
• references/data_reconciliation_strategies.md — 移行後のデータ整合性を確認するためのチェックサムおよびビジネスロジックによる検証手法を説明しています。移行データを検証するときに読んでください。

対象範囲と制限事項

このスキルで対応する内容：

• 段階的な実行と検証ゲートを含む、データベース、サービス、インフラストラクチャ、API のエンドツーエンドの移行計画。
• スキーマバージョン間の互換性の自動分析（SQL および REST/JSON）。破壊的変更の検出と移行スクリプトの生成を含みます。
• トリガー条件、データ復旧計画、エスカレーションマトリクス、コミュニケーションテンプレートを含む、ロールバック手順書の生成。
• 技術、ビジネス、運用、コンプライアンスの各リスクカテゴリを網羅するリスク評価フレームワーク。

このスキルでは対応しない内容：

• ライブシステムに対する移行の実際の実行。ツールは計画、レポート、スクリプトを生成しますが、データベースやクラウド API には接続しません。
• 新しいスキーマや API に対応するために必要なアプリケーションレベルのコードのリファクタリング。API コントラクトの変更については engineering/api-design-reviewer を、スキーマ設計については engineering/database-designer を参照してください。
• 移行実行中のリアルタイム監視、アラート、ダッシュボードのプロビジョニング。オブザーバビリティの設定については engineering/observability-designer を参照してください。
• 移行先インフラストラクチャのクラウドコスト最適化やキャパシティプランニング。デプロイパイプラインの設定については engineering/ci-cd-pipeline-builder を参照してください。

連携ポイント

スキル	連携内容	データフロー
engineering/database-designer	移行計画の前に移行先スキーマを設計する	移行先スキーマの JSON を compatibility_checker.py --after に渡す
engineering/api-design-reviewer	サービス移行に伴う API コントラクトの変更を検証する	OpenAPI 仕様の差分を compatibility_checker.py --type api に渡す
engineering/observability-designer	移行手順書で参照する監視ダッシュボードを設定する	移行計画の成功指標をアラートルールの定義に反映する
engineering/ci-cd-pipeline-builder	CI/CD ステージに移行検証を組み込む	compatibility_checker.py をパイプラインのステージとして実行し、migration_planner.py --validate でデプロイを制御する
engineering/runbook-generator	運用手順を追加してロールバック手順書を拡張する	rollback_generator.py の出力を詳細な運用手順書の入力として使用する
engineering/release-manager	リリーススケジュールに合わせて移行の切り替えを調整する	移行計画のフェーズとタイムラインを、リリース期間およびフィーチャーフラグのロールアウト段階に合わせる