ln-720-structure-migrator

统筹项目结构向整洁架构的迁移

SKILL.md

--- frontmatter

name: ln-720-structure-migrator
description: Coordinates project structure migration to Clean Architecture

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

Aspect	Description
Input	Current project structure, target architecture
Output	Restructured project with Clean Architecture
Workers	ln-721 (frontend), ln-722 (backend), ln-723 (mockdata), ln-724 (replit-cleaner)

Scope boundaries:

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

Worker Invocation

CRITICAL: All delegations use Task tool with subagent_type: "general-purpose" for context isolation.

Worker	Purpose
ln-721-frontend-restructure	Restructure React frontend
ln-722-backend-generator	Generate .NET Clean Architecture
ln-723-mockdata-migrator	Migrate mock data from Drizzle
ln-724-replit-cleaner	Remove Replit artifacts

Prompt template:

code

Task(description: "Migrate via ln-72X",
     prompt: "Execute ln-72X-{worker}. Read skill from ln-72X-{worker}/SKILL.md. Context: {delegationContext}",
     subagent_type: "general-purpose")

Anti-Patterns:

•❌ Direct Skill tool invocation without Task wrapper
•❌ Any execution bypassing subagent context isolation

Workflow

Phase	Name	Actions	Output
1	Analyze	Scan current structure, detect framework, map files	File inventory
2	Plan	Calculate moves, identify conflicts	Migration plan
3	Execute	Delegate to workers (ln-724, ln-721, ln-722, ln-723) via Task tool	Restructured project
4	Verify	Run builds, check imports, validate structure	Success report

Target Structures

Frontend (React)

code

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)

code

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)

yaml

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)

yaml

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)

yaml

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

To ln-723 (MockData)

yaml

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

Risk Mitigation

Risk	Detection	Mitigation
Uncommitted changes	`git status` not clean	Require clean working directory
Build failure (frontend)	`npm run build` fails	Rollback, delegate to ln-721 for fix
Build failure (backend)	`dotnet build` fails	Rollback, delegate to ln-722 for fix
Lost files	Files missing after migration	Restore from backup branch
Import errors	Module not found	Re-run import update phase
Partial migration	Worker fails mid-execution	Atomic: complete all or rollback all

Reference Files

File	Purpose
`references/clean_architecture_dotnet.md`	.NET project structure template
`references/frontend_structure.md`	React project structure template

Version: 2.0.0 Last Updated: 2026-01-10