py-feature

Automate end-to-end Python/FastAPI feature development with clean architecture and TDD.

3|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/vndee/engineering-skills --skill py-feature
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: py-feature
Source: https://github.com/vndee/engineering-skills/tree/main/.claude/skills/py-feature
Command: npx skills add https://github.com/vndee/engineering-skills --skill py-feature

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured, test-driven approach to implementing new features, endpoints, or use cases in a Python/FastAPI backend using clean architecture, ensuring domain, application, infrastructure, and interfaces align and stay type-safe.

Core Features & Use Cases

  • Layer-by-layer TDD workflow that starts from domain entities and validates them before wiring to application, infrastructure, and interfaces.
  • Explicit repository protocols and typed domain models to preserve boundaries and testability.
  • End-to-end path from domain modeling to HTTP routing, with mock-based unit tests and integration tests for PostgreSQL via SQLAlchemy.
  • Emphasis on strong typing, test coverage, and deterministic development patterns.

Quick Start

Start by defining a domain entity, create a corresponding use case, implement a repository, and expose it via a FastAPI router.

Frequently Asked Questions about py-feature

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a FastAPI backend using clean architecture?

Structure a FastAPI backend using clean architecture by separating domain entities, application use cases, repository protocols, and HTTP interfaces into distinct layers. This Skill automates generating that typed, boundary-enforced layer-by-layer structure for new features end-to-end.

What is the best way to implement FastAPI endpoints with domain-driven design?

The best way to implement FastAPI endpoints with domain-driven design is starting from domain entities, validating them, then wiring use cases and repository protocols before exposing HTTP routes. This Skill automates that exact TDD workflow to keep domain and infrastructure boundaries type-safe.

How do I test FastAPI repository protocols with SQLAlchemy and PostgreSQL?

Test FastAPI repository protocols with SQLAlchemy and PostgreSQL by running mock-based unit tests for domain logic and integration tests for database infrastructure. This Skill generates both test layers automatically to verify repository boundaries and PostgreSQL integration deterministically.

Can I use this approach for existing Python projects that need new features?

Yes, you can apply this clean architecture approach to existing Python projects needing new features. The Skill requires typed Python code and domain-driven design patterns, automating use-case creation, repository protocols, and FastAPI router integration for your codebase.

Does clean architecture development work without strong typing in Python?

Clean architecture development does not work well without strong typing in Python. This Skill requires typed Python code to preserve domain boundaries and ensure type-safe interactions between application, infrastructure, and interface layers during feature development.