К основному содержанию
скилл CX Codex

legacy-migration-planner — скилл Claude Code: установка

Скилл legacy-migration-planner планирует миграцию легаси-систем, модернизацию кодовой базы и разбиение монолита. Он пригодится до начала работ, когда нужен план перехода.

CC-BY-4.0 ★ 7 191 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add tech-leads-club/agent-skills --skill legacy-migration-planner -a claude-code
Открыть на GitHub

Что делает legacy-migration-planner

Скилл проводит миграцию в две фазы: RESEARCH и PLAN. Сначала он анализирует структуру проекта, точки входа, конфигурацию и зависимости, выделяет домены, изучает текущий и целевой стек, а также отмечает риски и связи. Наблюдения привязываются к строкам файлов в формате file:line.

На этапе PLAN скилл выбирает направление миграции, проектирует границы и фасад или маршрутизатор для постепенного перехода. Он создаёт ./migration-plan/00-roadmap.md, исследовательские файлы в ./migration-plan/research/ и отдельный план для каждого домена в ./migration-plan/domains/. В доменных планах есть шаги, тестовая стратегия, откат и критерии успеха.

Скилл не выполняет миграцию сам: он готовит документы для разработчиков или других агентов. Для рекомендаций по технологиям требуется веб-поиск, а context7 используется, когда доступен; без подтверждений и ссылок на код выводы плана нельзя считать обоснованными.

Какие задачи решает

  • спланировать перенос легаси-системы
  • разбить монолит на домены
  • подготовить переход между языками или фреймворками
  • составить дорожную карту постепенной миграции
  • описать откат и тестовые проверки для этапов

Примеры запросов агенту

  • Составь план миграции этого монолита на микросервисы с исследованием рисков и зависимостей.
  • Проанализируй кодовую базу и подготовь ./migration-plan/00-roadmap.md с поэтапным переходом.
  • Спланируй обновление фреймворка, укажи границы миграции, тесты и стратегию отката для каждого домена.

Как установить legacy-migration-planner

1Через Skills CLI (Vercel)

npx skills add tech-leads-club/agent-skills --skill legacy-migration-planner -a claude-code

2Вручную: положить файлы

~/.claude/skills/legacy-migration-planner/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/legacy-migration-planner/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о legacy-migration-planner

Как установить legacy-migration-planner в Claude Code?

Выполните npx skills add tech-leads-club/agent-skills --skill legacy-migration-planner -a claude-code, затем используйте файл ~/.claude/skills/legacy-migration-planner/SKILL.md.

Что делает legacy-migration-planner?

Скилл исследует кодовую базу, домены, стек, зависимости и риски, затем формирует дорожную карту миграции и отдельные планы по доменам.

Выполняет ли скилл миграцию кода?

Нет. Он создаёт план и документы в ./migration-plan/, а реализацию оставляет разработчикам или другим агентам.

Исходный текст

SKILL.md · CC-BY-4.0
---
name: legacy-migration-planner
description: Use when planning legacy system migrations, codebase modernization, monolith decomposition, microservices consolidation, cross-language rewrites, or framework upgrades. Invoke for strangler fig pattern, incremental migration strategy, or refactoring roadmaps. Do NOT use for domain analysis (use domain-analysis), component sizing (use component-identification-sizing), or step-by-step decomposition plans (use decomposition-planning-roadmap).
license: CC-BY-4.0
metadata:
  author: Felipe Rodrigues - github.com/felipfr
  version: 1.0.0
---

# Legacy Migration Planner

Senior migration architect that produces comprehensive, evidence-based migration plans using the Strangler Fig pattern. You create plans — you do not implement them. Other agents or developers execute the plan you produce.

## Core Principles

These are non-negotiable. Violating any of these invalidates your output.

1. **Never assume.** If you encounter an acronym, term, pattern, or technology you are not 100% certain about, stop and either research it (web search, context7) or ask the user. Say "I don't know what X means — can you clarify?" rather than guessing.
2. **Always cite evidence.** Every claim in your output must reference either a specific `file:line` from the user's codebase or a verified external URL. No unreferenced assertions.
3. **Always research before recommending.** Before suggesting any technology, pattern, or approach, use web search and context7 (when available) to verify it is current, maintained, and appropriate. Never recommend based solely on training data.
4. **Minimize token consumption.** Write output files per domain. Never dump entire file contents — reference by `file:line` ranges. Keep each output file focused on one bounded context.
5. **Direction-agnostic.** This skill handles ANY migration direction: monolith to microservices, microservices to modular monolith, microfrontends to SPA, cross-language, cross-framework, or any combination.

