/web-app

CLAUDE.md — 웹 앱 프로젝트

프로젝트 개요

[TODO: 프로젝트가 뭘 하는지 한 줄로]

기술 스택

• 프레임워크: [TODO: React/Next.js/Vue/Svelte/Angular]
• 언어: [TODO: TypeScript/JavaScript]
• 스타일링: [TODO: Tailwind/CSS Modules/styled-components/Sass]
• 상태관리: [TODO: Redux/Zustand/Recoil/Pinia/없음]
• API 통신: [TODO: fetch/axios/React Query/SWR]
• 패키지 매니저: [TODO: npm/yarn/pnpm]

프로젝트 구조

[TODO: 주요 디렉토리 설명] src/ ├── components/ # 재사용 UI 컴포넌트 ├── pages/ # 페이지 (라우팅 단위) ├── hooks/ # 커스텀 훅 ├── utils/ # 유틸리티 함수 ├── styles/ # 전역 스타일 ├── api/ # API 호출 함수 └── types/ # 타입 정의

코딩 컨벤션

• 컴포넌트: [TODO: 함수형 컴포넌트, PascalCase 파일명 등]
• 스타일: [TODO: BEM, utility-first 등]
• 타입: [TODO: interface vs type, any 사용 금지 등]
• 임포트 순서: [TODO: 외부 → 내부 → 스타일 → 타입]

빌드 & 실행

• 개발 서버: [TODO: npm run dev]
• 빌드: [TODO: npm run build]
• 테스트: [TODO: npm run test]
• 린트: [TODO: npm run lint]

주의사항

• [TODO: 절대 수정하면 안 되는 파일/디렉토리]
• [TODO: 환경 변수 파일 (.env*) 건드리지 말 것]
• [TODO: 특정 브라우저 호환성 요구사항]

컴포넌트 설계 원칙

• [TODO: atomic design, 컴포넌트 분리 기준 등]
• [TODO: props 네이밍 규칙]
• [TODO: 접근성(a11y) 규칙]