재사용 가능하고 스코프가 있는 지침으로 Agent 모델의 동작을 제어해.
.cursor/rules
에 저장되고, 버전 관리되며, 코드베이스 스코프로 적용돼..cursor/rules
의 간단한 대안이야..cursor/rules
에 있어. 각 규칙은 파일이며 버전 관리돼. 경로 패턴으로 범위를 지정하거나, 수동으로 호출하거나, 관련성에 따라 자동 포함할 수 있어. 하위 디렉터리는 해당 폴더 범위에만 적용되는 자체 .cursor/rules
디렉터리를 둘 수 있어.
프로젝트 규칙을 사용해서:
.mdc
)로 작성돼. 타입 드롭다운에서 description
, globs
, alwaysApply
속성을 바꿔 규칙 적용 방식을 제어해.
Rule Type | Description |
---|---|
Always | 항상 모델 컨텍스트에 포함됨 |
Auto Attached | glob 패턴과 일치하는 파일이 참조될 때 포함됨 |
Agent Requested | AI가 포함 여부를 결정할 수 있도록 제공됨. 설명을 반드시 제공해야 함 |
Manual | @ruleName 으로 명시적으로 언급될 때만 포함됨 |
.cursor/rules
디렉터리를 배치해 규칙을 구성해. 해당 디렉터리의 파일이 참조되면 중첩 규칙이 자동으로 연결돼.
New Cursor Rule
명령을 사용하거나 Cursor Settings > Rules
로 이동해서 규칙을 만들어. 그러면 .cursor/rules
에 새 규칙 파일이 생성돼. 설정에서 모든 규칙과 상태를 확인할 수 있어.
/Generate Cursor Rules
명령으로 규칙을 바로 생성해. 에이전트 동작을 정했고 그 결정을 재사용하고 싶을 때 유용해.
프런트엔드 컴포넌트와 API 검증 기준
Express 서비스와 React 컴포넌트 템플릿
개발 워크플로 자동화와 문서 생성
npm run dev
로 dev 서버 실행Cursor에 새 설정 추가하기
@reactiveStorageTypes.ts
에 토글할 프로퍼티를 추가해.@reactiveStorageService.tsx
의 INIT_APPLICATION_USER_PERSISTENT_STORAGE
에 기본값을 넣어.베타 기능이면 @settingsBetaTab.tsx
에 토글을 추가하고, 아니면 @settingsGeneralTab.tsx
에 추가해. 토글은 일반 체크박스용으로 <SettingsSubSection>
에 넣으면 돼. 예시는 파일의 나머지 부분을 참고해.AGENTS.md
는 에이전트 지침을 정의하는 단순한 마크다운 파일이야. 간단한 사용 사례라면 .cursor/rules
대신 프로젝트 루트에 두고 쓰면 돼.
Project Rules와 달리 AGENTS.md
는 메타데이터나 복잡한 설정이 없는 순수 마크다운 파일이야. 구조화된 규칙의 오버헤드 없이 간단하고 읽기 쉬운 지침이 필요한 프로젝트에 딱 좋아.
AGENTS.md
는 프로젝트 루트에만 둬야 해 (v1.5).cursor/rules
와 달리 지침을 여러 파일로 나눌 수 없어AGENTS.md
지원은 v1.6에 추가될 예정이야..cursorrules
(레거시).cursorrules
파일은 계속 지원되지만, 곧 사용 중단될 예정이야. 더 높은 제어권, 유연성, 가시성을 위해 Project Rules로 옮기는 걸 추천해.
왜 내 규칙이 적용되지 않아?
Agent Requested
라면 설명이 정의되어 있는지 확인하고, Auto Attached
라면 파일 패턴이 참조된 파일과 일치하는지 확인해.규칙이 다른 규칙이나 파일을 참조할 수 있어?
@filename.ts
를 사용해.채팅에서 규칙을 만들 수 있어?
/Generate Cursor Rules
명령어로 채팅에서 프로젝트 규칙을 생성할 수 있어.
Memories가 활성화되어 있으면, 메모리는 자동으로 생성돼.규칙이 Cursor Tab이나 다른 AI 기능에 영향을 줘?