What problem does it solve?
This Skill eliminates unstructured, eroding software architecture that leads to unmaintainable codebases, repeated architectural relitigation, and costly rewrites as systems scale. It provides a shared, principled framework for evaluating structural decisions so teams and agents can maintain change locality and preserve critical system capabilities over time.
Core Features & Use Cases
- Core Principle Enforcement: Validates adherence to 9 proven architectural principles including information hiding, dependency direction, layer discipline, acyclic module graphs, bounded-context isolation, and ADR coverage.
- Anti-Pattern Detection: Provides explicit red flags and rationalization prevention guidance to catch common architectural mistakes during code review and system design.
- Evolutionary Architecture Guidance: Includes deep-dive resources for implementing fitness functions, vertical slice architecture, event sourcing alignment, and sociotechnical design to match team and agent boundaries.
- Use Case: For a team building a polyglot monorepo, use this skill to validate that module dependencies point toward stable abstractions, confirm all load-bearing decisions have greppable ADR back-references in code, and ensure architectural characteristics have mechanized fitness functions in CI.
Quick Start
Invoke the architecture skill during code review to validate module boundaries, dependency direction, and ADR coverage for recent changes.
