How does this skill handle file naming?

It validates that files are named according to their role (e.g., *_service.py for business logic or router_*.py for endpoints) and blocks the creation of generic or incorrectly suffixed files.

Why does the skill block HTTPException in the service layer?

To maintain strict layer separation. Services are intended for business logic and should throw domain-specific exceptions, allowing the router layer to decide which HTTP status code is appropriate for that error.

What is 'blocking validation' in this skill?

Blocking validation means the skill will prevent Claude from finalizing a file write or edit if the code violates the defined architectural rules, such as performing database operations directly inside a router.

Does it support frameworks other than FastAPI?

While the core Clean Architecture principles are universal, this specific skill is highly optimized for FastAPI-specific patterns like the Depends() injection system and standard Python async patterns.

Backend Architecture Enforcer

Name: Backend Architecture Enforcer
Author: yonatangross

byyonatangross

•

API Development

Enforces FastAPI Clean Architecture principles by validating layer separation and dependency injection patterns in real-time.

The Backend Architecture Enforcer is a specialized skill for Claude Code designed to automate the governance of FastAPI projects following the Router-Service-Repository pattern. It acts as a proactive gatekeeper, utilizing blocking validation to prevent architectural drift—such as database calls leaking into the router layer or HTTP exceptions appearing in services. By enforcing strict file-naming conventions, mandatory dependency injection, and async consistency, this skill ensures that production-grade backends remain maintainable, testable, and consistently structured throughout the development lifecycle.

Key Features

01Real-time detection of synchronous calls within asynchronous functions

02Prevention of HTTP-specific logic within business and data layers

03Automated file naming convention checks for backend modules

04Enforcement of FastAPI Depends() for all dependency injections

05Blocking validation for Router-Service-Repository layer separation

0669 GitHub stars

Use Cases

01Maintaining architectural integrity in complex, large-scale FastAPI codebases

02Automating code reviews for architectural compliance before files are saved

03Onboarding new developers to a standardized backend structure with automated guidance

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