# Migrations

> 大版本迁移指南。

## 放什么

- 大版本切换的操作手册（v0 → v1，v1 → v2 等）
- 数据库 schema 大变更的迁移脚本说明
- 依赖大升级的 breaking change 总结
- 配置文件格式变更的 upgrade 指南

## 不放什么

- 小版本变更（patch / minor）→ CHANGELOG / git log 即可
- 单次决策的理由 → ADR

## 命名约定

`<from>-to-<to>.md`，例如：

- `v0-to-v1.md`
- `auth-v1-to-v2.md`（局部 schema 升级）

## 标准结构

```
# v<X> → v<Y> Migration

## Why
<为什么要 migrate>

## Breaking changes
- ...

## Step-by-step
1. ...
2. ...

## Rollback plan
<出问题怎么回退>

## Verification
<怎么确认 migration 成功>
```

> 此目录由 koala-core init 创建。删除本 README 或保留作为指引——你的选择。
