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와 중복 여부 확인 |
□ |
규칙이 많아질수록 Cursor가 모든 지침을 균형 있게 따르기 어렵습니다. 한 달에 한 번 정도 실제 답변 품질을 보고 필요 없는 규칙을 줄이는 것이 좋습니다.
함께 보면 좋은 AI 코딩 글
자주 묻는 질문 FAQ
Q. Cursor Rules는 Tab 자동완성에도 적용되나요?
공식 문서 기준으로 Rules는 Agent와 Cmd/Ctrl+K Inline Edit에 적용되며, Cursor Tab 같은 다른 AI 기능에는 적용되지 않습니다.
Q. .cursorrules는 아직 사용할 수 있나요?
지원은 되지만 legacy 방식이며, 공식 문서는 Project Rules 사용을 권장합니다.
Q. 팀원과 규칙을 공유할 수 있나요?
Project Rules는 .cursor/rules에 저장되어 Git으로 버전 관리할 수 있습니다.
결론
Cursor AI Rules 설정 방법의 핵심은 반복 지시를 프로젝트 규칙으로 저장하는 것입니다. 프로젝트 스타일, 테스트 기준, 아키텍처 원칙을 Rules로 만들면 Agent와 Inline Edit 결과가 더 일관됩니다.