## Workflow

Every engagement follows two mandatory phases. Never skip RESEARCH. Never start PLAN without completing RESEARCH.

```
RESEARCH (mandatory)                    PLAN (mandatory)
├─ 1. Codebase deep analysis            ├─ 5. Define migration direction
├─ 2. Domain/bounded context mapping    ├─ 6. Design seams and facades
├─ 3. Stack research (web + context7)   ├─ 7. Per-domain migration files
└─ 4. Risk and dependency mapping       └─ 8. Consolidated roadmap
│                                        │
└─ Output: ./migration-plan/research/   └─ Output: ./migration-plan/domains/
```

### RESEARCH Phase

Load `references/research-phase.md` for detailed instructions.

1. **Analyze the codebase** — Read the project structure, entry points, configuration files, and dependencies. Map every module and its responsibility. Cite every finding as `file:line`.
2. **Identify bounded contexts** — Group related modules into candidate domains. Load `references/assessment-framework.md` for the domain identification method.
3. **Research current and target stacks** — Use web search and context7 to gather up-to-date documentation on both the current stack and the target stack (if migrating cross-framework/language). Document version compatibility, migration guides, and known pitfalls.
4. **Map risks and dependencies** — Identify integration points, shared databases, circular dependencies, and external service couplings. Load `references/assessment-framework.md` for the risk matrix method.

Output: Write findings to `./migration-plan/research/` with one file per concern (e.g., `dependency-map.md`, `domain-candidates.md`, `stack-research.md`, `risk-assessment.md`).

### PLAN Phase

Load `references/plan-phase.md` for detailed instructions.

5. **Define migration direction** — Based on RESEARCH findings, determine the appropriate strategy. Load `references/strangler-fig-patterns.md` for pattern selection.
6. **Design seams and facades** — Identify where to cut the system. Define the facade/router layer that will enable incremental migration. Load `references/frontend-backend-strategies.md` for stack-specific patterns.
7. **Write per-domain migration plans** — One file per bounded context in `./migration-plan/domains/`. Each file contains: current state (with file:line refs), target state, migration steps, testing strategy (load `references/testing-safety-nets.md`), rollback plan, and success metrics.
8. **Write consolidated roadmap** — `./migration-plan/00-roadmap.md` with phase sequencing, dependencies between domains, risk mitigation timeline, and success criteria.

## Output Structure

```
./migration-plan/
├── 00-roadmap.md                    # Consolidated roadmap, phases, timeline
├── research/
│   ├── dependency-map.md            # Module dependencies with file:line refs
│   ├── domain-candidates.md         # Identified bounded contexts
│   ├── stack-research.md            # Current + target stack analysis
│   └── risk-assessment.md           # Risk matrix with mitigations
└── domains/
    ├── 01-domain-{name}.md          # Per-domain migration plan
    ├── 02-domain-{name}.md
    └── ...
```

## Reference Guide

Load references based on the current phase and need. Do not preload all references.

| Topic                   | Reference                                   | Load When                                                |
| ----------------------- | ------------------------------------------- | -------------------------------------------------------- |
| Research methodology    | `references/research-phase.md`              | Starting RESEARCH phase                                  |
| Plan methodology        | `references/plan-phase.md`                  | Starting PLAN phase                                      |
| Strangler Fig patterns  | `references/strangler-fig-patterns.md`      | Choosing migration pattern, designing seams              |
| Assessment and risks    | `references/assessment-framework.md`        | Mapping dependencies, scoring risks, identifying domains |
| Testing strategies      | `references/testing-safety-nets.md`         | Designing safety nets for each domain                    |
| Stack-specific patterns | `references/frontend-backend-strategies.md` | Frontend or backend migration specifics                  |

## Constraints

### MUST DO

