Search & research
migrate-domain
Create, inspect, apply, or roll back Alembic migrations for a domain while treating autogenerated revisions as review-required output.
Mr-DooSun · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add Mr-DooSun/fastapi-agent-blueprint --skill migrate-domainAbout this skill
name: migrate-domain description: Create, inspect, apply, or roll back Alembic migrations for a domain while treating autogenerated revisions as review-required output. metadata: short-description: Alembic migration workflow
Migrate Domain
Default Flow Position
- Step:
implement+ feedsverify(alembic upgrade head+/test-domain {name} run) approach optionsupstream conditional — required for indexed-column changes, constraint alterations, or backfills- Recursion guard: n/a (manual user invocation only)
Procedure
- Read
docs/ai/shared/skills/migrate-domain.mdfor the full procedure. - Confirm the requested action:
generate,upgrade,downgrade, orstatus. - Verify the target model change and environment configuration first.
- For
generate, create the revision and review before applying. - Treat autogenerate output as a draft: renames and destructive changes need manual review.
- Run the zero-downtime safety review:
tools/check_migration_safety.py(advisory, ADR 056) flags lock-taking / compatibility-breaking DDL against pre-existing tables; apply the safe alternative fromdocs/operations/rdb-migrations.md. - Verify the resulting revision state and recommend integration tests.