Codebase Health

Plugin codebase-health from marketplace somepulp-agents in jeffrigby/somepulp-agents. Commands read from the repo's manifest — 1 month ago.

Skills (6)

• code-auditing

  Systematic methodology for comprehensive codebase analysis — security review, technical debt identification, dead code detection, code quality checks, and best-practices verification against official library documentation.

• dead-code

  Detect and clean up dead code — unused imports, exports, files, and dependencies — using knip or deadcode with agent verification to filter false positives.

• deep-audit

  Run a comprehensive deep audit by orchestrating specialist agents (security, performance, libraries, quality, dead code) into a single dated report.

• docs-maintenance

  Methodology for keeping project documentation current, consistent, and optimized for AI coding agents — CLAUDE.md optimization, README synchronization, CHANGELOG updates, and documentation freshness audits.

• update-deps

  Update dependencies safely — apply in-range minor/patch updates, then analyze each pending major in parallel and apply only the ones proven safe for this codebase, reporting the rest with justifications.

• update-docs

  Update and synchronize project documentation — CLAUDE.md, README, CHANGELOG — with recent code changes.

Subagents (7)

• code-quality-reviewer

  Used by the deep-audit orchestrator. Do not invoke directly. Reviews a codebase for general quality issues — code smells, complexity, duplication, weak error handling, and anti-patterns. Filters aggressively for high-confidence findings.

• dead-code-cleanup

  Dead code detection and cleanup with false positive verification. Use when user asks to "find dead code", "clean up unused code", "remove dead code", or wants to detect/remove unused imports, exports, files, or dependencies.

• library-modernizer

  Used by the deep-audit orchestrator. Do not invoke directly. Identifies custom code that should use a mature library, deprecated/outdated API usage, and TypeScript @types/* duplication. Uses Context7 for authoritative current docs.

• major-upgrade-analyzer

  Used by the update-deps orchestrator. Do not invoke directly. Decides whether a single major-version dependency upgrade is safe to apply to this codebase, using changelogs, engine requirements, peer deps, and actual call-site usage.

• performance-analyzer

  Used by the deep-audit orchestrator. Do not invoke directly. Analyzes a codebase for performance issues — algorithmic hot spots, N+1 queries, memory retention, async/await misuse, render thrash, and bundle bloat.

• security-auditor

  Used by the deep-audit orchestrator. Do not invoke directly. Audits a codebase for security vulnerabilities — hardcoded secrets, injection risks, unsafe deserialization, weak crypto, auth flaws, and known CVEs in dependencies.

• update-docs

  Update and optimize project documentation to reflect recent changes and improve AI agent usability. Use when user asks to "update documentation", "sync docs with code", "optimize CLAUDE.md", "update README", "document recent changes", or "check documentation freshness".

Similar plugins