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 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--56993e