Best Practices

Best Practices Skill

목적

각 기술에 대해 검증된 베스트 프랙티스와 디자인 패턴을 적용하여 일관되고 유지보수 가능한 코드를 생성합니다.

기술별 레퍼런스 파일

베스트 프랙티스 적용 프로토콜

2. 베스트 프랙티스 로드 (필수)

references/{language}/{technology}.md 읽기
→ 패턴, 규칙, 예시 코드 확인
→ 금지 사항 확인
→ 체크리스트 확인

3. 코드 생성 시 적용

• 파일 구조: 해당 기술의 권장 구조 사용
• 네이밍: 기술별 컨벤션 적용
• 패턴: 검증된 디자인 패턴 사용
• 에러 처리: 표준 에러 처리 패턴 적용
• 테스트: 기술별 테스트 패턴 적용
• 금지 사항: 각 파일의 "금지 사항" 섹션 반드시 준수

지원 기술 (12개)

출력 형식

코드 생성 전 확인 (Silent Mode)

사용자에게 매번 알림을 보내지 않고 자동 적용합니다. 단, 적용한 패턴을 코드 주석이나 응답 말미에 간략히 언급합니다.

// Applied: python.md (Type Hints, Pydantic)
// Applied: react.md + tailwind.md (Function Components, CVA)

코드 생성 체크리스트

코드 생성 시 다음을 확인:

• 해당 기술의 베스트 프랙티스 파일 로드 완료
• 해당 기술의 권장 디렉토리 구조 사용
• 파일당 500줄 이하
• 모든 함수에 주석 (JSDoc/Docstring)
• 해당 기술의 네이밍 컨벤션 적용
• 에러 처리 패턴 적용
• 타입 정의 완전성
• 금지 사항 미적용 확인

🚨 Anthropic 공식 가이드라인 (필수 적용)

출처: docs.anthropic.com, console.anthropic.com

코드 작업 전 필수 행동

1. 관련 파일 먼저 읽고 이해 (추측 금지)
2. 코드베이스의 스타일, 컨벤션, 추상화 파악
3. 충분한 컨텍스트 확보 후 답변/수정 제안

할루시네이션 방지 규칙

• 열어보지 않은 파일 추측 금지
• 사용자가 언급한 파일 반드시 먼저 읽기
• 확실하지 않으면 "확인 필요" 인정
• 근거 없는 주장 절대 금지

상세 가이드: references/common/anthropic-official.md

참조 파일

폴더 구조 (스킬 내부 - 언어별 분류)

skills/best-practices/references/
├── _sections.md    # 전체 섹션 정의
├── _template.md    # 새 규칙 템플릿
├── typescript/     # 27개 (통합 + 세부 규칙)
├── react/          # 44개 (통합 + 세부 규칙)
├── python/         # 20개 (통합 + 세부 규칙)
├── go/             # 21개 (통합 + 세부 규칙)
├── rust/           # 21개 (통합 + 세부 규칙)
└── common/         # 12개 (공통 가이드)

참조 예시 (스킬 내부 경로)

# 전체 구조 확인
Read references/_sections.md

# 언어별 통합 가이드
Read references/typescript/typescript.md
Read references/react/react.md

# 기술별 인덱스
Read references/react/react-index.md
Read references/typescript/ts-index.md

# 세부 규칙
Read references/react/react-async-defer-await.md
Read references/typescript/ts-error-result-pattern.md

# 공통 가이드
Read references/common/api-design.md
Read references/common/security.md