How does this skill handle database interactions?

It utilizes the Repository Pattern within the Infrastructure layer, defining abstract interfaces in the Domain layer so that the business logic never directly depends on ORMs like SQLAlchemy or Tortoise.

Is this skill suitable for small projects?

While it adds some initial boilerplate, it is highly recommended for any project expected to grow in complexity, as it prevents the 'spaghetti code' often found in smaller FastAPI prototypes.

Does it include testing strategies?

Yes, the architecture is designed specifically for testability, allowing for isolated unit tests for domain logic and integration tests for the API and Infrastructure layers.

What are the benefits of using Clean Architecture with FastAPI?

It separates business logic from technical implementation, making the application easier to test, maintain, and migrate between different databases or frameworks without affecting core functionality.

FastAPI Clean Architecture

Name: FastAPI Clean Architecture
Author: rafaelkamimura

byrafaelkamimura

•

API開発

Builds maintainable and scalable Python backends using Clean Architecture principles and FastAPI.

This skill provides a comprehensive framework for developing robust FastAPI applications by enforcing a strict three-layer separation of concerns: Domain, Infrastructure, and API layers. It guides users through implementing the repository pattern, dependency injection, and framework-agnostic business logic, ensuring that core service functionality remains decoupled from external dependencies like databases or web frameworks. Based on production patterns from enterprise financial systems, it is the ideal choice for developers looking to implement Domain-Driven Design (DDD) and ensure high testability in their Python microservices.

主な機能

01Strict three-layer architecture (API, Domain, Infrastructure)

02Dependency Injection container configuration for Python

03Repository and Service interface patterns for maximum decoupling

044 GitHub stars

05Standardized project structure for enterprise-grade scalability

06Pure domain entity modeling with encapsulated business rules

ユースケース

01Bootstrapping new enterprise FastAPI projects with modular structure

02Refactoring existing FastAPI services to improve maintainability and testability

03Implementing complex business logic using Domain-Driven Design principles

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rafaelkamimura/claude-tools fastapi-clean-architecture

For use in Claude.ai and ChatGPT

Download Skill