Which architectural styles are supported by the /arch skill?

The skill natively supports Hexagonal (Ports & Adapters), Layered, Clean, and MVC architectures, while also allowing for fully custom user-defined styles.

Where does the skill look for architecture rules?

It prioritizes extracting rules from CLAUDE.md, README.md, and ADRs, but also checks language-specific configs like tsconfig.json, pyproject.toml, and go.mod.

Can /arch detect circular dependencies?

Yes, the check mode specifically identifies cycles and backward imports that violate your project's defined architectural boundaries and layer rules.

How does the /arch learn command analyze my code?

It builds a comprehensive import graph, identifies directory clusters, and applies heuristics based on inbound vs. outbound import ratios to automatically infer layer levels.

Architecture Manager

Name: Architecture Manager
Author: dohernandez

bydohernandez

0•

Herramientas para Desarrolladores

Discovers, validates, and plans project architecture to maintain clean layer boundaries and prevent dependency drift.

The Architecture Manager skill provides a robust framework for maintaining structural integrity within Claude Code. It automates the discovery of existing patterns like Hexagonal or Clean Architecture by scanning documentation and source code, validates implementation against defined layer boundaries, and suggests the ideal placement for new modules. By analyzing import graphs and configuration files across multiple languages, it helps developers prevent circular dependencies and architectural erosion, ensuring long-term maintainability for complex codebases.

Características Principales

01AI-guided planning for new feature implementation and code placement

02Deep import graph analysis to infer layer hierarchy and detect violations

030 GitHub stars

04Automated architecture discovery from documentation, configs, and file structures

05Multi-language support for TypeScript, Python, Go, Rust, and Java

06Real-time architectural validation to prevent circular dependencies and layer bypass

Casos de Uso

01Onboarding to unfamiliar codebases by visualizing layer responsibilities and dependency flows

02Automating architectural audits to detect drift between implementation and design documentation

03Enforcing architectural constraints during refactoring to prevent 'spaghetti code' patterns

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dohernandez/claude-skills arch

For use in Claude.ai and ChatGPT

Download Skill