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
.claude/agents/legacy-modernizer.mdWhat 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.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/legacy-modernizer.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/legacy-modernizer.mdCursor also reads .claude/agents/
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.