database-migration is agent-read markdown (skill) from vmobifystudio/app-dev-team: Use before changing any persisted schema — by backend-developer on a server store, by web-developer on a client or server store, and by reliability-engineer when reviewing a change that migrates data. Triggers on the first column, field, index or model change, not on the deploy..
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Database migration
A migration is the one change that **cannot be rolled back by reverting the commit**. Code reverts;
data that has already moved does not. Treat every migration as one-way until you have proven
otherwise.
Where a platform skill exists, use it — `axiom-database-migration`, `axiom-swiftdata-migration`, or
the auditor for your store. **External and optional**; missing → follow this file.
## Before you write it
1. **Enumerate every writer and every reader of the affected data** (`defect-hunting` §1). The
migration that stops one layer short is FC-001, and this is the surface where it costs most.
2. **Name the old and new shape explicitly**, including what happens to rows that violate the new
constraint *today*. There are always some.
3. **Decide expand or contract.** Almost always expand first:
- *Expand*: add the new column nullable, write both, backfill, read new with fallback to old.
- *Contract*: only after every deployed client and server writes the new shape. On mobile that
means **after the oldest supported app version is gone**, which is months, not the next sprint.
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_brww3elljh7w2bgy
GET https://markdownregistry.com/api/v1/resolve?ref=vmobifystudio/app-dev-team/database-migration
GET https://markdownregistry.com/api/v1/blob/a6ea84bb9256ce71cd9ddca7e693d6d50f32441629eafff05719a9ae2376a53c
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
vmobifystudio/app-dev-team · skills/accessibility-gate/SKILL.md · Use as a pass/fail gate on any diff with a user-facing surface — by code-reviewer during review, by qa-engineer during…
vmobifystudio/app-dev-team · skills/agent-isolation/SKILL.md · Use before spawning any agent that writes files, and by every developer/fixer agent as its first and last action. Gives…
vmobifystudio/app-dev-team · skills/architecture-builder/SKILL.md · Use to produce the technical architecture doc and engineering principles for a mobile app. Used primarily by the CTO…
vmobifystudio/app-dev-team · skills/board-doctor/SKILL.md · Use to validate docs/31-board.md before spawning any agent, and to verify a developer's "DONE" claim before moving a…
vmobifystudio/app-dev-team · skills/brownfield-onboarding/SKILL.md · Use when pointing the team at an EXISTING, already-built app instead of a blank project — detects the stack…
vmobifystudio/app-dev-team · skills/business-model/SKILL.md · Use when deciding or revisiting how the product makes money — pricing, tiers, trial shape, ad load, unit economics — by…
vmobifystudio/app-dev-team · skills/content-design/SKILL.md · Use when writing or reviewing any string a user reads — labels, buttons, empty states, errors, permission prompts…
vmobifystudio/app-dev-team · skills/context-preflight/SKILL.md · Run before changing a repository to verify branch, worktree, ticket, dependencies, source-of-truth documents, and…
vmobifystudio/app-dev-team · skills/defect-hunting/SKILL.md · Use when reviewing code, auditing an app, writing a guard rule or test, or certifying any threshold/constant/formula…
vmobifystudio/app-dev-team · skills/design-system/SKILL.md · Use when defining or extending design tokens and the shared component library — by product-designer when writing…
wshobson/agents · plugins/framework-migration/skills/database-migration/SKILL.md · Execute database migrations across ORMs and platforms with zero-downtime strategies, data transformation, and rollback…
dicklesworthstone/pi_agent_rust · tests/ext_conformance/artifacts/agents-wshobson/framework-migration/skills/database-migration/SKILL.md · Execute database migrations across ORMs and platforms with zero-downtime strategies, data transformation, and rollback…
rudycity/superagent · .agents/skills/database-migration/SKILL.md · Execute database migrations across ORMs and platforms with zero-downtime strategies, data transformation, and rollback…
