Handbook
Migration micro-prompt
Plan and implement migration [NAME] for [FEATURE IDs].
Updated
Do not run against production.
Document:
- Current and target model
- Affected tenants/rows/routes/APIs
- Compatibility strategy
- Forward migration
- Backfill and idempotency
- Verification checks
- Performance/locking risk
- Failure detection
- Rollback or restore
- Observability and audit
- User communication and release notes
- Retention/privacy impact
Create a safe dry run using synthetic or sanitized data. Stop if a rollback/restore path is absent for destructive operations. Update the internal wiki, ADR, runbook, traceability, and external migration documentation where users must act.