.cursorrules (Cursor Rules 영구 지시어 파일)
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 의 직접 근거.

작동 원리

  1. 프로젝트 루트의 .cursorrules 가 Cursor 세션에 자동 로드.
  2. 코드 자동완성·Chat·Plan Mode 등 모든 Cursor 기능 의 컨텍스트로 작동.
  3. 영구 지시어 — 매 요청마다 다시 입력할 필요 없음.

자매 도구의 등가물

도구영구 지시어 파일
entity/claude-codeterm/claude-md (CLAUDE.md)
entity/cursor.cursorrules
entity/github-copilotterm/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 탐색기 기본 설정에서 숨김 파일. 청중이 파일이 안 보인다 는 혼란을 겪지 않도록 가시성 토글 안내.