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.ts vs ServiceNew.ts vs ServiceV2.ts.
  • Check for /v1, /v2 or "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 — if components/ hook count > 20x hooks/ 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 in build() 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.
Installs
2
GitHub Stars
575
First Seen
Sep 10, 2026