architecture

Discover codebase layers and generate YAML boundary configuration files.

2|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/roach88/claude-config --skill architecture-roach88
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/roach88/claude-config/tree/main/skills/architecture
Command: npx skills add https://github.com/roach88/claude-config --skill architecture-roach88

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually tracking and enforcing dependency rules between codebase layers leads to architectural drift, accidental cross-layer references, and hard-to-track technical debt. This Skill eliminates that manual overhead by automatically discovering existing layer patterns and validating changes against defined boundaries.

Core Features & Use Cases

  • Automatic Layer Discovery: Scans top-level codebase directories to identify natural layers and their existing cross-reference patterns.
  • Editable Boundary Configuration: Generates a human-readable YAML config file that defines allowed dependencies between layers, which can be freely adjusted by the team.
  • Real-Time Validation: Integrates with a post-edit hook to warn developers immediately when a change violates defined architecture boundaries.
  • Use Case: For a project with separate rules, scripts, skills, and agents directories, use this Skill to automatically detect that the agents directory references all other layers, generate a boundary config, and get warnings when an edit introduces an unapproved cross-layer reference.

Quick Start

Ask the AI to run the architecture init command to automatically discover your project's codebase layers and generate a dependency boundary configuration file for your team to review.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I enforce dependency boundaries and prevent cross-layer references in my codebase?

Automated layer discovery scans your codebase directories to identify natural layers and existing cross-reference patterns. It generates an editable YAML configuration file defining allowed dependencies, which a post-edit hook uses to validate changes and prevent architectural drift.

How do I automatically discover codebase layers and generate a boundary config?

You can automatically discover codebase layers by running an architecture initialization command that scans top-level directories. This process identifies existing cross-directory dependency patterns and outputs a human-readable YAML boundary configuration file for your team to review and adjust.

Can I customize the generated YAML boundary configuration for my project?

Yes, the generated YAML boundary configuration is fully editable. After the automatic layer discovery process identifies your codebase's natural layers and existing cross-references, your team can freely adjust the allowed dependency rules within the YAML file to match your architectural requirements.

What is the best way to warn developers about unplanned cross-layer references during development?

The best way to warn developers is integrating a post-edit hook that validates changes against defined architecture boundaries in real-time. This immediate validation warns developers when an edit introduces an unapproved cross-layer reference, preventing accidental architectural drift.

Does this dependency boundary enforcement work for projects with multiple distinct directories?

Yes, dependency boundary enforcement works for projects with distinct directories like rules, scripts, skills, and agents. It detects existing cross-directory dependency patterns, generates a boundary config, and provides warnings when edits introduce unapproved cross-layer references between these layers.