Cursor 프롬프트 관리

Cursor

https://cursor.com/docs/context/rules

Project Rules란?

Project Rules는 .cursor/rules 디렉토리에 마크다운 파일로 저장되는 규칙들이고,
Git으로 버전 관리된다.
이 규칙들은 다음 기준으로 적용된다:

• 파일 경로 패턴(globs)
• 수동 호출(@rule-name)
• Cursor Agent가 문맥상 필요하다고 판단할 때

Project Rules의 목적

Project Rules는 다음을 위해 사용된다:

• 코드베이스에 특화된 도메인 지식 전달
• 프로젝트 전용 워크플로우 / 템플릿 자동화
• 스타일, 아키텍처 의사결정 표준화

Rule 파일 구조

• 각 Rule은 하나의 마크다운 파일
• .md, .mdc 확장자 지원
• .mdc는 frontmatter를 통해 더 세밀한 제어 가능

.cursor/rules/
  react-patterns.mdc
  api-guidelines.md
  frontend/
    components.md

Rule의 구성 요소 (Rule Anatomy)

Rule은 다음으로 구성됨:

• Frontmatter 메타데이터

  • description
  • globs
  • alwaysApply

• 실제 규칙 내용

Rule Type에 따라 적용 방식이 달라짐:

Rule Type	설명
Always Apply	모든 채팅에 항상 적용
Apply Intelligently	Agent가 문맥 기반으로 판단
Apply to Specific Files	특정 파일 패턴에만 적용
Apply Manually	@rule-name으로 수동 호출

예시:

---
globs:
alwaysApply: false
---
- 서비스 정의 시 내부 RPC 패턴 사용
- 서비스 이름은 snake_case
@service-template.ts

Rule 생성 방법

• New Cursor Rule 명령 사용
• 또는 Cursor Settings > Rules, Commands
• 생성 시 .cursor/rules에 파일 생성됨

Best Practices (권장사항)

좋은 Rule의 조건

• 명확하고, 실행 가능하며, 범위가 좁아야 함

권장

• 500줄 이하 유지
• 큰 Rule은 여러 개로 분리
• 실제 파일 예시를 참조
• 내부 문서처럼 명확하게 작성

피해야 할 것

• 전체 스타일 가이드 복붙 → 린터 쓰기
• npm, git 같은 기본 명령 설명
• 거의 안 쓰는 엣지 케이스
• 코드 전체 복사 → 파일 참조 사용

👉 핵심:
Agent가 같은 실수를 반복할 때만 Rule을 추가하라

Team Rules (팀 규칙)

• Team / Enterprise 플랜에서 사용 가능
• Cursor 대시보드에서 중앙 관리
• 모든 팀원에게 자동 적용
• 개인 설정으로 끌 수 없게 강제(enforce) 가능

적용 우선순위

Team Rules → Project Rules → User Rules

Team Rule 특징

• plain text (frontmatter 없음)
• 모든 프로젝트 / 레포지토리에 적용
• 조직 차원의 표준 강제에 적합
• 단, 보안 통제 수단으로 AI만 쓰는 건 위험

Rule Import (외부 규칙 가져오기)

GitHub 원격 Rule

• Public / Private repo 모두 가능
• Cursor Settings → Rules → Remote Rule
• 자동 동기화됨 (원본 변경 시 반영)

Agent Skills

• AI Agent에 특화 능력을 추가하는 오픈 스탠다드
• Agent 판단 기반으로 자동 적용
• alwaysApply / manual 설정 불가

AGENTS.md

• 프로젝트 루트에 두는 단순한 규칙 파일
• 메타데이터 없음
• 작은 프로젝트나 단순 지침에 적합
• .cursor/rules의 경량 대안

User Rules

• 사용자 개인 전역 설정
• 모든 프로젝트에 적용
• 커뮤니케이션 스타일, 선호 언어 등 설정

Legacy (.cursorrules)

• 아직 지원되지만 곧 deprecated
• Project Rules 또는 AGENTS.md로 이전 권장