Menu
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.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
How the SAQ background worker is wired and how to add a new job type. Use when adding, changing, or debugging a background job, JobBatch, or worker task handler.
Styling and design-system conventions — theme colors, MUI usage, typography. Use when styling components, adding colors, or making any visual/design change.
Use when the user provides a GitHub issue/ticket URL (e.g. github.com/Crossbill-Highlights/crossbill-web/issues/NNN) and asks to start working on it — fetches the ticket, moves it to In Progress on the project board, creates a branch, and begins implementation.
Backend testing policy — API-first tiering, assertion depth, and test-quality rules
| 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. |
The architectural rules live in the root CLAUDE.md and always apply; this is
the porting order.
pyright, uv run lint-imports, and the full
pytest suite — all clean