Database Health

Use this skill when

Use when editing lib/schema.ts, generating migrations, checking schema drift, validating the migration journal, or preparing schema changes for promotion.

Workflow

1. Never run db:push or drizzle-kit push against hosted environments.
2. Run scripts/check-db-health.sh before risky database work.
3. Generate migrations with bun run db:generate.
4. Commit migration SQL and let Vercel apply hosted migrations.

Skill graph

Read references/graph.md for routing. Related skills: fork-build-deploy, run-quality-gates, promote-deployment, neon-branch-management, add-api-endpoint.

For Neon branch routing (which Vercel env points at which Neon branch, the staging-as-default integration quirk, pooled vs unpooled URL pairing) delegate to neon-branch-management. This skill handles schema and migration safety; routing is a different failure mode.

References

• references/workflow.md: workflow details and decision points.
• references/graph.md: related skills and handoff boundaries.
• references/original-guide.md: full prior guide for deeper context.

Scripts

See scripts/README.md. Execute scripts when the workflow calls for deterministic inspection or validation.

Assets

See assets/README.md for templates/checklists.