How does it handle testing standards?

It enforces the AAA (Arrange-Act-Assert) pattern, descriptive naming conventions, and specific coverage thresholds for business logic and critical paths.

What is Right-Sizing in this skill?

Right-Sizing is a context-aware enforcement mechanism that adjusts architectural strictness based on project tier, ensuring you don't over-engineer a simple MVP while maintaining high standards for enterprise apps.

Can I override the automatic architecture detection?

Yes, users can manually set the project tier to bypass auto-detection, allowing you to use enterprise-grade patterns for smaller projects if you want to demonstrate specific skills.

Does it support both Python and TypeScript?

Yes, it includes patterns and rules optimized for popular stacks including FastAPI (Python) and Next.js/React (TypeScript/JavaScript).

Architecture Patterns & Validation

Name: Architecture Patterns & Validation
Author: yonatangross

byyonatangross

•

116

•

API Development

Enforces clean architecture, backend layer separation, and project structure conventions with context-aware right-sizing.

The Architecture Patterns skill provides a comprehensive framework for designing and validating production-ready software systems using Claude Code. It automates the enforcement of SOLID principles, hexagonal architecture, and domain-driven design (DDD) while intelligently adjusting its strictness based on the project's scale—from quick MVPs to complex enterprise systems. By validating layer boundaries, import directions, and testing standards, it ensures codebase maintainability and prevents common architectural anti-patterns like leaky abstractions or over-engineering.

Key Features

01116 GitHub stars

02Automated Clean Architecture validation (SOLID, Hexagonal, DDD)

03Strict backend layer separation (Router, Service, Repository)

04Standardized testing patterns (AAA pattern, coverage thresholds)

05Context-aware Right-Sizing to prevent over-engineering in small projects

06Project structure enforcement (nesting limits, unidirectional imports)

Use Cases

01Bootstrapping a new backend service with proper layer separation and DI

02Auditing an existing codebase for architectural violations and circular dependencies

03Standardizing testing practices and folder structures across a growing engineering team

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yonatangross/orchestkit architecture-patterns

For use in Claude.ai and ChatGPT

Download Skill