everything-claude-code / rules

---
description: "ECC coding style: immutability, file organization, error handling, validation"
alwaysApply: true
---
# 코딩 스타일

## 불변성 (중요)

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

```
// Pseudocode
WRONG:  modify(original, field, value) → changes original in-place
CORRECT: update(original, field, value) → returns new copy with change
```

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

## 파일 구성

많은 작은 파일 > 적은 큰 파일:
- 높은 응집도, 낮은 결합도
- 일반적으로 200-400줄, 최대 800줄
- 큰 모듈에서 유틸리티 추출
- 타입별이 아닌 기능/도메인별로 구성

## 오류 처리

항상 포괄적으로 오류를 처리하세요:
- 모든 수준에서 오류를 명시적으로 처리
- UI 관련 코드에서는 사용자 친화적 오류 메시지 제공
- 서버 측에서는 상세한 오류 컨텍스트 기록
- 오류를 절대 조용히 무시하지 않기

## 입력 검증

항상 시스템 경계에서 검증하세요:
- 처리 전 모든 사용자 입력 검증
- 가능한 경우 스키마 기반 검증 사용
- 명확한 오류 메시지와 함께 빠르게 실패
- 외부 데이터(API 응답, 사용자 입력, 파일 내용)를 절대 신뢰하지 않기

## 코드 품질 체크리스트

작업 완료 전 확인:
- [ ] 코드가 읽기 쉽고 이름이 적절한가
- [ ] 함수가 짧은가 (50줄 미만)
- [ ] 파일이 집중되어 있는가 (800줄 미만)
- [ ] 깊은 중첩이 없는가 (4단계 초과)
- [ ] 적절한 오류 처리가 되어 있는가
- [ ] 하드코딩된 값이 없는가 (상수 또는 설정 사용)
- [ ] 변경이 없는가 (불변 패턴 사용)

More agent context in junimnjw/everything-claude-code

189 other files this repository gives its agents, the first 60 shown.