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.