Audit codebases for shallow interfaces and output ranked architecture reports.
npx skills add https://github.com/yabafre/aped-claude --skill aped-arch-audit
Please help me install this Agent Skill. Skill: aped-arch-audit Source: https://github.com/yabafre/aped-claude/tree/main/src/templates/skills/aped-arch-audit Command: npx skills add https://github.com/yabafre/aped-claude --skill aped-arch-audit
It helps you find parts of an existing codebase that are hard to evolve because their interfaces are shallow and mirror their implementation, which lowers leverage and weakens locality.
Run the aped-arch-audit skill with an optional scope like src/auth to generate architecture-audit.md listing ranked deepening candidates.
High-intent search queries and answers about installing and using this skill.
An architecture audit for module deepening surfaces interfaces that mirror their implementation, lowering leverage and weakening locality. It applies the deletion test to distinguish pass-through wrappers from modules earning their keep, producing a ranked report of refactor candidates.
The deletion test evaluates refactor opportunities by distinguishing true pass-through wrappers from modules that earn their keep. It checks whether a module reappears across multiple call sites, confirming its leverage and locality before recommending interface deepening.
Identify deepening opportunities without auto-refactoring by scanning for shallow interfaces and applying the deletion test. This surfaces consolidation candidates that reduce caller complexity and concentrate change, halting for explicit validation before generating a ranked audit report.
Yes, the architecture audit works on specific source directories like src/auth. Running the audit with an optional scope parameter generates a targeted architecture-audit.md report listing ranked deepening candidates within that boundary.
Low locality and leverage make codebases hard to evolve because shallow interfaces mirror implementation details, spreading change across multiple call sites. Deepening these module interfaces concentrates change and reduces caller complexity, improving overall architecture adaptability.
ivfariasAudit codebases against a quality checklist and generate a Markdown report.
maxenergyIdentify deepening opportunities in codebases using ADRs and CONTEXT.md vocabulary.
efekrbasDesign deep module interfaces with clean seams for codebase restructuring.
ishandutta2007Identify shallow modules and propose deepening refactors using the deletion test.
