Architecture Guard

Outputs

• reports/architecture/ARCH_REPORT.md
• reports/dependency-graph.mmd

Steps

1. Run npm run depcruise -- fail if any error-severity violations.
2. Run npm run depgraph -- generate Mermaid dependency graph.
3. Write reports/architecture/ARCH_REPORT.md summarising:
   • Cycle count (must be 0)
   • Boundary violations (must be 0)
   • Layer compliance status
   • Fan-in/fan-out hotspots (if detectable)
   • Link to dependency graph