Project Rules
.cursor/rules
에 저장돼. 버전 관리되며 코드베이스 스코프에만 적용돼.User Rules
Cursor 환경 전체에 전역 적용돼. 설정에서 정의되며 항상 적용돼.
AGENTS.md
마크다운 형식의 Agent 지침.
.cursor/rules
의 간단한 대안이야..cursorrules (Legacy)
여전히 지원되지만 더는 권장하지 않아. 대신 Project Rules를 사용해.
규칙의 동작 방식

규칙은 Chat과 Inline
Edit에 적용돼. 활성화된 규칙은 Agent 사이드바에 표시돼.
Project rules
.cursor/rules
에 있어. 각 규칙은 파일 단위로 관리되고, 버전 관리돼. 경로 패턴으로 범위를 지정하거나, 수동으로 실행하거나, 관련성에 따라 포함할 수도 있어. 하위 디렉터리는 해당 폴더 범위로 적용되는 자체 .cursor/rules
디렉터리를 둘 수 있어.
프로젝트 규칙은 이런 데 써봐:
- 코드베이스에 대한 도메인 지식을 정의
- 프로젝트 특화 워크플로우나 템플릿 자동화
- 스타일이나 아키텍처 결정 표준화
규칙 구조
.mdc
) 형식으로 작성돼. 타입 드롭다운에서 description
, globs
, alwaysApply
속성을 바꿔 규칙이 적용되는 방식을 제어할 수 있어.
Rule Type | Description |
---|---|
Always | 항상 모델 컨텍스트에 포함돼 |
Auto Attached | glob 패턴과 일치하는 파일이 참조될 때 포함돼 |
Agent Requested | AI가 포함 여부를 결정할 수 있도록 제공돼. description 은 반드시 제공해야 해 |
Manual | @ruleName 을 사용해 명시적으로 언급된 경우에만 포함돼 |
중첩 규칙
.cursor/rules
디렉터리를 두고 규칙을 정리해. 해당 디렉터리 안의 파일이 참조되면, 중첩 규칙이 자동으로 적용돼.
규칙 만들기
New Cursor Rule
명령을 사용하거나 Cursor Settings > Rules
로 가서 규칙을 만들어. 그러면 .cursor/rules
에 새 규칙 파일이 생성돼. 설정에서 모든 규칙과 상태를 한눈에 볼 수 있어.

규칙 생성
/Generate Cursor Rules
명령으로 규칙을 바로 만들어. 에이전트 동작을 어떻게 할지 정했고, 그걸 계속 쓰고 싶을 때 유용해.
모범 사례
- 규칙은 500줄 이하로 유지하기
- 큰 규칙은 여러 개의 조합 가능한 규칙으로 나누기
- 구체적인 예시나 참조 파일 제공하기
- 애매한 가이드는 피하고, 내부 문서처럼 명확하게 쓰기
- 채팅에서 프롬프트를 반복할 땐 규칙을 재사용하기
예시
프론트엔드 컴포넌트와 API 검증 표준
프론트엔드 컴포넌트와 API 검증 표준
이 규칙은 프론트엔드 컴포넌트의 기준을 정해:components 디렉터리에서 작업할 때:
- 스타일링은 항상 Tailwind 사용
- 애니메이션은 Framer Motion 사용
- 컴포넌트 네이밍 컨벤션 준수
- 모든 검증에 zod 사용
- zod 스키마로 반환 타입 정의
- 스키마에서 생성된 타입 export
Express 서비스와 React 컴포넌트 템플릿
Express 서비스와 React 컴포넌트 템플릿
이 규칙은 Express 서비스 템플릿을 제공해:Express 서비스를 만들 때 이 템플릿을 써:
- RESTful 원칙 준수
- 에러 핸들링 미들웨어 포함
- 적절한 로깅 설정
- 맨 위에 Props 인터페이스
- 컴포넌트는 named export
- 스타일은 하단에 배치
개발 워크플로 자동화와 문서 생성
개발 워크플로 자동화와 문서 생성
이 규칙은 앱 분석을 자동화해:앱 분석을 요청받으면:
npm run dev
로 dev 서버 실행- 콘솔 로그 수집
- 성능 개선안 제안
- 코드 주석 추출
- README.md 분석
- 마크다운 문서 생성
Cursor에 새 설정 추가하기
Cursor에 새 설정 추가하기
먼저 앱에서 사용하려면 reactiveStorageService를 import해서 해당 프로퍼티를 써:
@reactiveStorageTypes.ts
에 토글할 프로퍼티를 만들어.@reactiveStorageService.tsx
의 INIT_APPLICATION_USER_PERSISTENT_STORAGE
에 기본값을 추가해.베타 기능이면 @settingsBetaTab.tsx
에 토글을 추가하고, 아니면 @settingsGeneralTab.tsx
에 추가해. 일반 체크박스는 <SettingsSubSection>
으로 추가할 수 있어. 예시는 파일의 나머지 부분을 참고해.AGENTS.md
AGENTS.md
는 에이전트 지침을 정의하는 간단한 마크다운 파일이야. 간단한 사용 사례라면 프로젝트 루트에 두고 .cursor/rules
의 대안으로 쓰면 돼.
Project Rules와 달리 AGENTS.md
는 메타데이터나 복잡한 설정이 없는 순수 마크다운 파일이야. 구조화된 규칙의 오버헤드 없이 간단하고 읽기 쉬운 지침이 필요한 프로젝트에 딱이야.
User Rules
.cursorrules
(레거시)
.cursorrules
파일은 아직 지원되지만 곧 사용 중단될 예정이야. 더 나은 제어, 유연성, 가시성을 위해 Project Rules로 옮기는 걸 추천해.
FAQ
왜 내 규칙이 적용되지 않을까?
왜 내 규칙이 적용되지 않을까?
규칙 유형을 확인해.
Agent Requested
라면 description이 정의되어 있는지 확인하고, Auto Attached
라면 file pattern이 참조된 파일과 일치하는지 확인해.규칙에서 다른 규칙이나 파일을 참조할 수 있어?
규칙에서 다른 규칙이나 파일을 참조할 수 있어?
가능해. 규칙의 context에 파일을 포함하려면
@filename.ts
를 사용해.채팅에서 규칙을 만들 수 있어?
채팅에서 규칙을 만들 수 있어?
가능해.
/Generate Cursor Rules
명령어로 채팅에서 프로젝트 규칙을 생성할 수 있어. Memories가 활성화되어 있으면, memories는 자동으로 생성돼.규칙이 Cursor Tab이나 다른 AI 기능에 영향이 있어?
규칙이 Cursor Tab이나 다른 AI 기능에 영향이 있어?
아니. 규칙은 Agent와 Inline Edit에만 적용돼.