Skip to main content
subagent CX Codex

legacy-modernizer · qdhenry — Claude Code subagent for legacy systems

legacy-modernizer is a Claude Code subagent for planning and carrying out gradual changes to legacy systems. It engages on framework upgrades, codebase refactors, and monolith decomposition.

no license ★ 1,357 updated 2026-03-01

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/legacy-modernizer.md
Open on GitHub

What legacy-modernizer does

The subagent examines existing code and lays out a phased modernization plan. It can guide framework migrations, break a monolith into smaller services, and tackle technical debt while preserving current behavior.

Its approach favors small changes backed by tests, rather than a full rewrite. Plans can cover migration stages and risks; the agent can also help draft code changes, tests, and documentation. It starts by studying the project’s existing patterns.

What it helps with

  • plan a phased modernization of a legacy system
  • move a project to a newer framework
  • split a monolithic application into services
  • refactor complex code with behavior checks

Example prompts for the agent

  • Plan a gradual modernization of this codebase.
  • Help migrate this app to a newer framework without a full rewrite.
  • Map out safe steps for breaking this monolith into services.

How to install legacy-modernizer

Manually: put the files in place

.claude/agents/legacy-modernizer.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about legacy-modernizer

How do I install legacy-modernizer in Claude Code?

Add the agent file to the project at .claude/agents/legacy-modernizer.md.

What does legacy-modernizer do?

It assesses legacy code and helps plan incremental refactoring, framework migrations, or monolith decomposition. Its guidance includes testing changes.

How does legacy-modernizer approach system migrations?

It favors phased changes over a full rewrite. The workflow begins by examining existing patterns and establishing tests before modifying code.

Similar subagents

All subagents for Code review and refactoring →

legacy-modernizer by other authors comes first.

legacy-modernizer VoltAgent Community legacy-modernizer assesses aging codebases and breaks modernization into migration steps with tests and rollback planning. Use it when changes need to happen incrementally. CX Codex 826installs legacy-modernizer VoltAgent legacy-modernizer helps plan upgrades to older code, frameworks, or architecture without breaking what works. Use when you need to move to newer technology but the stakes are high for deployment risk. CX Codex ★ 6,505repo stars code-refactoring-legacy-modernizer Seth Hobson code-refactoring-legacy-modernizer — a subagent for Claude Code, Codex, and Cursor that moves legacy codebases forward through incremental framework migrations and technical debt paydown. CX Codex ★ 42,780repo stars legacy-modernize Seth Hobson The legacy-modernize command examines a legacy codebase, maps dependencies, and assesses migration risks. Use it to plan a gradual replacement of system components. CX Codex +1 ★ 42,780repo stars legacy-migration-planner Felipe Rodrigues - github.com/felipfr The legacy-migration-planner skill plans legacy migrations, codebase modernization, and monolith decomposition. Use it before implementation when the move needs documented research and staged decisions. CX Codex +1 ★ 7,191repo stars working-with-legacy-code wondelai working-with-legacy-code — a skill that applies Michael Feathers' method for safe changes to untested code. Triggers when you work with legacy code, hunt for characterization tests, or break dependencies to get modules under test. CX Codex +1 3,700installs refactor-legacy-code aj-geddes refactor-legacy-code guides systematic legacy code refactoring without breaking features. Built for paying down technical debt and replacing deprecated patterns. CX Codex +1 611installs working-effectively-with-legacy-code ciembor working-effectively-with-legacy-code — a skill for Claude Code and Codex that enforces Michael Feathers' legacy code techniques. Activates during risky refactoring, missing test coverage, and dependency breaking. CX Codex +1 602installs

From the same set112

The whole set →
data-engineer The data-engineer subagent designs data pipelines, warehouses, and streaming systems. Use it for ETL/ELT work, Spark jobs, Airflow flows, or Kafka architectures. CX Codex ★ 1,357repo stars database-optimizer database-optimizer — a subagent for database performance analysis: finds bottlenecks in SQL queries, indexing, schema design and infrastructure. CX Codex ★ 1,357repo stars ui-designer ui-designer — a Claude Code subagent for building interface mockups, design systems, and accessible layouts using magic and context7 MCP servers. CX Codex ★ 1,357repo stars cloudflare-worker Generate a Cloudflare Worker from a task description, with Wrangler configuration and sample requests. Useful for building an API, WebSocket service, or authentication middleware. CX Codex +1 ★ 1,357repo stars todo-worktree todo-worktree takes tasks from a todo list and implements them inside isolated git worktrees with strict phased approvals. CX Codex +1 ★ 1,357repo stars package-skill package-skill is a Claude Code command that checks a skill and builds a ZIP for sharing, team distribution, or publication. CX Codex +1 ★ 1,357repo stars parallel-tasks-help parallel-tasks-help is a Claude Code command that explains how to run /parallel-tasks, with its options, agent types, and examples. It also covers task systems and coordination stages. CX Codex +1 ★ 1,357repo stars linear-task-to-issue linear-task-to-issue exports Linear tasks into GitHub issues while preserving descriptions, child tasks, comments, and priority labels. CX Codex +1 ★ 1,357repo stars

Project sponsors

Companies that keep this analytics open