What architectural pattern does this skill enforce?

It enforces a standardized FastAPI Clean Architecture using distinct Router, Service, Repository, and Model layers to ensure separation of concerns.

Does it support async/await validation?

Yes, it detects sync database or blocking calls inside async functions to prevent event loop blocking in FastAPI applications.

Why does it block HTTPExceptions in the service layer?

To keep business logic decoupled from the transport layer. Services should raise domain exceptions, which the router then converts into the appropriate HTTP status codes.

How does it handle file naming validation?

The skill mandates specific naming suffixes such as _service.py and _repository.py, blocking changes that do not follow the project's structural conventions.

Can I use direct class instantiation with this skill?

No, the skill enforces the use of FastAPI's Depends() pattern to ensure all components are properly injected and easily mockable for testing.

FastAPI Clean Architecture Enforcer

Name: FastAPI Clean Architecture Enforcer
Author: yonatangross

byyonatangross

•

API Development

Enforces strict layer separation and Clean Architecture patterns in FastAPI projects through automated, blocking validation.

The Backend Architecture Enforcer is a specialized Claude Code skill designed to maintain codebase integrity by strictly enforcing the Router-Service-Repository pattern in FastAPI applications. It provides real-time, blocking validation to prevent architectural drift, such as database logic leaking into route handlers or HTTP exceptions appearing in business logic layers. By automating the enforcement of dependency injection patterns, async consistency, and standardized naming conventions, it ensures that backend services remain modular, highly testable, and production-ready.

Key Features

01Strict file-naming convention checks for services and repositories

02Detection of database operations within HTTP router layers

03Automated Router-Service-Repository layer validation

04Async/await consistency and sync-call detection in async code

05Blocking enforcement of FastAPI Dependency Injection (Depends())

0669 GitHub stars

Use Cases

01Refactoring monolithic FastAPI backends into modular Clean Architecture

02Ensuring testability by mandating dependency injection over direct instantiation

03Scaling FastAPI teams by automating architectural code reviews

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yonatangross/orchestkit backend-architecture-enforcer

For use in Claude.ai and ChatGPT

Download Skill