ln-720-structure-migrator

SKILL.md

Paths: File paths (references/, ../ln-*) are relative to this skill directory.

ln-720-structure-migrator

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

Coordinates project restructuring to Clean Architecture. Mode-aware: delegates to workers with appropriate mode parameters based on CREATE/TRANSFORM pipeline.

Purpose & Scope

Aspect
Description

Input
Current project structure + mode (CREATE/TRANSFORM) from ln-700

Output
Restructured project with Clean Architecture

Workers
See Workers table below

Workers

Worker
Role
CREATE mode
TRANSFORM mode

ln-721
Frontend structure
SCAFFOLD (generate starter)
RESTRUCTURE (migrate monolith)

ln-722
Backend generator
RUN (generate backend)
RUN (generate backend)

ln-723
Seed data
GENERATE (from entities)
MIGRATE (from ORM schemas)

ln-724
Artifact cleaner
SKIP (no artifacts)
CONDITIONAL (only if platform detected)

Scope boundaries:

Analyzes current project structure (TRANSFORM) or accepts target config (CREATE)

Generates migration plan or scaffold plan

Delegates to specialized workers via Agent tool

Verifies final result

Workflow

Phase
Name
CREATE mode
TRANSFORM mode

1
Analyze
Receive target stack config
Scan structure, detect framework, map files

2
Plan
Calculate scaffold actions
Calculate moves, identify conflicts

3
Execute
Delegate: ln-721 SCAFFOLD → ln-722 → ln-723 GENERATE
Delegate: ln-724 (conditional) → ln-721 RESTRUCTURE → ln-722 → ln-723 MIGRATE

4
Verify
Check file structure, validate configs
Run builds, check imports, validate structure

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 (Artifact Cleaner)

When to invoke: TRANSFORM mode AND platform artifacts detected (.replit, .stackblitzrc, sandbox.config.json, glitch.json).
Skip conditions: CREATE mode OR no platform config files found.

Context:
  projectPath: /project
  skipPreview: false
Options:
  # ln-724 auto-detects platform, no need to specify
  cleanConfigFiles: true
  cleanDirectories: true
  cleanPackages: true
  cleanBuildConfig: true
  cleanCodeComments: true
  cleanGitignore: true

To ln-721 (Frontend)

Context:
  mode: SCAFFOLD | RESTRUCTURE          # From pipeline mode
  # SCAFFOLD mode:
  targetPath: /project/src/frontend
  projectName: MyApp
  # RESTRUCTURE mode:
  sourcePath: /project/client
  targetPath: /project/src/frontend
  framework: react
  features:
    - Dashboard
    - Settings
    - Profile
Options:
  # RESTRUCTURE only:
  splitMonolithicFiles: true
  extractConstants: true
  extractTypes: true
  createComponentLibrary: true

To ln-722 (Backend)

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

To ln-723 (Seed Data)

Context:
  mode: MIGRATE | GENERATE              # From pipeline mode
  targetFormat: csharp | typescript | python | json | sql
  # MIGRATE mode:
  sourceORM: auto                        # Auto-detect (drizzle/prisma/typeorm/efcore/sqlalchemy/django)
  sourcePath: /project/references/schema.ts
  # GENERATE mode:
  entities:                              # Optional — if empty, starter template used
    - name: User
      fields: [id, name, email, role, createdAt]
    - name: Role
      fields: [id, name, description]
  targetPath: /project/src/MyApp.Api/MockData

Critical Rules

Orchestrator Pattern: Analyze and delegate via Skill tool, do not execute transformations directly

Mode Awareness: Pass correct mode to all workers — CREATE vs TRANSFORM determines worker behavior

Conditional Workers: ln-724 runs ONLY in TRANSFORM mode when platform artifacts detected; SKIP otherwise

Sequential Workers: Execute in order (ln-724 conditional → ln-721 → ln-722 → ln-723)

Pre-flight Checks: Verify git status clean, target paths available

No Data Loss: Copy before delete, verify before removing source (TRANSFORM mode)

Build Verification: All builds must pass (npm run build, dotnet build)

Rollback Ready: Keep backup branch until verification complete (TRANSFORM mode)

Invocations:

Skill(skill: "ln-724-artifact-cleaner", args: "{projectPath}")  # TRANSFORM only, conditional
Skill(skill: "ln-721-frontend-restructure", args: "{projectPath} --mode {SCAFFOLD|RESTRUCTURE}")
Skill(skill: "ln-722-backend-generator", args: "{projectPath}")
Skill(skill: "ln-723-seed-data-generator", args: "{projectPath} --mode {GENERATE|MIGRATE}")

TodoWrite format (mandatory):

- Invoke ln-724-artifact-cleaner (conditional TRANSFORM) (pending)
- Invoke ln-721-frontend-restructure (pending)
- Invoke ln-722-backend-generator (pending)
- Invoke ln-723-seed-data-generator (pending)
- Verify structure and builds (pending)

Worker Invocation (MANDATORY)

Host Skill Invocation: Skill(skill: "...", args: "...") is mandatory delegation.

Claude: call the Skill tool exactly as shown.

Codex: if no Skill tool exists, locate the named skill in available skills, read its SKILL.md, treat args as $ARGUMENTS, execute that skill workflow, then return here with its result/artifact.

Do not inline worker logic or mark the worker complete without executing the target skill.

Phase
Worker
Context

3a
ln-724-artifact-cleaner
Shared (Skill tool) — remove platform artifacts (TRANSFORM only, conditional)

3b
ln-721-frontend-restructure
Shared (Skill tool) — scaffold or restructure frontend

3c
ln-722-backend-generator
Shared (Skill tool) — generate backend project structure

3d
ln-723-seed-data-generator
Shared (Skill tool) — generate or migrate seed data

All workers: Invoke via Skill tool — workers see coordinator context.

Definition of Done

CREATE mode:

 Target stack config received from ln-700

 ln-721 completed: Frontend scaffolded (SCAFFOLD mode)

 ln-722 completed: Backend generated

 ln-723 completed: Seed data generated (GENERATE mode)

 File structure matches target templates

 All configs valid (package.json, tsconfig.json, .csproj)

TRANSFORM mode:

 Current structure analyzed and documented

 Migration plan generated

 ln-724 completed: Platform artifacts removed (if applicable)

 ln-721 completed: Frontend restructured (RESTRUCTURE mode)

 ln-722 completed: Backend generated

 ln-723 completed: Seed data migrated (MIGRATE mode)

 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

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

Wrong worker mode
Mode mismatch
Validate mode parameter before delegation

Reference Files

File
Purpose

references/clean_architecture_dotnet.md
.NET project structure template

references/frontend_structure.md
React project structure template

Meta-Analysis

Optional reference: load references/meta_analysis_protocol.md only when the user asks for post-run meta-analysis or protocol-formatted run reflection.

Skill type: execution-orchestrator. When requested, run after all phases complete. Output to chat using the execution-orchestrator format.

Version: 3.0.0
Last Updated: 2026-02-07