Verified:GitHub

detect-architecture

Classify repository architecture into five profiles using folder and import heuristics.

Updated Mar 8, 2026

Search Tags:#TDD workflow #project classification #architecture detection #confidence threshold #manifest update #folder heuristics #import analysis

Ready to run

npx skills add https://github.com/luyzkk/Anti-Vibe-Coding --skill detect-architecture

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: detect-architecture
Source: https://github.com/luyzkk/Anti-Vibe-Coding/tree/main/skills/detect-architecture
Command: npx skills add https://github.com/luyzkk/Anti-Vibe-Coding --skill detect-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identifying the right architectural style for an unfamiliar or partially structured codebase so you can apply the correct Anti-Vibe-Coding workflow instead of guessing.

Core Features & Use Cases

Architectural profile classification: Classifies the project into one of five profiles (clean-architecture-ritual, mvc-flat, vertical-slice, nextjs-app-router, unknown-mixed).
Deterministic heuristic detection: Uses folder structure plus import sampling to estimate which profile best matches the code.
Confidence-gated confirmation: If confidence is below 80%, it asks for interactive confirmation or manual override before persisting results.

Quick Start

Run /anti-vibe-coding:detect-architecture in your project root to generate .claude/architecture-profile.md and update .claude/.anti-vibe-manifest.json.

Frequently Asked Questions about detect-architecture

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I detect my codebase architecture profile automatically?▼

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.

What architectural patterns can be identified through folder heuristics and import analysis?▼

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.

Can I classify a Next.js project using app router detection?▼

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.

What is the confidence threshold for architecture detection before requiring manual override?▼

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.

How do I generate an architecture profile manifest for my repository?▼

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.

Does architecture detection work on codebases without standard src or lib directories?▼

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.