---

description: "개발 워크플로우: 커밋 규칙, 패키지 매니저, 코드 분할"

Development Workflow

커밋 규칙

사용자가 명시적으로 요청할 때만 커밋한다. 자동 커밋, 제안 후 커밋 금지.

패키지 매니저

개발 전 package.json의 packageManager 필드 또는 lock 파일을 확인하고, 해당 패키지 매니저 명령어만 사용한다. 혼용 금지.

코드 분할

파일이 200줄을 넘으면 분할을 검토한다. 300줄 이상은 반드시 분할.

분할 기준:

• 컴포넌트: UI 로직과 비즈니스 로직 분리
• 훅: 단일 책임 (하나의 훅 = 하나의 관심사)
• 타입: 도메인별 .types.ts 파일로 분리

// ✅ 분할된 구조
feature/
├── ui/feature-form.tsx       (UI)
├── hooks/use-feature.ts      (로직)
├── model/feature.types.ts    (타입)
└── index.ts

테스트

순수 함수, 유틸리티, 커스텀 훅은 테스트 작성을 권장한다. 스타일 변경, 프로토타입, 사용자가 명시적으로 제외 요청 시 생략 가능.

PRD 참고

요구사항이 불명확하면 구현 전에 사용자와 스펙을 먼저 정리한다.