Cursor 규칙 설정: 프로젝트, 사용자, Team Rules, .mdc frontmatter, glob, AGENTS.md

• Project Rules: .cursor/rules의 .mdc 파일입니다. 버전 관리되며 코드베이스 범위로 적용됩니다. 하위 폴더를 지원합니다.
• User Rules: Cursor 규칙 설정에서 지정하는 전역 환경설정입니다. 모든 프로젝트에 적용됩니다.
• Team Rules: Team 및 Enterprise 플랜에서 Cursor 대시보드로 관리합니다.
• AGENTS.md: 메타데이터 없는 일반 마크다운 지침입니다.

프로젝트 규칙은 .mdc 확장자를 사용해야 합니다. .cursor/rules의 일반 .md 파일은 규칙 시스템에서 무시됩니다.

• Always Apply: alwaysApply: true. 모든 채팅 세션에 포함됩니다.
• Apply to Specific Files: alwaysApply: false와 globs. 일치하는 파일이 컨텍스트에 있을 때 첨부됩니다.
• Apply Intelligently: alwaysApply: false와 description, globs 없음. 관련이 있을 때 Agent가 가져옵니다.
• Apply Manually: description과 globs 없음. @로 멘션할 때만 사용됩니다.

여러 glob 패턴은 쉼표로 구분합니다. 예를 들어 src/**/*.tsx는 src/ 아래의 .tsx 파일과 일치합니다.

---
globs: src/components/**/*.tsx
alwaysApply: false
---

- Use named exports, not default exports
- Keep components under 200 lines
- Prefer composition over prop drilling

---
alwaysApply: true
---

- Read the relevant source files before proposing changes
- Never modify generated files in dist/ or build/

규칙 안의 @file 참조는 Agent에게 어디를 볼지 알려 줍니다. 파일 내용이 인라인되지는 않으므로 항상 컨텍스트에 있어야 하는 내용은 규칙 본문에 넣습니다.

• Team 및 Enterprise 플랜에서 사용할 수 있습니다. 관리자가 Cursor 대시보드에서 생성하고 관리합니다.
• Team Rules는 자유 형식 텍스트이며 .cursor/rules 폴더 구조를 사용하지 않습니다.
• 각 규칙은 강제 또는 선택으로 지정할 수 있습니다. 사용자는 Customize의 Team Rules에서 강제되지 않은 Team Rule을 끌 수 있습니다. 강제된 규칙은 그곳에서 비활성화할 수 없습니다.
• glob 패턴이 있는 규칙은 일치하는 파일이 컨텍스트에 있을 때만 적용됩니다. glob이 없는 규칙은 모든 대화에 적용됩니다.
• 활성화 상자를 선택하지 않고 두면 규칙이 초안으로 저장되며, 활성화하기 전까지 적용되지 않습니다.
• 활성화된 Team Rules는 팀의 모든 저장소와 프로젝트에서 Agent(Chat) 컨텍스트에 포함됩니다.

Cursor는 강제된 규칙이라도 AI 지침을 유일한 보안 통제로 삼아서는 안 된다고 안내합니다.

AGENTS.md를 프로젝트 루트에 둡니다. 하위 디렉터리의 중첩 AGENTS.md 파일은 해당 디렉터리에서 작업할 때 적용됩니다. 상위 파일과 결합되며, 더 구체적인 파일이 우선합니다.

• 우선순위는 Team Rules, Project Rules, User Rules 순입니다. 모든 규칙이 병합되며, 충돌 시 앞선 출처가 우선합니다.
• User Rules는 Agent에만 적용되며 Inline Edit에는 적용되지 않습니다.
• 규칙은 Cursor Tab에 영향을 주지 않습니다.
• 각 규칙은 500줄 미만으로 유지하고, 큰 규칙은 작은 규칙으로 나눕니다.