# 공통 패턴

## 스켈레톤 프로젝트

새 기능을 구현할 때:
1. 검증된 스켈레톤 프로젝트를 검색
2. 병렬 에이전트로 옵션 평가:
   - 보안 평가
   - 확장성 분석
   - 관련성 점수
   - 구현 계획
3. 가장 적합한 것을 기반으로 클론
4. 검증된 구조 내에서 반복 개선

## 디자인 패턴

### 리포지토리 패턴

일관된 인터페이스 뒤에 데이터 접근을 캡슐화:
- 표준 작업 정의: findAll, findById, create, update, delete
- 구체적 구현이 저장소 세부사항 처리 (데이터베이스, API, 파일 등)
- 비즈니스 로직은 저장소 메커니즘이 아닌 추상 인터페이스에 의존
- 데이터 소스의 쉬운 교체 및 모킹을 통한 테스트 단순화 가능

### API 응답 형식

모든 API 응답에 일관된 엔벨로프 사용:
- 성공/상태 표시자 포함
- 데이터 페이로드 포함 (에러 시 null)
- 에러 메시지 필드 포함 (성공 시 null)
- 페이지네이션 응답에 메타데이터 포함 (total, page, limit)