---
title: "Cursor Project Rules (.cursor/rules/*.mdc): 경로 및 형식 · DotsAgent"
description: ".cursor/rules/*.mdc의 위치와 형식, frontmatter, 전역 및 중첩 파일의 병합 방식, 이 파일을 읽는 도구를 확인하세요. 2026-10-01에 확인했습니다."
url: https://dotsagent.io/ko/instructions/files/cursor-rules
---

.cursor/rules/*.mdc

# 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 키: `description``globs``alwaysApply`

`.cursor/rules/*.mdc`

```
---
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 파일은 상위 파일과 함께 적용되며, 더 구체적인 파일이 우선합니다.

## 이 파일을 읽는 도구

| 도구 | 지원 |
| --- | --- |
| [Cline](https://docs.cline.bot/features/cline-rules) | 이전 형식의 .cursorrules 파일을 감지합니다. |

## 팁

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

양식 하나로 다섯 가지 도구에 사용할 AGENTS.md와 규칙 파일을 생성하세요. [AGENTS.md 생성기 열기 →](https://dotsagent.io/ko/instructions)

## 기타 지침 파일

[AGENTS.md](https://dotsagent.io/ko/instructions/files/agents-md)

[CLAUDE.md](https://dotsagent.io/ko/instructions/files/claude-md)

[GEMINI.md](https://dotsagent.io/ko/instructions/files/gemini-md)

[.github/copilot-instructions.md](https://dotsagent.io/ko/instructions/files/github-copilot-instructions)

[.devin/rules/*.md](https://dotsagent.io/ko/instructions/files/windsurf-rules)

[.clinerules/](https://dotsagent.io/ko/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/ko/instructions/files/openclaw-workspace)

## 출처

1. [cursor.com](https://cursor.com/docs/context/rules)/docs/context/rules

AI 에이전트를 만드는 개발자를 위한 독립적인 참고 자료입니다. 여기에 언급된 어떤 업체와도 제휴 관계가 없습니다.

© 2026 DotsAgent · 정보 확인일: 2026년 10월 1일