1
# Migration Review
2
3
A migration is reviewed like code and behaves like a deployment. The failures that
4
matter are not syntax errors, they are the exclusive lock taken on the busiest table at
5
peak, and the column dropped in the same deploy as the code that stopped using it. This
6
workflow checks the things that cause outages.
7
8
## When to use
9
10
- Any schema change against a database with real data.
11
- Before approving a migration in review.
12
- Especially for tables large enough that a table rewrite is measured in minutes.
13
14
## Install
15
16
```bash
17
npx openagents-cli add openagents/db-migration-review
18
```
19
20
| Runtime | Installed to |
21
|---|---|
22
| `claude-code` | `.claude/skills/db-migration-review/` |
23
| `cursor` | `.cursor/rules/db-migration-review/` |
24
| `codex` | `.codex/skills/db-migration-review/` |
25
| `generic` | `.openagents/db-migration-review/` |
26
27
## What is in the package
28
29
- `WORKFLOW.md` - the review, in order of what causes outages.
30
- `patterns.md` - safe recipes for the changes that are usually done unsafely.
31
32
## License
33
34
MIT
35