module-by-module-migration

Plan and execute dependency-ordered module migration from JavaScript to TypeScript.

Updated Jul 17, 2017
One-click install
npx skills add https://github.com/luyi985/lyi-bash --skill module-by-module-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: module-by-module-migration
Source: https://github.com/luyi985/lyi-bash/tree/main/ai/skills/module-by-module-migration
Command: npx skills add https://github.com/luyi985/lyi-bash --skill module-by-module-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrating large JavaScript codebases to TypeScript without breaking dependencies requires a methodical, module-level approach that minimizes integration risk.

Core Features & Use Cases

  • Dependency-aware planning: migrate modules in leaf-to-root order to preserve typings and reduce churn.
  • Scoped migration: convert individual modules and their immediate dependencies before broader changes.
  • Team coordination: aligns migration milestones with team capacity and release windows.

Quick Start

Analyze leaf modules (with no dependencies) and convert them first, then migrate dependents in dependency order.

Frequently Asked Questions about module-by-module-migration

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

FAQPage Schema
What is the best way to migrate a large JavaScript codebase to TypeScript without breaking dependencies?

Migrate a large JavaScript codebase to TypeScript using a module-by-module approach, converting leaf modules first and progressing to dependents in dependency order to preserve typings and minimize integration risk.

How do I plan a JavaScript to TypeScript migration for a large codebase?

Plan a JavaScript to TypeScript migration by mapping the dependency graph, identifying leaf modules with no dependencies, and scheduling conversions in leaf-to-root order while aligning milestones with team capacity and release windows.

Why should I migrate TypeScript files module-by-module instead of all at once?

Migrate TypeScript files module-by-module to minimize integration risk and reduce churn. Converting individual modules and their immediate dependencies before broader changes prevents breaking existing JavaScript dependencies during the transition.

How do I coordinate team capacity during a large codebase migration to TypeScript?

Coordinate team capacity during a large codebase migration to TypeScript by aligning migration milestones with team capacity and release windows, ensuring scoped module conversions proceed without disrupting broader development.

When do I need to use a dependency graph for a JavaScript to TypeScript migration?

Use a dependency graph for a JavaScript to TypeScript migration when managing large codebases to determine leaf-to-root conversion order, ensuring modules with no dependencies are converted first before their dependents.

Can I convert individual modules and their immediate dependencies before migrating the rest of the codebase?

Yes, you can convert individual modules and their immediate dependencies before broader changes. This scoped migration approach isolates TypeScript integration to specific codebase sections, minimizing churn and integration risk.