everything-claude-code/docs/ko-KR/rules/coding-style.md

코딩 스타일

불변성 (중요)

항상 새 객체를 생성하고, 기존 객체를 절대 변경하지 마세요:

// 의사 코드
잘못된 예:  modify(original, field, value) → 원본을 직접 변경
올바른 예: update(original, field, value) → 변경 사항이 반영된 새 복사본 반환

근거: 불변 데이터는 숨겨진 사이드 이펙트를 방지하고, 디버깅을 쉽게 하며, 안전한 동시성을 가능하게 합니다.

파일 구성

많은 작은 파일 > 적은 큰 파일:

• 높은 응집도, 낮은 결합도
• 200-400줄이 일반적, 최대 800줄
• 큰 모듈에서 유틸리티를 분리
• 타입이 아닌 기능/도메인별로 구성

에러 처리

항상 에러를 포괄적으로 처리:

• 모든 레벨에서 에러를 명시적으로 처리
• UI 코드에서는 사용자 친화적인 에러 메시지 제공
• 서버 측에서는 상세한 에러 컨텍스트 로깅
• 에러를 절대 조용히 무시하지 않기

입력 유효성 검증

항상 시스템 경계에서 유효성 검증:

• 처리 전에 모든 사용자 입력을 검증
• 가능한 경우 스키마 기반 유효성 검증 사용
• 명확한 에러 메시지와 함께 빠르게 실패
• 외부 데이터를 절대 신뢰하지 않기 (API 응답, 사용자 입력, 파일 내용)

코드 품질 체크리스트

작업 완료 전 확인:

• 코드가 읽기 쉽고 이름이 적절한가
• 함수가 작은가 (<50줄)
• 파일이 집중적인가 (<800줄)
• 깊은 중첩이 없는가 (>4단계)
• 적절한 에러 처리가 되어 있는가
• 하드코딩된 값이 없는가 (상수나 설정 사용)
• 변이가 없는가 (불변 패턴 사용)