invest-architecture

To audit your codebase against your architecture doctrine, run the tool from the repository root. It reads your declared layers, naming conventions, and import rules from ARCHITECTURE.md, VECTOR.md, and CLAUDE.md, then reports violations for remediation.

Architecture doctrine validation is the process of comparing your actual codebase structure against the rules declared in your ARCHITECTURE.md. It checks layer constraints, naming conventions, stack requirements, and import rules to detect misplacements and prohibited imports.

Yes, you can automatically fix import violations and layer misplacements by running the audit with the optional --fix mode. This applies safe, mechanical remediation to resolve detected issues against your declared architecture doctrine.

The codebase audit supports both full project and specified path scopes. You can run it on the entire repository to validate everything against ARCHITECTURE.md, or limit the audit to a specific path to check a targeted section of your codebase.

Your codebase audit reports prohibited imports because the new code violates the import rules declared in your ARCHITECTURE.md. The audit extracts your layer table and constraints, then detects any imports between layers that your doctrine explicitly forbids.