Modernization Agent

Modernization Agent is an agent for Claude Code from archubbuck/workspace-architect. It costs 24 tokens per session (6,094 once invoked), scanned A, a copy of Modernization Agent, ISC.

A guided assistant for examining an existing software project, documenting how it works, and planning a modernization—updating an older system’s structure or technology. It works with projects in any technology stack and keeps a person involved.

In plain words
What is it for?
Use it to create feature-by-feature documentation, a complete project overview, and recommendations for modernizing backend and frontend code.
Why use it?
It reduces the risk of changing an unfamiliar codebase without understanding its business rules, architecture, and user flows first.

Agent for Claude Code

Written for Claude Code: a Claude Code subagent (agents/*.md). Also seen: model in frontmatter.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/archubbuck/workspace-architect/modernization
Clone the repo
git clone --depth 1 https://github.com/archubbuck/workspace-architect

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for Modernization Agent

README.md
[![agentmods](https://agentmods.dev/badge/agents/archubbuck/workspace-architect/modernization.svg)](https://agentmods.dev/agents/archubbuck/workspace-architect/modernization)
Your own site
<a href="https://agentmods.dev/agents/archubbuck/workspace-architect/modernization"><img src="https://agentmods.dev/badge/agents/archubbuck/workspace-architect/modernization.svg" alt="Measured on agentmods" height="20"></a>
Per session 24 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 6,094 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00024 $0.06094
Opus 5 $0.00012 $0.03047
Sonnet 5 $0.00005 $0.01219
Haiku 4.5 $0.00002 $0.00609

Measured 2d ago against content hash 4d0c8a31a7f7, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

Modernization Agent scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to Modernization Agent — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

assets/agents/modernization.agent.md · 581 lines

How it starts

The opening of the file, as written. The whole thing — 581 lines — stays where its author put it; the contents beside it link to each section on GitHub.

This agent runs directly in VS Code with read/write access to your workspace. It guides you through complete project modernization with a structured, stack-agnostic workflow.

Modernization Agent

IMPORTANT: When to Execute Workflow

Ideal Inputs

  • Repository with an existing project (any tech stack)

What This Agent Does

CRITICAL ANALYSIS APPROACH: This agent performs exhaustive, deep-dive analysis before any modernization planning. It:

  • Reads EVERY business logic file (services, repositories, domain models, controllers, etc.)
  • Generates per-feature analysis in separate Markdown files
  • Re-reads all generated feature docs to synthesize a comprehensive README
  • Forces understanding through line-by-line code examination
  • Never skips files - completeness is mandatory

Analysis Phase (Steps 1-7):

  • Analyzes project type and architecture
  • Reads ALL service files, repositories, domain models individually
  • Creates detailed per-feature documentation (one MD file per feature/domain)
  • Re-reads generated feature docs to create master README
  • Frontend business logic: routing, auth flows, role-based/UI-level authorization, form handling & validation, state management (server/cache/local), error/loading UX, i18n/l10n, accessibility considerations
  • Cross-cutting concerns: error handling, localization, auditing, security, data integrity

Planning Phase (Step 8):

  • Recommends modern tech stacks and architectural patterns with expert-level reasoning

Implementation Phase (Step 9):

  • Creates /modernizedone/ folder for new project structure
  • Starts with cross-cuttings and project structure before feature migration
  • Generates actionable, step-by-step implementation plans for developers or Copilot agents

This agent does not:

  • Skip files or take shortcuts
  • Bypass validation checkpoints
  • Begin modernization without complete understanding

Inputs & Outputs

Inputs: Repository with existing project (any stack: .NET, Java, Python, Node.js, Go, PHP, Ruby, etc.)

Read the full file on GitHub · 581 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 581 lines · 24 tokens per session scan A 4d0c8a31a7f7

Subscribe to this mod's changes

Modernization Agent is an agent published in the GitHub repository archubbuck/workspace-architect (18 stars, last pushed 2d ago), licensed ISC. It adds 24 tokens to every session and 6,094 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to Modernization Agent, differing in 0 lines, and is treated as a copy.

Related

Other agents, from other repositories

al-architect

AL Architecture and Design assistant for Business Central extensions. Focuses on solution architecture, design patterns, and strategic technical decisions for AL development. Use when requirements need architectural analysis, data model design, integration strategy, or pattern evaluation before implementation.

javiarmesto/ALDC-AL-Development-Collection · 51 tokens

al-conductor

Orchestrates Planning, Implementation, Review, and Commit cycle for AL Development. Enforces TDD and quality gates for Business Central extensions. Use when you need structured TDD orchestration with planning, implementation, and review subagents.

javiarmesto/ALDC-AL-Development-Collection · 51 tokens

al-review-subagent

Internal quality assurance subagent for Business Central AL code. Only invoked by al-conductor via Task tool. Reviews implementation against AL best practices, test coverage, and BC patterns.

javiarmesto/ALDC-AL-Development-Collection · 40 tokens

al-agent-builder

Agent Toolkit Builder specialist in designing and coding Business Central agents using the AI Development Toolkit and Agent SDK. Follows the official Agent Template project structure. Handles both Designer (no-code) and SDK (pro-code) paths. Use when building BC agents or agent SDK integrations.

javiarmesto/ALDC-AL-Development-Collection · 58 tokens

al-triage

Reactive diagnosis specialist for EXISTING Business Central AL code — reproduce, localize, root-cause, and recommend a minimal fix for bugs, regressions, and incidents. Read-only on code: produces a diagnosis and hands the fix to al-developer. The dynamic counterpart to dredd (static audit). Use when you start from a…

javiarmesto/ALDC-AL-Development-Collection · 90 tokens

git-publisher

Coordinator-owned bounded git/GitHub operations — stage, commit, push, open/reconcile a PR, watch CI, and merge only on an exact PR/CI/review head match. Never edits repository files and never force-pushes. Dispatched by agentmaster-execute with one approved publication manifest; not a general-purpose worker.

rhawk117/agentmaster · 72 tokens