domain-refactor-cutover-strategy
Domain Refactor Cutover Strategy
Guides multi-phase domain renames across the monorepo (backend, frontend, shared contracts). Derived from the Phase 4 mc→creator cutover (S1–S4).
When to Use
- Planning a rename that spans DB models, API contracts, backend services, and frontend features.
- Reviewing or extending an in-progress cutover scope branch.
- Deciding whether to add backward-compatibility aliases vs. direct rename.
Core Principles
- Scope isolation: One branch per scope, one scope at a time. Merge to
masterbefore starting the next. - Contract-first: Rename shared contracts (
@eridu/api-types) before backend consumers, backend before frontend. - DB internals last (or never): Prisma model names and DB columns are expensive to rename (migration + backfill). Prefer keeping DB internals stable and renaming at the service/API boundary.
- No net-new features: Cutover scopes are rename/refactor only. Defer product changes to post-cutover branches.
Phase Ordering
More from allenlin90/eridu-services
service-pattern-nestjs
Comprehensive NestJS service implementation patterns. This skill should be used when implementing Model Services, Orchestration Services, or business logic with NestJS decorators.
8erify-authorization
Patterns for implementing authorization in erify_api with current StudioMembership + AdminGuard behavior, plus planned RBAC references
6data-validation
Provides comprehensive guidance for input validation, data serialization, and ID management in backend APIs. This skill should be used when designing validation schemas, transforming request/response data, mapping database IDs to external identifiers, and ensuring type safety across API boundaries.
6code-quality
Provides general code quality and best practices guidance applicable across languages and frameworks. Focuses on linting, testing, and type safety.
6repository-pattern-nestjs
Comprehensive Prisma repository implementation patterns for NestJS. This skill should be used when implementing repositories that extend BaseRepository or use Prisma delegates.
6task-template-builder
Provides guidelines for the Task Template Builder architecture, including Schema alignment, Draft storage, Drag-and-Drop, and Validation logic.
6