| name | ddd-migration |
| description | Step-by-step checklist for migrating a backend service to the DDD/hexagonal architecture. Use when porting an existing service, repository, or router to domain entities and repository protocols. |
DDD Migration Checklist
The architectural rules live in the root CLAUDE.md and always apply; this is
the porting order.
- Read the migration plan document if one exists
- Create domain entities/value objects in the domain layer
- Create/update the repository in the infrastructure layer (all ORM code moves here)
- Convert the application service to work with domain entities
- After any file deletion or move, grep for the old import paths and update them
- Verify before declaring done:
pyright, uv run lint-imports, and the full
pytest suite — all clean