Migration
Purpose
Design or execute a staged, observable, reversible transition with explicit compatibility windows, validation, and cleanup.
Workspace protocol
Read references/workspaces.md once per agent task before selecting or creating workflow artifacts; reuse it unless repository scope or task authority changes. This skill owns only the task-specific behavior below.
Inputs
- Source and target states, invariants, data volume, traffic, and downtime tolerance
- Producers, consumers, schemas, deployment topology, ownership, and operational constraints
- Backfill, rollback, compliance, and retention requirements
Outputs
- Migration phases, compatibility strategy, validation, monitoring, rollback, and cleanup criteria
- If execution is authorized: migrations, adapters, backfills, tests, and runbook changes
- Reconciliation evidence and remaining risk
Rules
- Inspect all readers and writers before changing shared state.
- Prefer expand-migrate-contract for live systems: introduce compatibility, move traffic or data, verify, then remove old paths.
- Make reruns idempotent and define partial-failure recovery.
- Validate counts plus business invariants; do not treat command success as data correctness.
- Separate source implementation from production execution authorization.
- Preserve backups and rollback paths appropriate to impact.
Decision-log updates
Record compatibility windows, cutover criteria, data ownership, transformation rules, rollback limits, accepted downtime, and irreversible checkpoints. Link evidence for completing each phase.
When durable state is approved, append compatibility, sequencing, rollback, and point-of-no-return choices to the selected work item's decisions.md; otherwise include them in the final response.
Escalate to the human
Escalate before destructive or irreversible steps, production backfills or cutovers, downtime, data loss or semantic ambiguity, privacy-sensitive movement, or rollback beyond the stated tolerance.
1---2name: migration3description: Use when data, schema, API, dependency, platform, infrastructure, or runtime state must move between versions or systems while preserving service and recoverability.4---56# Migration78## Purpose910Design or execute a staged, observable, reversible transition with explicit compatibility windows, validation, and cleanup.1112## Workspace protocol1314Read `references/workspaces.md` once per agent task before selecting or creating workflow artifacts; reuse it unless repository scope or task authority changes. This skill owns only the task-specific behavior below.1516## Inputs1718- Source and target states, invariants, data volume, traffic, and downtime tolerance19- Producers, consumers, schemas, deployment topology, ownership, and operational constraints20- Backfill, rollback, compliance, and retention requirements2122## Outputs2324- Migration phases, compatibility strategy, validation, monitoring, rollback, and cleanup criteria25- If execution is authorized: migrations, adapters, backfills, tests, and runbook changes26- Reconciliation evidence and remaining risk2728## Rules2930- Inspect all readers and writers before changing shared state.31- Prefer expand-migrate-contract for live systems: introduce compatibility, move traffic or data, verify, then remove old paths.32- Make reruns idempotent and define partial-failure recovery.33- Validate counts plus business invariants; do not treat command success as data correctness.34- Separate source implementation from production execution authorization.35- Preserve backups and rollback paths appropriate to impact.3637## Decision-log updates3839Record compatibility windows, cutover criteria, data ownership, transformation rules, rollback limits, accepted downtime, and irreversible checkpoints. Link evidence for completing each phase.40When durable state is approved, append compatibility, sequencing, rollback, and point-of-no-return choices to the selected work item's decisions.md; otherwise include them in the final response.4142## Escalate to the human4344Escalate before destructive or irreversible steps, production backfills or cutovers, downtime, data loss or semantic ambiguity, privacy-sensitive movement, or rollback beyond the stated tolerance.
nono911