architectural-principles

What problem does it solve?

This skill helps teams detect and remediate violations of core architectural principles so that systems remain modular, testable, and resilient to change. It focuses on identifying where business rules are entangled with infrastructure, where layers are incorrectly coupled, and where bounded contexts are blurred, enabling cost-effective refactoring decisions.

Core Features & Use Cases

• Architecture Diagnostics: Map code and modules to architectural layers and flag separation-of-concerns and dependency-rule violations.
• Ports & Adapters Guidance: Identify missing interfaces and suggest adapter patterns to decouple domain from infrastructure.
• Bounded Context Analysis: Detect shared entities and propose anti-corruption layers or explicit contracts to preserve context boundaries.
• Use Case: During a codebase review, produce a prioritized list of violations with evidence, architectural impact, and concrete refactoring recommendations.

Quick Start

Ask the agent to review the repository and produce an architectural analysis listing violations, evidence, impacts, and recommended refactorings.