architecture-enforcer

What problem does it solve?

Prevents pattern drift and inconsistent conventions across the SYNTHEX codebase by detecting and enforcing a single set of architectural patterns such as centralized auth, a single Prisma client, icon barrel usage, consistent API response shapes, theme token usage, client directives, fetch credential policies, multi-business scoping, and removal of dead code.

Core Features & Use Cases

• Repository-wide pattern checks: Implements ten targeted checks (P1–P10) to find duplicated utilities, local auth implementations, direct Prisma imports, direct lucide-react imports, inconsistent API responses, hardcoded theme colours, missing client directives, fetch calls without credentials, missing multi-business scoping, and obvious dead code.
• Actionable reporting and fixes: Produces grouped violation reports with file paths, line numbers, counts, recommended fixes, canonical references, and optional auto-fix for safe patterns (icon imports, Prisma client imports, client directives).
• Use Case: Ideal for running during pull request review, after bulk refactors, before releases, and as a CI architecture health gate to keep conventions consistent across engineers and AI-assisted edits.

Quick Start

Run architecture-enforcer against the repository root to scan for pattern violations and generate a grouped consistency report.