Agent skill · software engineering · yonatangross
architecture-patterns
Clean and layered architecture patterns, project structure and test-standard validation. Use when designing system boundaries or enforcing structure. For tier sizing, use scope-appropriate-architecture.
Why this skill is useful
Provides domain-specific architecture validation rules and patterns that the AI wouldn't reliably generate on its own.
What it needs
About 7k tokens when loaded. Last updated 2026-08-06. 215 stars on the source repository.
What this skill does
<!-- directive-density: intentional (teaches anti-patterns; NEVER markers describe real layering violations, not aspirational guidance) --> Architecture Patterns Consolidated architecture validation and enforcement patterns covering clean architecture, backend layer separation, project structure conventions, and test standards. Each category has individual rule files in rules/ loaded on-demand. House scars and dated decisions rescued from retired reference tutorials live in references/ork-delta.md; the tutorials themselves are upstream's job (see "Upstream coverage" below). Quick Reference Category Rules Impact When to Use ---------- ------- -------- ------------- Clean Architecture 3 HIGH SOLID principles, hexagonal architecture, ports & adapters, DDD Project Structure 2 HIGH Folder conventions, nesting depth, import direction, barrel files Backend Layers 3 HIGH Router/service/repository separation, DI, file naming Test Standards 3 MEDIUM AAA pattern, naming conventions, coverage thresholds Right-Sizing 2 HIGH Architecture tier selection, over-engineering prevention, context-aware enforcement Total: 13 rules across 5 categories Quick Start Clean Architecture SOLID principles, hexagonal architecture, ports and adapters, and DDD tactical patterns for maintainable backends. Rule File Key Pattern ------ ------ ------------- Hexagonal Architecture rules/clean-hexagonal.md Driving/driven ports, adapter implementations, layer structure SOLID & Dependency Rule rules/clean-dependency-rule.md Protocol-based interfaces, dependency inversion, FastAPI DI DDD Tactical Patterns rules/clean-ports-adapters.md Entities, value objects, aggregate roots, domain events Design review checklist: checklists/solid-checklist.md. Domain entity scaffold: scripts/domain-entity-template.py. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills yonatangross/architecture-patterns