Claude Code 쓸 때
프로젝트 안에 CLAUDE.md 하나만 덩그러니 두는 방식은
생각보다 금방 한계가 옴.
진짜 유지보수 가능한 구성은
보통 몇 개 층으로 나눠서 가져가는 편임.
CLAUDE.md : 프로젝트 전체 컨텍스트와 기본 규칙
settings.json : 권한, 모델, hooks 설정
rules/ : 주제별 규칙 분리
commands/ : 반복 가능한 workflow 축적
skills/ : 작업 맥락에 따라 동적으로 불러오는 능력
agents/ : 전용 서브 Agent 정의
hooks/ : 툴 호출 전후 자동 검증
결국 중요한 건
기능을 많이 넣는 게 아니라
역할별로 얼마나 깔끔하게 분리돼 있느냐에 가까움.
구조가 선명할수록
Claude Code도 더 안정적으로 굴러가고,
나중에 유지보수하거나 재사용하기도 훨씬 편해짐.
이건
Claude Code 프로젝트 구조를
한 번에 이해하는 데 꽤 좋은 그림 같음.