best-practices

Best Practices Skill

목적

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

기술별 레퍼런스 파일

기술	레퍼런스 파일
Python	references/python/python.md
Go	references/go/go.md
Rust	references/rust/rust.md
Java	references/java/java.md
React	references/react/react.md
Next.js	references/nextjs/nextjs.md
Node.js	references/nodejs/nodejs.md
TypeScript	references/typescript/typescript.md
Tailwind	references/tailwind/tailwind.md
Testing	references/testing/testing.md
API Design	references/api/api-design.md
Database	references/database/database.md

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

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

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

3. 코드 생성 시 적용

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

지원 기술 (12개)

기술	파일	주요 내용
Python	python.md	Type Hints, Pydantic, FastAPI, pytest
Go	go.md	Error Handling, Context, Concurrency
Rust	rust.md	Ownership, Result/Option, thiserror, Axum
Java	java.md	Hexagonal Architecture, Spring Boot, JPA
React	react.md	컴포넌트 패턴, 훅, 상태 관리
Next.js	nextjs.md	App Router, 서버 컴포넌트, 데이터 페칭
Node.js	nodejs.md	레이어 아키텍처, 에러 처리, 로깅
TypeScript	typescript.md	타입 패턴, 제네릭, 유틸리티 타입
Tailwind CSS	tailwind.md	유틸리티 클래스, 반응형, CVA
Database	database.md	스키마 설계, 쿼리 최적화, 마이그레이션
API Design	api-design.md	REST/GraphQL, 버저닝, 에러 응답
Testing	testing.md	TDD, 단위/통합/E2E 테스트 패턴

출력 형식

코드 생성 전 확인 (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