audit-architecture
Walk the repo's source in the configured language looking for technical debt — oversized files, DRY violations, dead code, missing tests, sloppy typing, weak abstractions, and drift against the repo's documented invariants. Categorize each finding into a discrete unit of work; open a focused PR for mechanically-safe fixes and file a GitHub issue for refactors that need design discussion. One PR or one issue per finding — never bundled. Use when the user asks to "audit the architecture", "find tech debt", "look for code smells", "do an architecture sweep", or when invoked nightly by a scheduled remote agent. Has working-tree side effects (branches + PRs) and GitHub side effects (issues, labels). Quiet-day result is "codebase looks good" with no PR or issue — that's a valid outcome.
Pinned to revision bb56a8ccac95, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/audit-architecture/SKILL.md
- skills/audit-architecture/references/language-detection.md
- skills/audit-architecture/references/scheduling.md
Every link opens the file at its source, pinned to the revision this page describes.