Agent skill · luongnv89
codebase-modernizer
Audit a stale, inherited, or messy codebase — deps, bugs, security, tests, CI, docs, UI/UX — then emit a phased, testable modernization plan. Read-only: plans upgrades, never applies them. Not for single-PR review, PRD-to-tasks, or UX-only audits.
What it needs
About 12k tokens when loaded.
What this skill does
Codebase Modernizer For a codebase you are returning to after a long gap, or one that has drifted through many unoptimized changes. It audits every applicable dimension, then converts the findings into a phased, sprint-sized, testable plan for a better, up-to-date version. Produces exactly two files in the target repo root: File Contents --- --- MODERNIZATIONREPORT.md Baseline evidence + every finding, severity-ranked, each citing path:line MODERNIZATIONPLAN.md Phases → sprints → tasks → milestones, every task closing named findings Read-only contract This skill never modifies source code, dependencies, lockfiles, or configuration — no tracked file's content changes. On a clean tree that is git diff --stat empty. On a stale, already-dirty tree, git status --porcelain and git diff after the run must match a snapshot taken before it (declared artifacts set aside). Beyond the two reports, only two kinds of new file may appear, both enumerated in the report's Artifacts section: a declared delegate artifact (CODEREVIEW.md, from code-review mode review) and probe byproducts (build dirs such as obj/, .darttool/, target/, .gradle/). Nothing else. Dependency upgrades become planned tasks with migration steps — never npm update, ncu -u, cargo update, poetry update, or any equivalent. A blind bulk upgrade on a stale tree produces a broken build and an unreviewable diff, which is exactly what the plan exists to prevent. Refactors, dead-code removal, and test generation are planned, not applied. Applying them is the delegate skills' job, run later against the plan. Agent environment files (CLAUDE.md, AGENTS.md) are planned via /agent-config create or /agent-config update in the plan's Pre step — never created or rewritten during the audit. If the user asks mid-run to start fixing, finish the report and plan first, then hand off to the delegate skill named in that task. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills luongnv89/codebase-modernizer