What problem does it solve? Codebases accumulate structural debt over time: inconsistent naming, oversized files, dead code, duplication, and hidden hotspots. This Skill performs a quantitative structural health audit across 13 measurable dimensions (SA1-SA13), producing a scored report with letter grades, critical gates, and prioritized action items backed by tool evidence rather than subjective opinion. ## Core Features & Use Cases - 13-dimension structural analysis: Covers directory consistency, naming conventions, folder depth, colocation, barrel exports, separation of concerns, file size distribution, dead code, complexity, duplication, root organization, documentation, and churn-based hotspots. - Tool-driven evidence: Uses CodeSift as the primary analysis engine (detect_communities, analyze_complexity, find_dead_code, find_clones, analyze_hotspots) with CLI fallbacks like cloc, knip, dependency-cruiser, jscpd, and ESLint. - Scored report with gates: Assigns 0-3 scores per dimension, computes a normalized grade (A-D or FAIL), calculates a SQALE debt ratio, and enforces critical gates for layer violations, oversized files, and circular dependencies. - Use Case: Before a major refactor, run a full audit to identify god modules, circular dependencies, and high-churn hotspot files, then route findings to refactoring or architecture review workflows. ## Quick Start Ask the assistant to run a full structure audit on the current project, or scope it with a path or flags such as --naming, --dead-code, --hotspots, --quick, or --fix.
