Cursor Project Rules (.cursor/rules/*.mdc): 파일 위치와 도구별 읽기 방식

Cursor Project Rules는 .cursor/rules/에 있는 .mdc 파일이며, frontmatter에서 각 규칙을 적용할 시점을 지정합니다. Cursor는 AGENTS.md도 읽으며, 저장소 외부에서 설정하는 User Rules와 Team Rules도 지원합니다.

파일 위치

• .cursor/rules/**/*.mdc. 하위 폴더를 사용할 수 있으며 .cursor/rules의 일반 .md 파일은 무시됩니다.
• 루트와 하위 폴더의 AGENTS.md.
• Cursor 설정에서 지정하는 User Rules.
• 팀 대시보드에서 지정하는 Team Rules.

형식

YAML frontmatter가 있는 Markdown 형식이며, 파일 확장자는 반드시 .mdc여야 합니다. alwaysApply: true이면 규칙이 항상 포함됩니다. alwaysApply: false와 함께 globs를 지정하면 일치하는 파일이 컨텍스트에 있을 때 규칙이 적용됩니다. description만 지정하면 Agent가 적용 여부를 판단합니다. 이 항목을 하나도 지정하지 않으면 @-mention한 경우에만 규칙이 적용됩니다.

Frontmatter 키: descriptionglobsalwaysApply

---
description: React component conventions
globs: src/components/**/*.tsx
alwaysApply: false
---

- One component per file, with a named export matching the file name.
- Type props with an interface named after the component plus Props.
- Use the existing CSS modules; no inline style objects.
- Follow @src/components/Button.tsx as the reference pattern.

우선순위 및 병합

Team Rules, Project Rules, User Rules 순으로 적용됩니다. 적용 가능한 모든 규칙을 병합하며, 충돌하면 앞선 출처의 규칙이 우선합니다. 강제된 Team Rules는 끌 수 없습니다. 하위 AGENTS.md 파일은 상위 파일과 함께 적용되며, 더 구체적인 파일이 우선합니다.

이 파일을 읽는 도구

팁

• globs 필드에서 쉼표로 구분해 여러 glob 패턴을 지정하세요.
• 각 규칙은 500줄 미만으로 유지하고, 파일 내용을 붙여 넣는 대신 @filename으로 참조하세요.
• 규칙은 Cursor Tab에 적용되지 않으며, User Rules는 Inline Edit에 적용되지 않습니다.
• 레거시 .cursorrules 파일은 더 이상 Cursor 문서에서 언급되지 않습니다. .cursor/rules/로 옮기세요.

기타 지침 파일