migration

Automate large-scale TypeScript code migration with import path rewrites and validation checks.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/sihu-dev/forge-labs --skill migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migration
Source: https://github.com/sihu-dev/forge-labs/tree/main/apps/hephaitos/.claude/skills/migration
Command: npx skills add https://github.com/sihu-dev/forge-labs --skill migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a structured approach to large-scale code migrations, mapping legacy structures to new architectures with path mappings.

Core Features & Use Cases

  • Phased Migration: Aligns with nano-factored layers and path aliasing.
  • Collision Resolution: Strategies to resolve import conflicts during migration.
  • Use Case: Migrate a monorepo to a new package layout with minimal friction.

Quick Start

Use the migration skill to generate a migration plan and execute staged updates.

Frequently Asked Questions about migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate a codebase to a new architecture with automated path rewrites?

Large-scale codebase migration automates the process of moving code to a new architecture while rewriting import paths according to predefined mappings. This Skill guides migration through nano-factored layers (Atoms to Tissues), applies TypeScript type-system-first conventions, and validates compilation and tests to ensure the refactored codebase maintains integrity.

What's the structured approach to migrating a monorepo to a new package layout?

Phased migration aligns your codebase with nano-factored layers and path aliasing conventions. The migration plan stages utilities, core services, and agents in order, resolves import conflicts through collision strategies, and applies file mappings with import alias rewrites across your entire codebase.

Can I migrate forge-labs projects into the Hephaitos architecture with validation checks?

Yes. This Skill automates migration of forge-labs projects into Hephaitos architecture following L0-L3 nano-factor layering, applies prescribed file mappings and import conventions, and includes validation checks for TypeScript compilation, test suites, and build verification to ensure successful refactoring.

How do I resolve import path conflicts during large-scale code refactoring?

Collision resolution strategies are built into the phased migration process. The Skill handles import path rewrites and conflict resolution as part of staged updates, ensuring that dependencies are migrated in the correct order and import aliases follow the prescribed conventions throughout your refactored codebase.

What validation happens after migrating import paths and file structures?

Post-migration validation checks TypeScript compilation for type-system correctness, runs test suites to verify functional integrity, and executes build processes to confirm the refactored codebase is production-ready. This ensures minimal friction and catches issues before deployment.