detect-architecture

You can detect your codebase architecture profile by running a heuristic analysis of your folder structure and import sampling to classify the project into clean-architecture-ritual, mvc-flat, vertical-slice, nextjs-app-router, or unknown-mixed categories.

Folder heuristics and import analysis identify patterns including clean-architecture-ritual, mvc-flat, vertical-slice, and nextjs-app-router. If the detection confidence falls below 80%, the project is classified as unknown-mixed pending interactive user confirmation.

Yes, you can classify a Next.js project using app router detection if the codebase contains detectable source roots like src/, app/, or lib/. The heuristic analysis identifies the nextjs-app-router profile through deterministic folder and import pattern matching.

The confidence threshold for architecture detection is 80%. If the deterministic folder-plus-import heuristics estimate a profile match below this threshold, the workflow requires interactive user confirmation or manual override before persisting the classification results.

To generate an architecture profile manifest, run the detection command in your project root to evaluate source roots and import patterns. This outputs a .claude/architecture-profile.md file and updates the .claude/.anti-vibe-manifest.json configuration.

Architecture detection requires codebases with detectable source roots such as src/, app/, or lib/. Without these standard directories, the folder heuristics cannot deterministically evaluate the structure, likely resulting in an unknown-mixed classification.