What technologies are preferred by this skill?

The primary stack includes FastAPI for web APIs, PostgreSQL for relational data, and SQLAlchemy with Alembic for ORM and migrations.

How does it handle different project types?

It distinguishes between personal projects, which require strict standards and 80% test coverage, and client work, which uses an adaptive approach based on team constraints.

Does it include security checks?

Yes, it flags common security anti-patterns like secrets in code, running Docker as root, missing input validation, and the lack of health checks.

What architectural pattern does this skill promote?

It enforces a strict three-layer architecture: Routes/Controllers for HTTP handling, a Service layer for business logic, and a Repository layer for data access abstraction.

Sam's Architecture Standards

Name: Sam's Architecture Standards
Author: sam-dumont

bysam-dumont

•

API Development

Enforces mature architectural patterns, anti-pattern detection, and robust engineering standards for Python web APIs and system design.

This skill codifies a high-standard architectural framework designed for building scalable and maintainable Python applications using the Service-Repository-Database pattern. It acts as an automated architect that flags common anti-patterns like premature microservices and YAGNI violations while ensuring non-negotiable standards such as 80% test coverage, mandatory CI/CD pipelines, and secure Docker configurations. Whether starting a new project or auditing a mature codebase, it provides context-aware guidance that distinguishes between strict personal standards and adaptive client requirements.

Key Features

01Enforcement of the Service-Repository-Database three-layer architecture

0233 GitHub stars

03Mandatory CI/CD and testing standards with 80% minimum coverage

04Context-aware guidance for personal vs. client project ownership levels

05Standardized FastAPI project structure and database migration policies

06Automated anti-pattern detection for over-engineering and security risks

Use Cases

01Initial project scaffolding and infrastructure planning for Python APIs

02Transitioning monolithic applications into modular architectures with clear boundaries

03Conducting architectural audits of existing codebases for consistency and security

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add sam-dumont/claude-skills sams-architecture

For use in Claude.ai and ChatGPT

Download Skill