codebase-maintenance plugin
Safe refactoring, dead-code removal, legacy modernization, and dependency hygiene.
How to install the codebase-maintenance plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add yeaight7/agent-powerups
/plugin install codebase-maintenance@agent-powerupsWhat's inside codebase-maintenance
16 parts read from the plugin's own files.
Commands 4
Run as /codebase-maintenance:name- /codebase-maintenance:cleanup
Run a systematic cleanup on the provided code to resolve smells, simplify complexity, and enforce best practices.
- /codebase-maintenance:debt-audit
Perform a technical debt audit on the specified components and generate a prioritized remediation roadmap.
- /codebase-maintenance:refactor-plan
Draft a step-by-step refactoring strategy for complex code changes to ensure behavior is preserved.
- /codebase-maintenance:safe-rename<old_name> to <new_name>
Safely rename a variable, function, class, or file across the entire repository while ensuring tests continue to pass.
Agents 3
Call as @agent-codebase-maintenance:name- @agent-codebase-maintenance:codebase-cleaneropus
Reviews code for quality, security, and performance. Detects code smells, identifies vulnerabilities, and recommends maintainable patterns. Use when aiming to proactively improve codebase health.
- @agent-codebase-maintenance:safe-refactorersonnet
Specializes in restructuring code without changing observable behavior. Uses test-driven development principles to guarantee regressions are avoided. Use when migrating frameworks or cleaning up legacy components.
- @agent-codebase-maintenance:technical-debt-reviewersonnet
Audits codebases for technical debt, legacy patterns, and outdated dependencies. Proposes structured remediation roadmaps. Use when prioritizing engineering investments or modernizing systems.
Skills 9
Claude loads it when the task matches- ai-slop-cleaner
No description in the file.
- architecture-simplification
No description in the file.
- context-retrieval-loop
No description in the file.
- dead-code-removal
No description in the file.
- dependency-cleanup
No description in the file.
- incremental-migration
No description in the file.
- naming-and-structure-cleanup
No description in the file.
- safe-refactor
No description in the file.
- test-preserving-refactor
No description in the file.
Using codebase-maintenance in Claude Code
Type a command in a Claude Code session:
/codebase-maintenance:cleanup
/codebase-maintenance:debt-audit
/codebase-maintenance:refactor-planAsk for an agent by name:
@agent-codebase-maintenance:codebase-cleaner
@agent-codebase-maintenance:safe-refactorerSkills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update codebase-maintenance@agent-powerups
- Refresh the marketplace
- /plugin marketplace update agent-powerups
- Turn it off for now
- /plugin disable codebase-maintenance@agent-powerups
- Remove it
- /plugin uninstall codebase-maintenance@agent-powerups
codebase-maintenance plugin questions
How do I install the codebase-maintenance plugin?
In Claude Code run /plugin marketplace add yeaight7/agent-powerups, then /plugin install codebase-maintenance@agent-powerups.
What does the codebase-maintenance plugin include?
codebase-maintenance bundles 4 commands, 3 agents, 9 skills.
What commands does the codebase-maintenance plugin add?
It adds /codebase-maintenance:cleanup, /codebase-maintenance:debt-audit, /codebase-maintenance:refactor-plan, /codebase-maintenance:safe-rename. Run them in Claude Code with the plugin prefix, for example /codebase-maintenance:cleanup.
Which agents come with codebase-maintenance?
codebase-cleaner, safe-refactorer, technical-debt-reviewer. Call one with @agent-codebase-maintenance:codebase-cleaner.
How do I update or remove the codebase-maintenance plugin?
Update it with claude plugin update codebase-maintenance@agent-powerups in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall codebase-maintenance@agent-powerups.
What license is the codebase-maintenance plugin under?
Apache-2.0, as stated in the plugin's manifest.