Why are certain file names blocked?

To maintain a searchable and consistent codebase, the skill enforces suffixes like _service.py and _repository.py, preventing ambiguous naming patterns.

Can I perform database queries in my routers?

No, the enforcer blocks database operations in routers, requiring you to move that logic to the repository layer to maintain clean separation of concerns.

What layers does this skill enforce?

It enforces a four-layer architecture: Routers (HTTP concerns), Services (Business logic), Repositories (Data access), and Models (Data structures).

Does this skill support sync and async code?

Yes, it specifically validates async consistency and blocks sync calls within async functions to prevent event loop blocking in FastAPI.

Backend Architecture Enforcer

Name: Backend Architecture Enforcer
Author: yonatangross

byyonatangross

•

API Development

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

This skill acts as a strict architectural guardian for FastAPI projects, ensuring codebases adhere to the router-service-repository pattern. It prevents common anti-patterns such as performing database operations in route handlers or raising HTTP exceptions within service layers. By enforcing strict file naming conventions and mandatory dependency injection using FastAPI's Depends() pattern, it helps developers maintain a highly testable, scalable, and modular backend structure while proactively catching async/sync mismatches.

Key Features

01Mandatory FastAPI dependency injection validation to prevent direct instantiation

02Blocking validation for layer separation across routers, services, and repositories

03Automatic detection of sync-in-async blocking calls for performance optimization

04Strict file naming convention enforcement for consistent codebase organization

05Domain exception pattern enforcement to keep business logic HTTP-agnostic

0629 GitHub stars

Use Cases

01Refactoring legacy monolithic backend scripts into a modular, testable clean architecture

02Scaling large FastAPI codebases with multiple contributors while maintaining architectural integrity

03Onboarding developers to a project by automating the enforcement of architectural standards

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yonatangross/skillforge-claude-plugin backend-architecture-enforcer

For use in Claude.ai and ChatGPT

Download Skill