Cursor Rules 작성법: 프로젝트 규칙 파일과 Agent 사용 방식

.cursor/rules에 .mdc를 두고 적용 방식을 고른 뒤 실행 가능한 본문을 쓴다. 맞는 규칙은 컨텍스트 앞에 들어간다.

Cursor Agent는 채팅을 넘어 구두 제약을 기억하지 않는다. “라우터를 다시 쓰지 마라”를 세 번 붙인다면 프로젝트 규칙에 넣어 다음 대화 시작부터 쓰이게 한다.

공식은 이 장치를 Cursor Rules라고 부른다. 프로젝트 규칙은 .cursor/rules에 두며 확장자는 .mdc여야 한다. 같은 폴더의 일반 .md는 무시된다. 편집기 사용법이며 브레인스토밍 제품 설명서가 아니다.

프로젝트 규칙이란

cursor.com/docs/context/rules를 대조한다. 네 출처 중 입문은 저장소 파일이면 충분하다. 적용되면 본문은 모델 컨텍스트 앞에 온다.

첫 규칙을 네 단계로 쓰기

1. 1

   파일을 만든다

   저장소에 .cursor/rules/your-name.mdc를 둔다. Agent에서 /create-rule을 치거나 Customize → Rules → Add Rule도 된다. 폴더는 된다. 확장자는 .mdc여야 한다.

2. 2

   적용 방식을 고른다

   alwaysApply: true는 매 채팅. globs는 맞는 파일이 컨텍스트에 있을 때. description만 있으면 Agent가 판단. 모두 비면 채팅에서 @규칙이름일 때만.

3. 3

   실행 가능한 본문을 쓴다

   내부 문서처럼 쓴다. 금지, 이름, 디렉터리 경계. @filename.ts로 예시를 가리키고 파일 전체를 붙이지 않는다. 공식은 500줄 미만.

4. 4

   커밋하고 확인한다

   git에 넣어 팀이 같은 제약을 공유한다. Customize에서 상태를 본다. 여전히 빠지면 대화에서 그 규칙을 @한다.

본문에 넣을 것

---
description: TypeScript conventions for this repo
globs: **/*.{ts,tsx}
alwaysApply: false
---

# TypeScript
- Prefer named exports
- Do not edit files under dist/
- New API clients follow @src/api/client.ts

Agent가 규칙을 쓰는 방식

일치 후 본문은 컨텍스트 앞에 올라가 코드 생성, 변경 설명, 워크플로에 쓰인다. 충돌 시 공식 순서는 Team Rules → Project Rules → User Rules이며 앞선 출처가 이긴다. Rules는 Cursor Tab에 영향을 주지 않는다. User Rules는 Inline Edit(Cmd/Ctrl+K)에 쓰이지 않는다.

AGENTS.md와 고르는 법

읽을 수 있는 메모만 필요하면 루트나 하위에 AGENTS.md를 둔다. 중첩 파일은 그 트리를 다룰 때 부모와 합쳐지고 더 구체적인 쪽이 이긴다. glob이나 수동 @이 필요하면 .mdc를 쓴다.

규칙을 둔 뒤 짧은 스케치가 필요하면 wbstorm 방 번호면 된다. 방 만들기와 참가와 화이트보드 기초도 보라.