vp-s02-layer-architecture

Identify and validate architectural layer patterns in codebases for governance assessments.

1|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/velesar/alpha-zero-review- --skill vp-s02-layer-architecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vp-s02-layer-architecture
Source: https://github.com/velesar/alpha-zero-review-/tree/main/skills/vp-s02-layer-architecture
Command: npx skills add https://github.com/velesar/alpha-zero-review- --skill vp-s02-layer-architecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Layered architectures are common but prone to violations where inner modules depend on outer frameworks, leading to tight coupling and brittle systems. VP-S02 analyzes repository structure and mental-model context to detect and map layer boundaries and assess conformance with architectural principles.

Core Features & Use Cases

  • Detect patterns: clean architecture, layered, hexagonal, and MVC-like separations.
  • Map layers with purpose, allowed dependencies, and potential violations to guide governance.
  • Generate structured assessments for architecture reviews and incremental improvements.

Quick Start

Run VP-S02 on a repository to identify its layer architecture and generate a structured report.

Frequently Asked Questions about vp-s02-layer-architecture

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

FAQPage Schema
How do I check if my codebase follows clean architectural layering principles?

To check clean architectural layering, analyze your repository structure to detect core layers like domain, application, adapters, and infrastructure. This process validates allowed dependencies and identifies potential violations to ensure layering principles are respected.

What is the best way to detect hexagonal architecture violations in a software project?

Detecting hexagonal architecture violations involves mapping layer boundaries and assessing conformance with architectural principles. It identifies where inner domain modules improperly depend on outer frameworks, generating a structured assessment for governance.

Can I use this architecture analysis on MVC-like and layered codebases?

Yes, you can apply this architecture analysis to MVC-like and layered codebases. The detection mechanism supports clean, layered, and hexagonal architectural separations to map layers and evaluate their structural dependencies.

How do I generate an architecture review report for repository layer boundaries?

To generate an architecture review report, run an analysis on your repository to map layers with their purpose and allowed dependencies. It outputs a structured assessment identifying boundary violations ready for governance.

Do I need codegraph for semantic checks when validating domain design layering?

You do not strictly need codegraph for validating domain design layering, but it is optionally used for semantic checks. The analysis loads mental-model context to detect architectural layer patterns and assess dependency conformance.

Why does tight coupling occur in layered architectures and how is it identified?

Tight coupling in layered architectures occurs when inner modules depend on outer frameworks, creating brittle systems. It is identified by analyzing repository structure and mental-model context to detect dependency violations across architectural boundaries.