common-architecture-audit
Installation
SKILL.md
Architecture Audit
Priority: P1 (HIGH)
1. Discover Structural Duplication
Identify split sources of truth by searching for redundant directory patterns.
- Compare
Service.tsvsServiceNew.tsvsServiceV2.ts. - Check for
/v1,/v2or "Refactor" folders.
See implementation examples for detection scripts.
2. Detect Logic Leakage (by Ecosystem)
Find business logic trapped in wrong layer.
- Web (React/Next.js/Vue):
grep -rE "useEffect|useState|useMemo" components --include="*.tsx" | wc -l— ifcomponents/hook count > 20xhooks/folder, architecture monolithic. - Mobile (Flutter/React Native):
grep -rE "http\.|dio\.|socket\." lib/widgets --include="*.dart" | wc -l— I/O or state mutation > 5 lines inbuild()High Debt. - Backend (NestJS/Go/Spring):
grep -rE "Repository\.|Query\.|db\." src/controllers --include="*.ts" | wc -l— Controllers must only handle request parsing and response formatting.