everything-claude-code/docs/ko-KR/rules/patterns.md

공통 패턴

스켈레톤 프로젝트

새 기능을 구현할 때:

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

디자인 패턴

리포지토리 패턴

일관된 인터페이스 뒤에 데이터 접근을 캡슐화:

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

API 응답 형식

모든 API 응답에 일관된 엔벨로프 사용:

• 성공/상태 표시자 포함
• 데이터 페이로드 포함 (에러 시 null)
• 에러 메시지 필드 포함 (성공 시 null)
• 페이지네이션 응답에 메타데이터 포함 (total, page, limit)