fastapi-best-practices
Use this skill when you are developing a FastAPI application and want to ensure that you are following best practices for project structure, code organization, and common patterns. This skill can help you create maintainable and scalable FastAPI projects by providing guidelines and recommendations.
Skill: FastAPI DDD & Hexagonal Architecture Standard Guide
이 가이드는 FastAPI 프레임워크 기반 프로젝트에서 도메인 주도 설계(DDD) 및 헥사고날 아키텍처(Hexagonal Architecture)를 일관성 있게 적용하기 위한 표준 가이드라인을 제공합니다.
0. 프로젝트 구조 (Standard Project Structure)
app/
├── main.py
├── settings.py # pydantic-settings 기반 환경 설정
├── libs/ # [SHARED] 공통 의존성 (DI Container, Global Exceptions)
│ ├── containers.py # Dependency Injection (dependency-injector) 설정
│ └── exceptions.py # 전역 예외 및 에러 핸들러
└── routes/ # [DOMAINS] 도메인 기반 API 라우트
└── {domain_name}/ # 개별 도메인 단위 (예: users, orders, products)
├── interface/ # [IN] Entry Points (Controller, Request/Response Schema)
│ ├── controller.py
More from datamktkorea/agent-skills
git-commit
A skill for writing Git commit messages. It follows rules combining Conventional Commits and Gitmoji to maintain a consistent commit history.
12git-pull-request
This skill is used by the AI agent to automatically generate Pull Request (PR) content by analyzing Git commit logs and branch strategies. It activates when the user requests to "Create a PR," "Summarize changes," or specifies a commit range for documentation.
9readme-writing
A skill for writing and optimizing a project's README.md file in accordance with standard conventions and templates. It ensures compliance with standards and maintains documentation quality when creating, reviewing, or refactoring project documentation. This skill is triggered during tasks related to README generation and documentation updates.
6react-state-orchestration
Clean architecture patterns for TanStack Query v5 + Zustand 5 in React/Next.js applications. Use this skill when writing, reviewing, or refactoring state management code — especially when touching server data fetching, Zustand stores, or async mutations. Triggers on tasks involving React Query hooks, Zustand selectors, optimistic updates, or cache management.
2write-meeting-notes
Writes structured meeting notes for team meetings. Use this skill whenever the user provides meeting content — a transcript, script, audio file path, or rough notes — and wants it turned into a proper meeting record. Trigger on phrases like "회의록 써줘", "미팅 노트 정리해줘", "회의 내용 정리", "write meeting notes", or when a user pastes a meeting transcript and says "이거 회의록으로 만들어줘". Also trigger when the user shares a meeting recording or file and asks to summarize or document it.
1