What problem does it solve?
The Repo Auditor eliminates uncertainty about a codebase by producing a concise, persistent operational snapshot that maps the real stack, conventions, assets, tests, docs, risks, and integration points so downstream automation and humans can act with confidence.
Core Features & Use Cases
- Automatic discovery: Detects frameworks, tooling, test suites, pipelines, and visual assets by scanning repository files and git history.
- Reusable audit output: Persists a short indexed markdown (docs/repo-audit/current.md) and generates focused splits (routes.md, schema.md, components.md, services.md, infra.md) only when relevant to reduce re-reads and token usage.
- Governance and incremental updates: Follows defined policies for execution, persistence, token-efficiency, and handoffs; updates audits only when relevant changes are detected.
- Use Case: Use during onboarding, before major features or migrations, or when actual stack diverges from reference templates to prioritize risks and next steps.
Quick Start
Run the repo-auditor at the repository root and produce docs/repo-audit/current.md with detected stack, key conventions, prioritized risks, and recommended next steps.