- Research every technology recommendation via web search before including it
- Use context7 for library documentation when available
- Cite `file:line` for every codebase observation
- Ask the user when encountering unknown terms, acronyms, or ambiguous requirements
- Produce one output file per domain to keep context manageable
- Include rollback strategy for every migration step
- Validate that current stack versions match what is actually in the codebase (package.json, requirements.txt, etc.)

### MUST NOT DO

- Guess the meaning of acronyms, internal terms, or business logic
- Recommend technologies without web search verification
- Write implementation code (this skill produces plans, not code)
- Assume migration direction without evidence from RESEARCH
- Skip the RESEARCH phase or combine it with PLAN
- Reference files or lines that were not actually read
- Include unreferenced claims in any output file

© Felipe Rodrigues - github.com/felipfr · CC-BY-4.0 · tech-leads-club/agent-skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
legacy-modernizer qdhenry legacy-modernizer — субагент для Claude Code, который планирует и проводит постепенную модернизацию устаревших систем. Он включается при рефакторинге, миграции фреймворка или разборе монолита. CX Codex ★ 1 357звёзд репо designing-architecture CloudAI-X Скилл designing-architecture для Claude Code помогает выбрать архитектурный паттерн, оценить размер проекта и команды и структурировать код. Включается при проектировании системы и принятии архитектурных решений. CX Codex +1 ★ 1 424звёзд репо architecture-modernizer davila7 Субагент architecture-modernizer для Claude Code проектирует разбиение монолита, микросервисы и событийные потоки. Вызывайте его для анализа границ модулей и планирования модернизации архитектуры. CX Codex 1 768установок principle-migrate-callers-then-delete-legacy-apis backnotprop Скилл principle-migrate-callers-then-delete-legacy-apis требует сразу переводить вызовы на новый внутренний API и удалять старый код без переходных слоёв совместимости. CX Codex +1 10 200установок code-refactoring-legacy-modernizer Seth Hobson Субагент code-refactoring-legacy-modernizer для Claude Code, Codex и Cursor постепенно переводит устаревший код на современные фреймворки и снижает технический долг. CX Codex ★ 42 780звёзд репо legacy-modernize Seth Hobson Команда legacy-modernize для пошагового обновления устаревших систем с помощью паттерна strangler fig. Координирует специализированные агенты для анализа, тестирования и постепенной замены компонентов без остановки бизнеса. CX Codex +1 ★ 126звёзд репо

Из того же набора130

Весь набор →
confluence-assistant Скилл confluence-assistant учит агента работать с Confluence через Atlassian MCP. Помогает искать страницы поиском Rovo, создавать новые записи в разметке Markdown и обновлять документацию прямо из чата. CX Codex +1 ★ 7 191звёзд репо security-threat-model Скилл security-threat-model строит модель угроз по коду репозитория: находит границы доверия, активы и реалистичные пути атаки, а результат сохраняет в Markdown-файл. CX Codex +1 ★ 7 191звёзд репо modular-decomposition Скилл modular-decomposition проводит монолит через пять шагов анализа перед разбивкой на модули: размер и инвентаризация компонентов, дублирование логики, иерархия, связность, группировка по доменам. CX Codex +1 ★ 7 191звёзд репо tlc-plan Скилл tlc-plan превращает PRD, тикеты и обсуждения в строгий план разработки. Уточняет серые зоны до написания кода и фиксирует критерии приёмки. CX Codex +1 ★ 7 191звёзд репо shopify-developer Скилл shopify-developer для Claude Code даёт агенту справочник по Liquid, темам OS 2.0, GraphQL API, Functions и Hydrogen для разработки под Shopify. CX Codex +1 ★ 7 191звёзд репо aws-advisor Скилл aws-advisor консультирует по архитектуре AWS, проверяет безопасность и сверяет параметры сервисов с документацией через MCP-инструменты. CX Codex +1 ★ 7 191звёзд репо rails-dev Скилл rails-dev для Claude Code задаёт конвенции Ruby on Rails: богатые модели, состояния-записи, Minitest с фикстурами и минимум внешних гемов. CX Codex +1 ★ 7 191звёзд репо demo Скилл demo для Claude Code записывает проход по веб-приложению в MP4 на настоящем рабочем столе и сохраняет телеметрию кликов и прокрутки. Запись демо для чейнджлога и документации. CX Codex +1 ★ 7 191звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой