arch

Discover, validate, and plan architecture boundaries across codebases.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/dohernandez/claude-skills --skill arch-dohernandez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch
Source: https://github.com/dohernandez/claude-skills/tree/main/plugins/arch/skills/arch
Command: npx skills add https://github.com/dohernandez/claude-skills --skill arch-dohernandez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architecture governance and compliance across codebases by discovering layers, validating import boundaries, and planning code placement.

Core Features & Use Cases

  • Discover, validate, and plan architecture boundaries across projects
  • Analyze imports to detect drift, violations, and provide remediation guidance
  • Support modes: configure, learn, check, and plan to guide architecture work

Quick Start

Run /arch configure to auto-discover your project architecture and review the proposed layer structure.

Frequently Asked Questions about arch

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

FAQPage Schema
How do I validate import boundaries and detect architecture drift in my codebase?

Validate import boundaries by analyzing import graphs to detect drift and violations across your architecture layers. The tool provides remediation guidance to fix incorrect dependencies and restore structural compliance.

How do I discover and configure my project's architecture layers automatically?

Discover architecture layers automatically by running configuration modes that parse documentation and config files. This auto-discovery proposes a layer structure tailored to your project's existing organization for immediate review.

Does this architecture analysis work with hexagonal and clean architecture patterns?

Architecture analysis works with hexagonal, layered, clean, mvc, and custom architectural patterns. It identifies layers and enforces boundaries regardless of the specific structural pattern your project follows.

How do I plan where new code should live in a layered architecture?

Plan new code placement by using planning modes that guide exactly where new files belong within your architecture. This ensures dependency inversion rules and layering boundaries are maintained before code is written.

What's the best way to enforce architecture compliance across an existing codebase?

Enforce architecture compliance by running check modes that analyze imports against discovered layers to identify violations. It detects structural drift and provides actionable remediation guidance to correct boundary breaches.