| 1 | # Migration Annotations |
| 2 | |
| 3 | Add or update one YAML file per v3 module under `migration/annotations/`. Use |
| 4 | stable API IDs without trailing `#type` or `#value` facets: |
| 5 | |
| 6 | ```yaml |
| 7 | effect/Effect#async: |
| 8 | replacement: Effect.callback |
| 9 | note: Use the callback constructor. |
| 10 | example: Effect.callback((resume) => resume(Effect.void)) |
| 11 | ``` |
| 12 | |
| 13 | Every annotation requires `replacement` and `note`; `example` is optional. Use |
| 14 | `replacement: none` when there is no direct replacement and explain the |
| 15 | supported migration strategy instead of inventing an equivalent API. |