습관 02 · 전체 5

CLAUDE.md를 살아있는 문서로

세션 시작 시 자동으로 읽히는 프로젝트 설명서. 한 번 쓰고 잊는 게 아니라 프로젝트가 발전할 때마다 업데이트합니다.
📄
CLAUDE.md
프로젝트 루트에 두면 Claude Code가 매 세션 자동으로 읽음
Next.js 14 · vitest · TypeScript strict
함수명은 camelCase
에러 처리는 Result 타입
API 응답: { data, error, meta }
any 타입 사용 금지
세션 컨텍스트
효과적으로 관리하는 4가지 원칙
1간결하게. 너무 길면 중요 정보가 묻힙니다.
2살아있게. 모듈·컨벤션 변경 시 즉시 반영.
3매 세션 알아야 하는 것만. "모든 것"을 쓰지 않기.
4길어지면 참조로. lazy loading · progressive disclosure.
100~200줄 이하를 유지하는 것이 중요. 더 길어진다면 다른 파일로 분리하고 참조하는 패턴을 쓰세요.