Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
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-domain

About 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 + feeds verify (alembic upgrade head + /test-domain {name} run)
  • approach options upstream conditional — required for indexed-column changes, constraint alterations, or backfills
  • Recursion guard: n/a (manual user invocation only)

Procedure

  1. Read docs/ai/shared/skills/migrate-domain.md for the full procedure.
  2. Confirm the requested action: generate, upgrade, downgrade, or status.
  3. Verify the target model change and environment configuration first.
  4. For generate, create the revision and review before applying.
  5. Treat autogenerate output as a draft: renames and destructive changes need manual review.
  6. 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 from docs/operations/rdb-migrations.md.
  7. Verify the resulting revision state and recommend integration tests.