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