sample-nuxt-project/.claude/project/conventions.md

프로젝트 전용 컨벤션

이 파일은 fe-common-rules/templates/project/conventions.md 에서 복사된 양식입니다. 공통 지침(.claude/common/) 외에 이 프로젝트에서만 적용되는 규칙을 작성하세요. 공통 지침과 충돌할 경우 이 문서가 우선합니다.

디렉토리 규칙

• components/ — <설명>
• composables/ 또는 hooks/ — <설명>
• pages/ 또는 app/ — <설명>
• server/ 또는 api/ — <설명>
• types/ — <설명>

컴포넌트 규칙 (공통 규칙 오버라이드)

<공통 규칙과 달리 이 프로젝트에서만 적용할 제약을 적어주세요>

• 예) 컴포넌트 파일 길이 제한: 150줄 (공통 200줄보다 엄격)
• 예) Props 개수 최대 7개, 초과 시 객체 props 로 묶기

스타일

• 색상/간격/타이포는 디자인 토큰만 사용하고 임의값 금지
• 다크모드 prefix: dark:
• 기타 프로젝트 고유 규칙: <작성>

네트워크 / 데이터

• API 호출 창구: <예: composables/api 의 wrapper 만 사용>
• 인증 토큰 저장 위치: <예: httpOnly 쿠키>
• 에러 핸들링 규칙: <작성>

금지 사항

• <예: 직접 $fetch 사용 금지>
• <예: 전역 이벤트 버스 사용 금지>
• <예: any 타입 사용 금지>

테스트

• 테스트 러너: <Vitest / Jest 등>
• 테스트 파일 위치: <소스 옆 / tests 폴더>
• 최소 커버리지: <숫자>