# legacy-modernizer

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.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/development/legacy-modernizer.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/qdhenry-legacy-modernizer

## What it 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.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/legacy-modernizer.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/legacy-modernizer.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/legacy-modernizer.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/agents/development/legacy-modernizer.md

## When to use it
- 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
- 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.

## Similar
- [code-refactoring-legacy-modernizer](https://affpapa.org/en/nevibecode/agents/code-refactoring-legacy-modernizer.md) — subagent · ★ 42780 repo stars
- [legacy-modernize](https://affpapa.org/en/nevibecode/commands/legacy-modernize.md) — command · ★ 42780 repo stars
- [legacy-migration-planner](https://affpapa.org/en/nevibecode/skills/legacy-migration-planner.md) — skill · ★ 7191 repo stars
- [working-with-legacy-code](https://affpapa.org/en/nevibecode/skills/working-with-legacy-code.md) — skill · 3700 installs
- [refactor-legacy-code](https://affpapa.org/en/nevibecode/skills/refactor-legacy-code.md) — skill · 611 installs
- [working-effectively-with-legacy-code](https://affpapa.org/en/nevibecode/skills/working-effectively-with-legacy-code.md) — skill · 602 installs

## Other versions with the same name
- [legacy-modernizer · voltagent](https://affpapa.org/en/nevibecode/agents/legacy-modernizer.md) — 826 installs
- [legacy-modernizer · voltagent](https://affpapa.org/en/nevibecode/agents/voltagent-legacy-modernizer.md) — ★ 6505 repo stars

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
