Rules
재사용 가능하고 범위가 지정된 지침으로 Agent 모델의 동작을 제어합니다.
Rules는 Agent와 Inline Edit에 시스템 수준의 지침을 제공합니다. 프로젝트를 위한 지속적인 컨텍스트, 선호도 또는 워크플로우로 생각하시면 됩니다.
Cursor는 세 가지 유형의 규칙을 지원합니다:
제공업체와 프레임워크에서 많은 예제를 사용할 수 있습니다. 커뮤니티에서 기여한 규칙은 온라인의 크라우드소싱 컬렉션과 저장소에서 찾을 수 있습니다.
프로젝트 루트의
Project Rules
.cursor/rules에 저장되며, 버전 관리되고 코드베이스에 범위가 지정됩니다.User Rules
Cursor 환경에 전역적으로 적용됩니다. 설정에서 정의되며 항상 적용됩니다.
.cursorrules (Legacy)
여전히 지원되지만 더 이상 사용되지 않습니다. 대신 Project Rules를 사용하세요.
규칙 작동 방식
대형 언어 모델은 완성 작업 간에 메모리를 유지하지 않습니다. 규칙은 프롬프트 수준에서 지속적이고 재사용 가능한 컨텍스트를 제공합니다. 적용될 때, 규칙 내용은 모델 컨텍스트의 시작 부분에 포함됩니다. 이를 통해 AI가 코드 생성, 편집 해석 또는 워크플로 지원에 대한 일관된 지침을 받을 수 있습니다.규칙은 Chat과 Inline
Edit에 적용됩니다. 활성 규칙은 Agent 사이드바에 표시됩니다.
프로젝트 규칙
프로젝트 규칙은.cursor/rules에 위치합니다. 각 규칙은 파일이며 버전 관리됩니다. 경로 패턴을 사용하여 범위를 지정하거나, 수동으로 호출하거나, 관련성에 따라 포함될 수 있습니다. 하위 디렉토리는 해당 폴더로 범위가 지정된 자체 .cursor/rules 디렉토리를 포함할 수 있습니다.
프로젝트 규칙을 사용하여:
- 코드베이스에 대한 도메인별 지식을 인코딩
- 프로젝트별 워크플로우나 템플릿을 자동화
- 스타일이나 아키텍처 결정을 표준화
규칙 구조
각 규칙 파일은 메타데이터와 콘텐츠를 지원하는 형식인 MDC (.mdc)로 작성됩니다. 타입 드롭다운에서 규칙이 적용되는 방식을 제어할 수 있으며, 이는 description, globs, alwaysApply 속성을 변경합니다.
| 규칙 타입 | 설명 |
|---|---|
Always | 항상 모델 컨텍스트에 포함 |
Auto Attached | glob 패턴과 일치하는 파일이 참조될 때 포함 |
Agent Requested | AI가 사용할 수 있으며, AI가 포함 여부를 결정. 설명을 제공해야 함 |
Manual | @ruleName을 사용하여 명시적으로 언급될 때만 포함 |
@service-template.ts와 같이 참조된 파일은 규칙이 트리거될 때 추가 컨텍스트로 포함됩니다.
중첩 규칙
프로젝트 전체에.cursor/rules 디렉토리를 배치하여 규칙을 구성합니다. 중첩된 규칙은 해당 디렉토리의 파일이 참조될 때 자동으로 연결됩니다.
규칙 생성
New Cursor Rule 명령을 사용하거나 Cursor Settings > Rules로 이동하여 규칙을 생성합니다. 이렇게 하면 .cursor/rules에 새 규칙 파일이 생성됩니다. 설정에서 모든 규칙과 상태를 확인할 수 있습니다.
규칙 생성
/Generate Cursor Rules 명령을 사용하여 대화에서 직접 규칙을 생성합니다. 에이전트 동작에 대한 결정을 내리고 이를 재사용하고자 할 때 유용합니다.
모범 사례
좋은 규칙은 집중적이고, 실행 가능하며, 범위가 명확합니다.- 규칙을 500줄 이하로 유지하세요
- 큰 규칙을 여러 개의 조합 가능한 규칙으로 분할하세요
- 구체적인 예시나 참조 파일을 제공하세요
- 모호한 지침을 피하세요. 명확한 내부 문서처럼 규칙을 작성하세요
- 채팅에서 프롬프트를 반복할 때 규칙을 재사용하세요
예제
프론트엔드 컴포넌트 및 API 검증 표준
프론트엔드 컴포넌트 및 API 검증 표준
이 규칙은 프론트엔드 컴포넌트에 대한 표준을 제공합니다:components 디렉토리에서 작업할 때:
- 스타일링에는 항상 Tailwind를 사용하세요
- 애니메이션에는 Framer Motion을 사용하세요
- 컴포넌트 명명 규칙을 따르세요
- 모든 검증에 zod를 사용하세요
- zod 스키마로 반환 타입을 정의하세요
- 스키마에서 생성된 타입을 내보내세요
Express 서비스 및 React 컴포넌트 템플릿
Express 서비스 및 React 컴포넌트 템플릿
이 규칙은 Express 서비스에 대한 템플릿을 제공합니다:Express 서비스를 생성할 때 이 템플릿을 사용하세요:
- RESTful 원칙을 따르세요
- 오류 처리 미들웨어를 포함하세요
- 적절한 로깅을 설정하세요
- 상단에 Props 인터페이스
- 명명된 내보내기로 컴포넌트
- 하단에 스타일
개발 워크플로우 자동화 및 문서 생성
개발 워크플로우 자동화 및 문서 생성
이 규칙은 앱 분석을 자동화합니다:앱 분석을 요청받았을 때:
npm run dev로 개발 서버를 실행하세요- 콘솔에서 로그를 가져오세요
- 성능 개선 사항을 제안하세요
- 코드 주석 추출
- README.md 분석
- 마크다운 문서 생성
Cursor에서 새로운 설정 추가하기
Cursor에서 새로운 설정 추가하기
먼저 앱에서 사용하려면 reactiveStorageService를 가져와서 속성을 사용하세요:
@reactiveStorageTypes.ts에서 토글할 속성을 생성하세요.@reactiveStorageService.tsx의 INIT_APPLICATION_USER_PERSISTENT_STORAGE에 기본값을 추가하세요.베타 기능의 경우 @settingsBetaTab.tsx에 토글을 추가하고, 그렇지 않으면 @settingsGeneralTab.tsx에 추가하세요. 일반적인 체크박스의 경우 토글을 <SettingsSubSection>으로 추가할 수 있습니다. 예제는 파일의 나머지 부분을 참조하세요.사용자 규칙
사용자 규칙은 Cursor 설정 → 규칙에서 정의되는 전역 설정으로, 모든 프로젝트에 적용됩니다. 이는 일반 텍스트 형태이며 선호하는 커뮤니케이션 스타일이나 코딩 규칙을 설정하는 데 완벽합니다:.cursorrules (레거시)
프로젝트 루트의 .cursorrules 파일은 여전히 지원되지만 향후 지원이 중단될 예정입니다. 더 나은 제어, 유연성 및 가시성을 위해 Project Rules로 마이그레이션하는 것을 권장합니다.
FAQ
내 규칙이 적용되지 않는 이유는 무엇인가요?
내 규칙이 적용되지 않는 이유는 무엇인가요?
규칙 유형을 확인하세요.
Agent Requested의 경우 설명이 정의되어 있는지 확인하세요. Auto Attached의 경우 파일 패턴이 참조된 파일과 일치하는지 확인하세요.규칙이 다른 규칙이나 파일을 참조할 수 있나요?
규칙이 다른 규칙이나 파일을 참조할 수 있나요?
네.
@filename.ts를 사용하여 규칙의 컨텍스트에 파일을 포함할 수 있습니다.채팅에서 규칙을 생성할 수 있나요?
채팅에서 규칙을 생성할 수 있나요?
네,
/Generate Cursor Rules 명령을 사용하여 채팅에서 프로젝트 규칙을 생성할 수 있습니다. Memories가 활성화되어 있으면 메모리가 자동으로 생성됩니다.규칙이 Cursor Tab이나 다른 AI 기능에 영향을 미치나요?
규칙이 Cursor Tab이나 다른 AI 기능에 영향을 미치나요?
아니요. 규칙은 Agent와 Inline Edit에만 적용됩니다.