codebase-audit

Installation
SKILL.md

Codebase Audit — Adaptive Deep Analysis

A comprehensive codebase audit that adapts its agent configuration to the project's tech stack. Each agent uses the highest-tier model for maximum thoroughness. Findings are verified before compilation, then compiled into a unified report sorted by severity with a phased repair roadmap.

Core Principles

  1. Highest-tier model — All audit agents MUST use the highest-capability model available in the current environment (e.g. fable; opus acceptable as fallback). Never use lightweight tiers (haiku) for audit agents. If the highest tier is unavailable, fall back one tier and note the downgrade in the report header.
  2. Depth over breadth — Fewer agents with broader scope and deeper analysis beats many shallow agents. Each agent should trace issues across file boundaries.
  3. Adaptive — Agent count and focus areas vary by project type. Don't waste an agent on "frontend rendering" for a backend-only project.
  4. Verify before report — No Critical/High finding enters the report unverified. LLM audit agents misreport intentional patterns (deliberate fallbacks, feature gates) as defects; Phase 1.5 exists to catch that.

When to Use

  • User asks to audit/review/analyze an entire codebase
  • User wants to find hidden bugs, silent degradation, or design inconsistencies
  • User asks about technical debt, architecture health, or "what's broken"
  • Before a major refactor or after inheriting an unfamiliar codebase
  • Periodic health check (monthly/quarterly) — see Phase 3 for baseline diffing
Installs
51
GitHub Stars
230
First Seen
Apr 6, 2026
codebase-audit — majiayu000/claude-arsenal