subagent

architecture-modernizer — Claude Code subagent: architecture and setup

Q: How do I install architecture-modernizer in Claude Code?

Run `npx claude-code-templates@latest --agent modernization/architecture-modernizer`.

Plans service boundaries, event-driven flows, and target architecture for legacy systems. Use it when you need a concrete decomposition plan rather than a code-level refactor.

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --agent modernization/architecture-modernizer

Open on GitHub

What architecture-modernizer does

The subagent examines module relationships and shared database tables before proposing service boundaries. It can use Read, Grep, and Glob, and run available dependency-analysis tools with Bash. Shared database coupling is often the real obstacle to splitting a monolith, so map it before settling on service seams.

Deliverables can include ADRs, Mermaid diagrams, OpenAPI or AsyncAPI specifications, and data migration plans. For service extraction, it accounts for contract tests, shadow traffic, feature-flagged routing, and rollback paths. Its remit is target-state design; detailed API implementation, cloud migration, and phased strangler execution go to other specialist agents.

What it helps with

map module dependencies and shared database access
define service boundaries for a monolith split
design event flows and API gateway contracts
plan data migration between old and new services
document architecture decisions with ADRs and Mermaid diagrams

Example prompts for the agent

Review this project and propose service boundaries for breaking up the monolith.
Design event-driven flows for this business process and draw them in Mermaid.
Draft an ADR for extracting this service, including shared-database coupling and a rollback path.

How to install architecture-modernizer

1claude-code-templates

npx claude-code-templates@latest --agent modernization/architecture-modernizer

2Manually: put the files in place

.claude/agents/architecture-modernizer.md

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

Manually: put the files in place

.codex/agents/architecture-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/

Manually: put the files in place

.cursor/agents/architecture-modernizer.md

Cursor 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 architecture-modernizer

How do I install architecture-modernizer in Claude Code?

Run npx claude-code-templates@latest --agent modernization/architecture-modernizer.

What does architecture-modernizer do?

It designs target architecture, including service boundaries, event flows, API contracts, and data patterns. It can turn the design into ADRs, Mermaid diagrams, and OpenAPI or AsyncAPI specifications.

What should I check before splitting a monolith?

Map shared database tables and schemas alongside cross-module dependencies. Coupling through a shared database is often the main obstacle to separating services.

Similar subagents

Subagents catalog →

code-reviewer official Anthropic Reviews code changes against CLAUDE.md project rules and flags material defects. Run it before a commit or pull request. 31,050installs code-reviewer official Anthropic This subagent checks code changes for bugs, security issues, and project-rule violations. Use it when a review should focus on findings that matter. 31,050installs security-auditor official Anthropic This subagent searches code for security flaws and gives engineers concrete fixes. Use it to review a project before hardening or modernization work. 10,718installs test-engineer official Anthropic This subagent captures legacy behavior in tests and compares it with a rewritten implementation. Use it before changing existing modules. 9,715installs frontend-developer VoltAgent Community Subagent for building complete frontend applications with React 18+, Vue 3+, and Angular 15+. Handles component architecture, state management, testing, and accessibility. 40,905installs code-reviewer VoltAgent Community Reviews code changes for bugs, security flaws and maintenance issues. Use it before merging complex work or auditing a project. 31,050installs

From the same set238

The whole set →

academic-researcher Searches scholarly literature, checks source quality, and builds research reviews. Use it to compare study methods, trace citations, and identify gaps. 1,855installs generate-api-documentation Scans source code for endpoint annotations and builds API documentation. Supports Swagger UI, Redoc, Postman collections, and automated CI/CD steps. 1,849installs cli-ui-designer Designs terminal-styled web interfaces with modern web standards. Helpful when you want a dashboard, developer tool, or landing page that looks like a command line. 1,849installs feature The command creates a feature/<name> branch from develop and sets up remote tracking. Use it to start a feature with the Git Flow branch structure. 1,820installs finish Automates Git Flow branch completion by validating tests, merging into target branches, and handling release tagging. 1,712installs monitoring-specialist This subagent helps plan metrics, logs, tracing, alerts, and SLA monitoring. Use it while building observability for an infrastructure project. 1,677installs research-coordinator This subagent turns a broad research brief into specialist assignments and a coordination plan. Use it when a question spans several research disciplines. 1,673installs release Automates Git Flow release branches from develop. It validates semver, bumps package.json, compiles a grouped changelog, and pushes to remote. 1,664installs