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.