claude.md
프로젝트를 분석하고 CLAUDE.md를 작성해주세요.
아래 10가지 핵심 항목을 분석한 뒤, 이를 기반으로 한국어로 문서를 작성해주세요. docs폴더에 각 섹션 별로 md파일을 생성해서 정리해주세요
1. 프로젝트 개요: AI가 비즈니스 구조를 명확히 이해할 수 있도록 작성 (최우선)
반드시 포함할 핵심 내용:
- 제품의 핵심 포지션 및 목적
- 주요 사용자 대상
- 핵심 기능 및 향후 개선 방향
- 반드시 지켜야 하는 비즈니스 제약사항 및 UX 금지 규칙
전체 분량은 3~5개의 짧은 문단으로 간결하게 작성해주세요.
2. 전체 기술 스택: AI가 잘못된 의존성이나 버전을 사용하지 않도록 명확히 작성
반드시 포함할 핵심 내용:
- 프레임워크 및 정확한 버전
- 사용 언어
- 전역 스타일링 방식
- 공통 UI 컴포넌트 라이브러리
- 상태 관리 도구
- 테스트 도구
- 빌드 및 번들링 도구
- 백엔드 및 데이터 처리 인프라
3. 프로젝트 아키텍처 및 디렉토리 역할: AI가 저장소 구조를 이해할 수 있도록 작성
반드시 포함할 핵심 내용:
- 주요 최상위 디렉토리 역할
- 계층별 책임 분리 기준
- 전체 데이터 흐름 구조
- 관심사 분리 원칙
- 신규 기능 코드가 추가되어야 하는 위치
단순히 폴더 이름만 나열하지 말고, “왜 그렇게 구성되었는지”와 “어떤 규칙으로 사용하는지”를 중심으로 설명해주세요.
4. 코드 작성 규칙: AI가 높은 품질의 코드를 생성할 수 있도록 작성
반드시 포함할 핵심 내용:
- 파일명 규칙
- 컴포넌트 작성 패턴
- TypeScript 강타입 규칙
- 단일 파일 최대 길이 제한
- import/export 규칙
- 전역 예외 처리 방식
- 주석 작성 규칙
- 비동기 요청 처리 방식
5. UI 및 디자인 시스템: 프론트엔드 생산성을 높이기 위한 기준 작성
반드시 포함할 핵심 내용:
- 전체 UI 톤앤매너
- spacing 규칙
- typography 기준
- 인터랙션 피드백 방식
- 반응형 대응 규칙
- 접근성 지원 기준
- 컴포넌트 재사용 시 주의사항
6. 문구 및 카피라이팅 규칙: 운영형/서비스형 프로젝트에서 필수
반드시 포함할 핵심 내용:
- 문체의 간결성 기준
- 문장 표현 방식
- 전문성 있는 톤 유지 규칙
- 문장 길이 기준
- 사용 금지 마케팅 표현 목록
가능하다면 내부 브랜드 문서 또는 카피 가이드 링크도 함께 첨부해주세요.
7. 테스트 및 품질 기준: 얕은 구현과 저품질 결과 방지
반드시 포함할 핵심 내용:
- 반드시 테스트해야 하는 핵심 시나리오
- 신규 코드 작성 시 필수 테스트 규칙
- Lint 검사 기준
- 타입 검사 기준
- “작업 완료”로 판단하는 기준
8. 파일 및 컴포넌트 생성 규칙: 중복 개발 및 저장소 혼잡 방지
반드시 포함할 핵심 내용:
- 신규 파일 생성 위치 규칙
- 기존 컴포넌트 수정 여부 판단 기준
- 공통 로직 추출 시점
- 전체 프로젝트 공통 네이밍 규칙
9. 안전한 변경 규칙: 핵심 아키텍처 보호
반드시 포함할 핵심 내용:
- 공용 API 경로 임의 변경 금지
- 데이터베이스 스키마 무단 변경 금지
- 인증/권한 시스템 수정 금지
- 기존 버전과의 하위 호환 유지 규칙
- 대규모 구조 변경 시 사전 승인 필요 규칙
10. 프로젝트 전용 명령어: AI가 즉시 작업 가능한 실행 환경 제공
Anthropic 공식 권장 방식에 맞춰 아래 내용을 포함해주세요.
반드시 포함할 핵심 내용:
- 로컬 개발 명령어
- 실행 명령어
- 빌드 명령어
- 검증 명령어
- 테스트 명령어
AI가 별도 질문 없이 바로 실행할 수 있도록 실제 사용 중인 명령어를 모두 작성해주세요.