Rulebook

Claude Rules 관리

문서맵
  • auth-security
  • component-design
  • entities-api
  • entities-layer
  • entities-model
  • error-handling
    v3
  • features-layer
  • fsd-architecture
  • performance
  • proxy
  • react-hooks
    v31
  • security
  • server-components
    v2
  • shared-layer
  • state-management
    삭제됨
  • tailwind-css
    v3
  • tanstack-query
  • testing
  • views-layer
    v3
  • widget-layer
  • changelog
  • development-workflow
  • documentation
    v2
  • error-handling
  • git-commit
  • marketing-seo
  • marketing-ux
  • naming-convention
  • security
  • testing
  • typescript-standards
  • ux-copy-and-tone
  • api-design
    v3
  • database
    v2
  • django
    v2
  • fastapi
    v2
  • nest
    v3
  • security
  • supabase
    v2
  • README
    v2
  • task-management
    v2
전체 룰 다운로드
common/development-workflow

Development Workflow

activev12026. 5. 4. 업데이트

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 참고

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

피드백 0

아직 피드백이 없어요. 첫 번째로 의견을 남겨보세요!

←changelogdocumentation→

목차

커밋 규칙패키지 매니저코드 분할테스트PRD 참고