gastrobrain-database-migration

Automate checkpoint-driven SQLite database migrations for Flutter apps.

1|Updated Feb 12, 2025
One-click install
npx skills add https://github.com/alemdisso/gastrobrain --skill gastrobrain-database-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gastrobrain-database-migration
Source: https://github.com/alemdisso/gastrobrain/tree/main/.claude/skills/gastrobrain-database-migration
Command: npx skills add https://github.com/alemdisso/gastrobrain --skill gastrobrain-database-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables safe, checkpoint-driven database migrations for Flutter and Dart projects. By breaking changes into a sequence of verifiable steps, it minimizes the risk of data loss, ensures rollback safety, and keeps models, schemas, and seed data in sync.

Core Features & Use Cases

  • Checkpoint planning: Break migrations into 4–7 verifiable checkpoints with explicit success criteria.
  • One-checkpoint-at-a-time execution: Implement, verify, and proceed only after successful validation.
  • Rollback safety: Dedicated rollback checkpoint ensures changes can be reverted cleanly.
  • End-to-end testing: Includes migration tests that cover schema, data, and model consistency.
  • Scope: Applies to schema changes, new tables, column additions, or data migrations in SQLite-backed Flutter apps.

Quick Start

From Claude Code, invoke the skill: /gastrobrain-database-migration

Frequently Asked Questions about gastrobrain-database-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform safe database migrations in Flutter without losing data?

Safe database migrations in Flutter use a checkpoint-driven approach, breaking schema changes into 4–7 verifiable steps with explicit validation between each phase. This minimizes data loss risk by proceeding only after successful validation and keeping models, schemas, and seed data synchronized.

What is checkpoint-driven migration and how does it handle rollbacks in SQLite?

Checkpoint-driven migration sequentially applies database changes, verifying each step before proceeding. It includes a dedicated rollback checkpoint within the sequence, ensuring that schema modifications, column additions, or data migrations in SQLite can be cleanly reverted if validation fails.

Can I use this migration approach for adding columns and new tables in a Dart app?

Yes, this migration approach supports schema changes, new table creation, column additions, and data migrations in SQLite-backed Flutter and Dart apps. It requires a compatible migration runner and access to roadmap documents to plan the verifiable checkpoints.

How do I plan and verify database schema changes step by step?

Planning database schema changes involves breaking migrations into 4–7 checkpoints with defined success criteria. You implement, verify, and proceed one checkpoint at a time, running end-to-end tests covering schema, data, and model consistency before moving to the next step.

Do I need a specific migration runner to execute SQLite migrations in Flutter?

Yes, executing SQLite migrations in Flutter requires a migration runner compatible with Dart. You also need SQLite configured in your application and access to roadmap documents to plan and sequence the verifiable migration checkpoints.