architecture-testing

Automate architectural boundary and dependency rule enforcement with NetArchTest and ArchUnit.

1|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/mcj-coder/development-skills --skill architecture-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-testing
Source: https://github.com/mcj-coder/development-skills/tree/main/skills/architecture-testing
Command: npx skills add https://github.com/mcj-coder/development-skills --skill architecture-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and templates (resource) components.

What problem does it solve?

This Skill prevents architectural drift and technical debt by enforcing defined boundaries and dependency rules within your codebase through automated tests.

Core Features & Use Cases

  • Automated Boundary Enforcement: Integrates with testing frameworks (like NetArchTest for .NET or ArchUnit for Java) to automatically verify architectural rules.
  • Proactive Debt Prevention: Catches architectural violations early in the development cycle, preventing costly refactoring later.
  • Use Case: When starting a new project, use this Skill to set up automated tests that ensure your domain layer never directly calls your infrastructure layer, maintaining a clean separation of concerns.

Quick Start

Use the architecture-testing skill to set up automated tests for a new .NET project following Clean Architecture principles.

Frequently Asked Questions about architecture-testing

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

FAQPage Schema
How do I prevent architectural drift in a codebase using automated tests?

You can prevent architectural drift by integrating automated tests that verify dependency rules and architectural boundaries, catching violations early in the development cycle before they accumulate into costly technical debt.

How do I enforce Clean Architecture boundaries in a .NET project?

You can enforce Clean Architecture boundaries in .NET projects by using NetArchTest templates to write automated tests that verify rules, such as ensuring the domain layer never directly calls the infrastructure layer.

Can I use ArchUnit to test dependency rules in a Java project?

Yes, you can use provided ArchUnit templates to test dependency rules in Java projects, ensuring your codebase adheres to defined architectural patterns like Hexagonal or Layered architecture through automated checks.

What is the best way to stop domain layers from calling infrastructure layers?

The best way to stop domain layers from calling infrastructure layers is to set up automated boundary enforcement tests that continuously verify separation of concerns and fail the build upon dependency rule violations.

Does automated architecture testing work with Hexagonal architecture patterns?

Yes, automated architecture testing works with Hexagonal architecture patterns, providing templates to verify that your codebase adheres to defined structural boundaries and specific dependency rules within your development workflow.