Cursor AI Rules 설정 방법 개발 생산성을 높이는 핵심 기능

Cursor AI Rules 설정 방법을 알면 매번 같은 코딩 스타일, 폴더 구조, 테스트 규칙, 응답 방식, 금지사항을 반복해서 설명하지 않아도 됩니다. Cursor 공식 문서 기준으로 Rules는 Agent와 Cmd/Ctrl+K Inline Edit에 적용되는 지속적인 지침이며, Project Rules, User Rules, Memories로 나뉩니다.

과거의 .cursorrules 파일도 여전히 지원되지만 공식 문서는 더 세밀한 제어를 위해 .cursor/rules에 저장하는 Project Rules 사용을 권장합니다.

빠른 확인 버튼

먼저 결론부터

찾는 정보	핵심 답변
Rules 저장 위치	프로젝트 규칙은 `.cursor/rules` 사용
팀 공유 가능 여부	Project Rules는 Git으로 공유 가능
개인 설정	User Rules에 개인 선호 규칙 작성
적용 방식	Always, Auto Attached, Agent Requested, Manual 기준 확인
작성 원칙	짧고 구체적으로, 프로젝트 맥락 중심으로 작성

Cursor Rules 종류

종류	위치	특징
Project Rules	`.cursor/rules`	프로젝트별 규칙, Git으로 공유 가능
User Rules	Cursor Settings > Rules	모든 프로젝트에 적용되는 개인 규칙
Memories	Chat 기반 자동 생성	Privacy Mode에서는 제한 가능
.cursorrules	프로젝트 루트	legacy 방식, 점차 Project Rules 권장

프로젝트별 Rules 추천 설정

Cursor AI Rules 설정 방법은 사용하는 기술 스택에 따라 달라져야 합니다. 모든 프로젝트에 같은 규칙을 넣으면 답변이 부정확해질 수 있습니다.

프로젝트 유형	추천 Rules 내용
SvelteKit 블로그	라우팅 구조, mdsvex 포맷, frontmatter 규칙
React 앱	컴포넌트 분리 기준, 상태관리 방식, 테스트 도구
Node API	에러 처리, DTO 구조, 인증 미들웨어 규칙
Python 자동화	가상환경, 타입 힌트, 로깅 방식
팀 프로젝트	네이밍, PR 기준, 금지 패턴, 보안 규칙

좋은 Rule은 “항상 이렇게 해”보다 “이 프로젝트에서는 이 파일 구조와 도구를 우선 사용해”처럼 맥락을 알려주는 문장입니다.

Cursor Rule 만드는 순서

Cursor에서 프로젝트를 엽니다.
Cmd/Ctrl + Shift + P를 누릅니다.
New Cursor Rule을 검색해 실행합니다.
.cursor/rules 폴더에 새 규칙 파일을 만듭니다.
설명, 적용 범위, 지침을 작성합니다.
필요한 경우 파일 패턴(glob)을 지정합니다.
Agent 또는 Inline Edit에서 규칙이 적용되는지 확인합니다.
팀과 공유할 규칙은 Git에 커밋합니다.

Rule 타입별 사용 기준

Rule 타입	추천 상황
Always	항상 지켜야 하는 프로젝트 핵심 원칙
Auto Attached	특정 파일 패턴에서만 적용
Agent Requested	AI가 필요하다고 판단할 때 선택
Manual	`@ruleName`으로 직접 언급할 때만 적용

너무 많은 Always 규칙은 모델 컨텍스트를 잡아먹을 수 있습니다. 핵심 규칙만 Always로 두고 나머지는 범위별로 나누는 것이 좋습니다.

프론트엔드 규칙 예시

---
description: Frontend component rules
globs: src/**/*.tsx
alwaysApply: false
---

- React 컴포넌트는 함수형 컴포넌트로 작성한다.
- 스타일은 기존 디자인 시스템 토큰을 우선 사용한다.
- 버튼에는 접근성 label을 제공한다.
- 새 컴포넌트에는 기본 상태, 로딩 상태, 에러 상태를 고려한다.
- 변경 후 관련 테스트를 제안한다.

좋은 Rules 작성법

원칙	설명
짧게 작성	집중된 규칙이 더 잘 작동
구체적으로 작성	“좋게 작성”보다 “에러 상태 포함”처럼 명확히
범위 나누기	frontend, backend, test 규칙 분리
예시 포함	좋은 코드 패턴이나 파일 참조 추가
반복 프롬프트 저장	자주 말하는 지침을 Rules로 전환

Rules 관리 체크리스트

체크 항목	완료 여부
`.cursor/rules` 폴더 생성	□
프레임워크와 패키지 매니저 명시	□
금지할 패턴 작성	□
테스트 실행 방식 작성	□
보안상 다루면 안 되는 파일 명시	□
팀원이 읽어도 이해되는 문장인지 확인	□
오래된 `.cursorrules`와 중복 여부 확인	□