Architecture Audit

The Law

AN ARCHITECTURE CLAIM WITHOUT A FILE REFERENCE IS AN OPINION.
"The service layer is tightly coupled" is not a finding.
"OrderService imports 14 concrete classes from 6 modules (src/services/order.ts:1-22),
so a payment-provider swap requires touching all 6" is a finding.

When to Use

• Before major feature work on an inherited or unfamiliar codebase
• Before a scaling milestone (10× users, new region, new platform)
• After rapid growth phases where structure was sacrificed for speed
• As a periodic health check on long-lived systems
• NOT for greenfield design — use the architect agent and brainstorming skill instead