Migrations and Schema Changes
A migration is a controlled, repeatable change to database structure or stored data as the product evolves. Plan schema changes with backups, compatibility, verification, and a recovery path before applying them to production.
What You Will Be Able to Decide
- Explain migrations and schema changes in product and business terms.
- Apply this decision: Plan schema changes with backups, compatibility, verification, and a recovery path before applying them to production.
- Recognise this material risk: a release corrupts data or makes the running application incompatible with its database.
- Ask a consultant for evidence rather than reassurance.
A founder is deciding how the product should remember information and preserve its meaning over time.
A migration is a controlled, repeatable change to database structure or stored data as the product evolves.
A consultant can recommend and implement the technical approach. The founder still needs to decide which outcome matters, which risk is acceptable, and what evidence is sufficient.
The Practical Question
A founder is deciding how the product should remember information and preserve its meaning over time.
The immediate question is migrations and schema changes. The technical label matters only because it changes a product decision, a responsibility, or the evidence required before launch.
Technical term
Migrations and Schema Changes
A migration is a controlled, repeatable change to database structure or stored data as the product evolves.
Treat it like a clause in a commercial agreement: its value comes from making expectations and consequences clear, not from sounding formal.
What a Sound Approach Establishes
Start with the product consequence, then choose the simplest technical treatment that protects it. A longer tool list is not a stronger plan.
For this decision, the useful standard is that the data model can represent the real business rules without ambiguity or silent corruption.
- Make the decision explicit: Plan schema changes with backups, compatibility, verification, and a recovery path before applying them to production.
- Ask what evidence would show that the chosen approach works.
- Name the person or provider responsible when the approach fails.
- Record the result in the data model and recovery plan.
A Decision Framework
Plan schema changes with backups, compatibility, verification, and a recovery path before applying them to production.
The principal risk is that a release corrupts data or makes the running application incompatible with its database. This does not require the most expensive possible solution. It requires the consequence to be understood and the control to match it.
- Describe the user or business outcome that must be protected.
- Identify the most credible failure and its consequence.
- Compare the simplest adequate approach with one realistic alternative.
- Set a review point for when the decision may need to change.
What Confidence Should Be Based On
Warning Signs
- Nobody can explain how migrations and schema changes changes a user or business outcome.
- The proposal does not address this risk: a release corrupts data or makes the running application incompatible with its database.
- The only evidence is a successful demonstration of the easiest path.
- The decision has no named owner, boundary, or review point.
- A provider-specific feature is being mistaken for a permanent product requirement.
Questions to Ask a Consultant
- What decision are we making about migrations and schema changes?
- Which user or business outcome does the recommendation protect?
- How have we reduced or accepted this risk: a release corrupts data or makes the running application incompatible with its database.
- What evidence can I review without relying on the original implementer?
- What is deliberately deferred, and when will it be reconsidered?
- Who owns the accounts, data, documentation, and recovery process?
Key takeaway
Key Takeaway
A migration is a controlled, repeatable change to database structure or stored data as the product evolves. The founder's job is to make the consequence explicit; the consultant's job is to recommend and demonstrate a proportionate implementation.