Term (용어)aiverifiedFri May 01
.cursorrules (Cursor Rules 영구 지시어 파일)
별칭: .cursorrules · cursorrules · Cursor Rules
#cursorrules#cursor#persistent-instructions#design-language
정의
entity/cursor 의 프로젝트별 영구 지시어 파일. 파일명 .cursorrules (점으로 시작). 후속 명칭 Rules (UI 상에서). term/claude-md / term/agents-md 와 기능적 등가.
Sanger 의 설계 근거
entity/sanger (Cursor 공동 창업자) 의 발언 (case/sanger-architect-quote):
"AI가 따를 수 있는 명확한 경계 정의와 패턴 거버넌스 가 선행되어야 한다."
→ "경계 정의(boundary)" 와 "패턴 거버넌스(pattern governance)" 가 .cursorrules 의 직접 근거.
작동 원리
- 프로젝트 루트의
.cursorrules가 Cursor 세션에 자동 로드. - 코드 자동완성·Chat·Plan Mode 등 모든 Cursor 기능 의 컨텍스트로 작동.
- 영구 지시어 — 매 요청마다 다시 입력할 필요 없음.
자매 도구의 등가물
| 도구 | 영구 지시어 파일 |
|---|---|
| entity/claude-code | term/claude-md (CLAUDE.md) |
| entity/cursor | .cursorrules |
| entity/github-copilot | term/agents-md (AGENTS.md) |
강의 활용
- 01 INT 보조: Cursor의 Rules 기능을 case/truell-start-with-plan-thread 와 함께 인용.
- 04 DSL 본격: 세 도구 영구 지시어 비교 슬라이드의 한 축.
주의사항
- 파일명:
.cursorrules(점·소문자).Cursorrules/.CursorRules는 불인식. - Rules 라는 명칭 변천: 초기
.cursorrules→ 이후 Rules (UI 명칭). 두 표현이 같은 것임을 강의에서 명시. - 점 파일(dotfile) 가시성:
.cursorrules는 macOS Finder/Windows 탐색기 기본 설정에서 숨김 파일. 청중이 파일이 안 보인다 는 혼란을 겪지 않도록 가시성 토글 안내.