Ln 720 Structure Migrator

ln-720-structure-migrator

Type: L2 Domain Coordinator Category: 7XX Project Bootstrap Parent: ln-700-project-bootstrap

Coordinates project restructuring from prototype layout to Clean Architecture.

---

Purpose & Scope

Scope boundaries:

• Analyzes current project structure
• Generates migration plan
• Delegates to specialized workers
• Verifies final result

---

Workflow

---

Target Structures

Frontend (React)

src/​frontend/
├── public/
├── src/
│   ├── components/
│   │   ├── layout/      # AppLayout, Header, Sidebar
│   │   └── ui/          # Reusable UI components
│   ├── contexts/        # React contexts
│   ├── hooks/           # Custom hooks
│   ├── lib/             # Utilities, API clients
│   ├── pages/           # Page components
│   │   └── {Feature}/   # Feature-specific files
│   ├── App.tsx
│   ├── main.tsx
│   └── index.css
├── package.json
├── vite.config.ts
└── tsconfig.json

Backend (.NET Clean Architecture)

src/
├── {Project}.Api/
│   ├── Controllers/
│   ├── DTOs/
│   ├── Middleware/
│   ├── MockData/
│   ├── Extensions/
│   ├── Program.cs
│   └── appsettings.json
├── {Project}.Domain/
│   ├── Entities/
│   ├── Enums/
│   └── Common/
├── {Project}.Services/
│   └── Interfaces/
├── {Project}.Repositories/
│   └── Interfaces/
└── {Project}.Shared/

---

Delegation Protocol

To ln-724 (Replit Cleanup)

Context:
  projectPath: /​project
  skipPreview: false  # Set true for automated pipelines
Options:
  cleanConfigFiles: true      # .replit, replit.nix
  cleanDirectories: true      # .local/, .cache/, .upm/
  cleanPackages: true         # @replit/​* from package.json
  cleanViteConfig: true       # Replit imports/​plugins
  cleanCodeComments: true     # // @replit annotations
  cleanGitignore: true        # .replit entry

To ln-721 (Frontend)

Context:
  sourcePath: /​project/​client
  targetPath: /​project/​src/​frontend
  framework: react
  features:
    - ProductPlanning
    - Settings
    - Profile
Options:
  splitMonolithicFiles: true
  extractConstants: true
  extractTypes: true
  createComponentLibrary: true

To ln-722 (Backend)

Context:
  projectName: Kehai
  targetPath: /​project/​src
  targetFramework: net10.0
  features:
    - ProductPlanning
    - Users
Options:
  createMockData: true
  addSwagger: true
  addHealthChecks: true

To ln-723 (MockData)

Context:
  sourceORM: drizzle
  sourcePath: /​project/​shared/​schema.ts
  targetPath: /​project/​src/​Kehai.Api/​MockData
  entities:
    - Epic
    - Story
    - Bet

---

Critical Rules

• Orchestrator Pattern: Analyze and delegate, do not execute transformations directly
• Sequential Workers: Execute workers in order (replit-cleanup → frontend → backend → mockdata)
• Pre-flight Checks: Verify git status clean, target paths available
• No Data Loss: Copy before delete, verify before removing source
• Build Verification: Both npm run build and dotnet build must pass
• Rollback Ready: Keep backup branch until verification complete

---

Definition of Done

• Current structure analyzed and documented
• Migration plan generated
• ln-724 completed: Replit artifacts removed
• ln-721 completed: Frontend restructured
• ln-722 completed: Backend generated
• ln-723 completed: MockData migrated
• Frontend builds successfully (npm run build)
• Backend builds successfully (dotnet build)
• No orphan files in old locations
• All imports resolve correctly
• Migration report generated

---

Risk Mitigation

---

Reference Files

---

Version: 2.0.0 Last Updated: 2026-01-10