arch-review

Validate architectural rules by detecting layer violations and circular dependencies.

2|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/SukbeomH/HExoskeleton --skill arch-review-sukbeomh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-review
Source: https://github.com/SukbeomH/HExoskeleton/tree/main/.claude/skills/arch-review
Command: npx skills add https://github.com/SukbeomH/HExoskeleton --skill arch-review-sukbeomh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automatically validates code changes against predefined architectural rules, preventing common issues like circular dependencies and layer violations before they are merged.

Core Features & Use Cases

  • Circular Dependency Detection: Identifies import cycles within the src/ directory.
  • Layer Violation Checks: Enforces a strict UI → Service → Repository layering.
  • Complexity Analysis: Runs scripts to check function complexity and naming conventions.
  • Use Case: Before merging a significant refactor, run this skill to ensure the new code adheres to the established architectural patterns and doesn't introduce new violations.

Quick Start

Run the architecture review skill to check for layer violations and circular dependencies in the source code.

Frequently Asked Questions about arch-review

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

FAQPage Schema
How do I check for circular dependencies in my source code?

To check for circular dependencies, use scripts to scan the `src/` directory and identify import cycles. This validation catches architectural violations automatically before merging code changes.

How do I enforce layering rules like UI to Service to Repository?

Enforce UI to Service to Repository layering by using Grep and Glob scripts to check for layer violations. This validates that components adhere to strict architectural boundaries and prevents skipping layers.

Can I analyze code complexity and naming conventions automatically before a merge?

Yes, you can analyze code complexity and naming conventions automatically by running Bash scripts. These scripts validate code changes against predefined rules to ensure design quality before merging.

What is the best way to prevent architectural violations in a codebase?

The best way to prevent architectural violations is to automatically validate code changes against predefined rules. Checking for layer violations and circular dependencies using Grep and Glob ensures structural integrity.

Does this architectural review work without external dependencies?

Yes, the architectural review works without external dependencies. It relies solely on built-in scripts using Grep, Glob, and Bash to validate design quality and detect layer violations.

When should I run an architecture review on my code?

You should run an architecture review before merging a significant refactor. This ensures new code adheres to established architectural patterns and does not introduce new violations or circular dependencies.