migration-planner

Plans phased multi-PR Android migrations with coexistence strategies, safety nets, and rollback paths.

Updated Jan 2, 2024
One-click install
npx skills add https://github.com/Mithrandir21/game-deals-app --skill migration-planner-mithrandir21
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: migration-planner
Source: https://github.com/Mithrandir21/game-deals-app/tree/main/.claude/skills/migration-planner
Command: npx skills add https://github.com/Mithrandir21/game-deals-app --skill migration-planner-mithrandir21

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large Android migrations (Views to Compose, Dagger to Hilt, RxJava to Coroutines) fail when attempted as one giant PR, when they freeze the codebase, or when there is no rollback path. This Skill produces a phased migration plan that lets the team keep shipping while the migration runs in parallel. ## Core Features & Use Cases - Phased planning: Generates a 3-5 phase plan (Foundation, Bridge, Scale out, Remove bridge, Cleanup) where each phase is mergeable, reversible, and independently assignable. - Coexistence strategies: Provides concrete interop mechanisms per migration type, such as ComposeView inside XML, Flow.asLiveData() bridging, and Hilt running alongside Dagger. - Safety nets and communication: Defines feature flags, telemetry tagging, baseline tests, rollback per phase, and team rules that stop new code from using the old pattern. - Use Case: When a developer says "we need to kill RxJava" or "migrate to Compose", the Skill outputs a migration document with a definition of done, phase breakdown, risk assessment, and team rules. ## Quick Start Ask the assistant to plan a phased migration from Dagger to Hilt for this Android project without freezing ongoing feature work.

Frequently Asked Questions about migration-planner

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

FAQPage Schema
How do I migrate an Android app from Views to Jetpack Compose incrementally?▼

Use a coexistence strategy: embed ComposeView inside existing XML layouts and AndroidView inside Compose, then convert feature by feature. Phase the work into foundation, bridge, scale-out, and cleanup PRs, and add a CI rule blocking new XML layouts.

How to migrate from Dagger to Hilt without a big bang rewrite?▼

Hilt runs on top of Dagger, so both can coexist side-by-side. Add Hilt entry points like @AndroidEntryPoint in Activities and Fragments while existing Dagger components remain, then convert scope by scope and delete the old components last.

Can LiveData and Kotlin Flow coexist during a migration?▼

Yes, Flow.asLiveData() and LiveData.asFlow() bridge both directions, so you can migrate leaf by leaf. Remember that StateFlow needs repeatOnLifecycle or collectAsStateWithLifecycle to match LiveData's lifecycle awareness.

When should I not use a phased migration plan?▼

Skip the full planning process for one-file conversions or changes touching fewer than five files; just do them directly. The phased approach is designed for changes affecting multiple modules or team members' workflows.

Why do big bang migration PRs fail on Android projects?▼

A single PR with hundreds of changed files is impossible to review or revert and freezes the codebase for months. Phased migrations keep each step mergeable and reversible, with telemetry and feature flags to detect regressions early.