architecture

Identify and fix architectural boundary violations in DDD/CQRS projects.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ericklemos/ai-tools --skill architecture-ericklemos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture
Source: https://github.com/ericklemos/ai-tools/tree/main/.agents/skills/architecture
Command: npx skills add https://github.com/ericklemos/ai-tools --skill architecture-ericklemos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforces architectural integrity and layer separation across the project's architectural layers, helping teams prevent boundary leaks and drift.

Core Features & Use Cases

  • Enforces DTO-based web-layer boundaries to avoid leaking domain/data models into HTTP requests and responses.
  • Segregates CQRS commands and queries, ensuring a clean separation of concerns and auditability.
  • Provides guidance and structured checks to identify and fix one architectural debt per session, aligning with TDD principles.

Quick Start

Run an architectural audit to identify a boundary violation in the current codebase and propose a targeted fix.

Frequently Asked Questions about architecture

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

FAQPage Schema
How do I fix architectural boundary violations between web, domain, and persistence layers?

To fix architectural boundary violations, you identify leaks where layers are improperly coupled. This enforces strict layer separation by ensuring the web layer uses DTOs and the domain remains decoupled from persistence.

Why does my web layer leak domain models into HTTP requests and responses?

Your web layer leaks domain models because it lacks strict data transfer object boundaries. Enforcing DTO-based web-layer boundaries prevents domain models from leaking into HTTP requests and responses, preserving architectural integrity.

How do I enforce strict CQRS command and query separation in a DDD project?

To enforce CQRS command and query separation in a DDD project, you segregate read and write operations into distinct paths. This ensures clean separation of concerns and maintains auditability across your architectural layers.

Can I align architectural boundary fixes with an existing TDD workflow?

Yes, you can align architectural boundary fixes with a TDD workflow. The process identifies and fixes one architectural debt per session, providing structured checks that adhere to TDD principles and maintain test coverage.

What is the best way to audit a multi-layer codebase for architectural drift?

The best way to audit a multi-layer codebase for architectural drift is to run a targeted architectural audit. This identifies specific boundary violations in DDD or CQRS projects and proposes a targeted fix to prevent leaks.