python-fastapi-programmer:guard

Files (8)

• SKILL.md
• feature_template.py · assets/
• init_template.py · assets/
• shared_models_template.py · assets/
• shared_repository_template.py · assets/
• test_template.py · assets/
• analysis-guide.md · references/
• file-structure.md · references/

SKILL.md (first lines)

# Guard: Vertical Slice 아키텍처 지킴이

> 처음부터 엄격하게 - Vertical Slice 패턴 강제 적용 및 자동 리팩토링

---

## Part 1: Vertical Slice 패턴 규칙

**항상 적용되는 코드 작성 규칙**

### 핵심 원칙

**1 파일 = 1 기능 = 1 엔드포인트**

모든 기능은 완전히 독립된 단일 파일에 구현:
- DTO (Request/Response)
- Service (비즈니스 로직)
- Controller (엔드포인트)

### 모듈 구조

```
src/modules/{domain}/
├── __init__.py           # router 조합
├── {feature1}.py         # 기능 1 (완전한 Vertical Slice)
├── {feature2}.py         # 기능 2 (완전한 Vertical Slice)
├── _models.py            # 공유: SQLModel 정의
├── _repository.py        # 공유: DB 접근
└── _utils.py             # 공유: 유틸리티 (선택)
```

### 기능 파일 템플릿

각 기능 파일은 이 구조를 엄격히 따름:

```python
"""기능 설명 (한 줄)

METHOD /endpoint
"""

from fastapi import APIRouter
from pydantic import BaseModel

# ─────────────────────────────────────────────────
# Request/Response DTO
# ─────────────────────────────────────────────────

class SomeRequest(BaseModel):
    """요청 데이터"""
    ...

class SomeResponse(BaseModel):
    """응답 데이터"""
    ...

# ─────────────────────────────────────────────────
# Service (비즈니스 로직)
# ─────────────────────────────────────────────────

def do_something(...) -> SomeResponse:
    """비즈니스 로직 구현"""
    ...

# ─────────────────────────────────────────────────
# Controller (엔드포인트)
# ─────────────────────────────────────────────────

router = APIRouter()

@router.get("/endpoint")
def endpoint(...):
    """엔드포인트 핸들러"""
    ...
```

### __init__.py 템플릿

```python
"""{domain} 도메인"""

from fastapi import APIRouter

from .feature1 import router as feature1_router
from .feature2 import router as feature2_router

router = APIRouter(prefix="/{domain}", tags=["{domain}"])
router.include_router(feature1_router)
router.include_router(feature2_router)
```

### 공유 모듈 규칙

언더스코어 prefix로 공유 성격 표시:

| 파일 | 역할 | 예시 |
|------|------|------|
| `_models.py` | SQLModel 테이블 정의 | `class User(SQLModel, table=True): ...` |
| `_repository.py` | DB 접근 함수 | `async def get_user_by_id(...)` |
| `_utils.py` | 유틸리티 함수 | `def format_phone_number(...)` |

### 금지 사항

❌ **Controller/Service 분리 금지**
```python
# ❌ 잘못된 예
modules/users/
├── controllers/
│   └── user_controller.py
└── services/
    └── user_service.py
```

❌ **기능 간 직접 호출 금지**
```python
# ❌ users/create.py에서
from ..orders.create import create_order  # 순환 참조 위험
```

From ureca-corp/claude, MIT.

More from ureca-corp/claude