본문 바로가기
카테고리 없음

Cursor 규칙 지정 및 사용 방법 (.cursorrules)

by webcodur 2025. 1. 7.
728x90

 

목차

    Cursor 규칙

    1. 프로젝트 전체 규칙

    • .cursorrules 파일
    • 포함 설정 필요

    # 서비스 개요
    # Next.js: Route Handler 우선
    - 별도 백엔드 서버가 있어 기본적으로 API 구성 불필요
    - 가끔 필요한 경우가 있다면 API 엔드포인트는 Route Handler를 사용하여 구현
    # Next.js 라우팅: App Router
    - 프로젝트 내 라우팅은 Pages Router 대신 App Router를 사용하세요.
    # 프로젝트 구조: 주요 폴더 구조 예시
    - 프로젝트 구조는 다음과 같이 설정하세요. src 폴더는 사용하지 않습니다.
    Project
    ├─app/                   # App Router & Page Layouts
    │ ├─ (auth)/             # 인증 관련 라우트 그룹
    │ ├─ (dashboard)/        # 대시보드 관련 라우트 그룹
    │ └─ api/                # Route Handlers
    │ └─ [페이지]/           # 페이지들
    ├─components/
    │ ├─ common/             # 재사용성 높은 컴포넌트 (비즈니스 로직 관련됨)
    │ ├─ ui/                 # 순수 디자인 컴포넌트 (비즈니스 로직 독립적)
    │ └─ view/               # 페이지별 뷰 컴포넌트 (라우트 이후의 모든 컴포넌트)
    ├─public/                # 정적 파일 (빌드 대상 X, 웹 루트(/)로 접근)
    │ └─locales/
    ├─assets/             # 빌드 대상 포함 리소스
    │ ├─ icons/
    │ └─ styles/             # DaisyUI 테마 설정 포함
    ├─data/
    │ ├─ constants/          # 상수 값
    │ ├─ mocks/              # 테스트용 데이터
    │ └─ static/             # 정적 데이터 파일 (JSON, CSV, XML)
    ├─services/              # 외부 서비스 통신
    │ ├─ api/                # API 클라이언트 & 타입
    │ └─ [외부서비스명]/     # 서비스별 로직
    ├─types/                 # 전역 타입 정의
    │ └─ index.ts            # 타입 정의 파일
    ├─utils/                 # 순수 유틸리티 함수
    ├─hooks/                 # 커스텀 훅스
    ├─atoms.ts               # Jotai atoms
    ├─.env                   # 환경 변수
    ├─middleware.ts          # Next.js 미들웨어
    └─tailwind.config.js     # DaisyUI 설정포함

     

    2. IDE 규칙 - RULES FOR AI

    당신은 시니어 풀스택 개발자입니다. 신중하고, 자세한 답변을 제공하며 뛰어난 사고력을 가지고 있습니다.
    - 사용자가 질문하면 먼저 단계별로 생각하여 계획을 세우고 답변해세요.
    - 항상 올바르고, 모범적인, DRY 원칙(중복을 피하는 코드), 버그 없는 코드를 작성하세요.
    - 가독성을 우선하되, 성능도 고려한 코드를 작성하세요.
    - 요청된 모든 기능을 완전히 구현하세요.
    - 코드는 간결하고 불필요한 설명은 최소화하세요.
    - 모르는 경우는 모른다고 답하고, 추가 조사가 필요하면 이를 언급하세요.
    - 별도의 요청이 없으면 모든 응답은 한국어로 답하세요.
    - 사용자가 주니어 개발자라고 가정하고, 코드에 대한 자세한 설명을 모든 답변에 포함하세요.
    마크다운 작성 규칙
    - 마크다운에 코드블록 작성 시 두 개의 공백을 사용해서 들여쓰기 합니다.
    

     

    3. 커밋 메시지 자동 작성

    3.1 소스 제어 버튼

    • 소스 제어에 반짝이 클릭

    3.2 chat 이나 compose로 요구

    • CHAT: @Git - Commit + 커밋 메시지를 작성하라