feat: 계층적 CLAUDE.md 구조 및 도메인 아키텍처 개편

[kickbelldev]

Summary

프로젝트의 문서화 체계와 아키텍처를 대대적으로 개편하여 유지보수성과 개발 효율성을 크게 향상시켰습니다.

🏗️ 주요 변경사항

1. 계층적 CLAUDE.md 구조 도입

• 기존: 단일 거대 CLAUDE.md (360+ 줄)
• 개선: 스코프별 모듈화된 CLAUDE.md 시스템
  • 루트: CLAUDE.md (마스터 아키텍처 맵)
  • 1뎁스: src/domain/, src/app/, src/contents/
  • 2뎁스: src/domain/blog/, src/app/[category]/, src/app/_components/, src/app/_lib/

2. 도메인 아키텍처 정리

• 디렉토리 리네이밍: src/entities/ → src/domain/
• DDD 원칙 적용: 도메인 로직과 UI 레이어 명확한 분리
• 모듈 레벨 캐싱: SSG 최적화를 위한 빌드 타임 데이터 사전 로드

3. 문서화 체계 완전 개편

새로운 .context/ 디렉토리에 전문화된 가이드라인 추가:

• development-guidelines.md - 구현 패턴과 품질 기준
• styling-guide.md - Tailwind CSS, shadcn/ui 가이드
• git-workflow.md - 브랜치 전략, 커밋 컨벤션
• project-overview.md - 기술 스택, 상세 아키텍처
• commands.md - 개발 명령어 레퍼런스
• current-status.md - 최신 작업 상태 추적

📊 변경 통계

• 30개 파일 수정
• 1,101줄 추가, 360줄 삭제
• 8개 새로운 CLAUDE.md 생성
• 6개 전문 가이드라인 문서 추가

🎯 기대 효과

1. 개발 효율성 향상

   • 각 영역별 구체적인 컨텍스트 제공
   • 작업 스코프에 맞는 정확한 가이드라인

2. 아키텍처 일관성 보장

   • DDD 원칙 기반 명확한 레이어 분리
   • 타입 안전성과 성능 최적화 원칙 체계화

3. 온보딩 경험 개선

   • 계층적 문서 구조로 학습 곡선 완화
   • 역할별 전문화된 가이드라인 제공

Test Plan

• 모든 import 경로 업데이트 확인 (entities → domain)
• 새로운 CLAUDE.md 구조 검증
• .context 문서들 일관성 확인
• 타입 검사 통과 확인

🤖 Generated with Claude Code