Cursor Rules: AI 어시스턴트의 능력을 무한대로 확장하는 비결!

안녕하세요! 개발 생산성을 극대화하는 AI 기반 에디터, Cursor를 사용하고 계신가요? 오늘은 Cursor의 강력한 기능 중 하나인 “Rules“에 대해 자세히 알아보겠습니다. Rules는 AI 어시스턴트(Agent 및 Cmd-K AI)의 행동 방식을 재사용 가능하고 범위가 지정된 지침으로 제어할 수 있게 해주는 핵심 기능입니다.

왜 Rules가 필요할까요?

대규모 언어 모델(LLM)은 기본적으로 이전 작업의 “기억”을 유지하지 못합니다. 즉, 매번 새로운 요청을 할 때마다 동일한 컨텍스트나 선호 사항을 반복해서 제공해야 할 수 있습니다. Rules는 바로 이 문제를 해결합니다! Rules를 사용하면 지속적이고 재사용 가능한 컨텍스트를 프롬프트 수준에서 제공하여, AI가 코드 생성, 편집 내용 해석, 워크플로우 지원 등 어떤 작업을 하든 일관된 지침을 따르도록 만들 수 있습니다.

Rules는 Chat 및 Cmd K 기능에 적용됩니다. 단, Cursor Tab이나 다른 AI 기능에는 적용되지 않습니다.

Rules의 종류 알아보기

Cursor에서는 세 가지 종류의 Rules를 지원합니다:

Project Rules: 프로젝트 코드베이스 내에서 버전 제어가 가능하며, 특정 프로젝트에 범위가 지정됩니다. .cursor/rules 디렉토리에 저장됩니다.
User Rules: 전체 Cursor 환경에 걸쳐 적용되는 전역 규칙입니다. 설정에서 정의하며 항상 적용됩니다.
.cursorrules (Legacy): 프로젝트 루트에 위치하는 기존 .cursorrules 파일 형식입니다. 아직 지원되지만 더 이상 권장되지 않으며 곧 사용 중단될 예정입니다. Project Rules로 마이그레이션하는 것이 좋습니다.

Project Rules 자세히 살펴보기

Project Rules는 팀이나 프로젝트에 특화된 맞춤형 AI 어시스턴트를 만드는 데 매우 유용합니다.

저장 위치: 프로젝트의 .cursor/rules 디렉토리.
형식: **MDC(.mdc)**라는 경량 형식을 사용합니다. 이 형식은 메타데이터와 내용을 하나의 파일에 담을 수 있습니다.
활용 예시:
- 코드베이스에 대한 도메인별 지식을 인코딩합니다.
- 프로젝트별 워크플로우나 템플릿을 자동화합니다.
- 스타일 또는 아키텍처 결정을 표준화합니다.

Rule 구조 및 적용 방식

각 Rule 파일은 MDC 형식으로 작성되며, 다음과 같은 Rule Type 메타데이터를 가질 수 있습니다:

Always: 모델 컨텍스트에 항상 포함됩니다.
Auto Attached: 글로브(glob) 패턴과 일치하는 파일이 참조될 때 자동으로 포함됩니다.
Agent Requested: AI가 포함 여부를 결정합니다. 이 경우 설명이 제공되어야 합니다.
Manual: @ruleName 형식으로 명시적으로 언급될 때만 포함됩니다.

Rule 내용 안에서는 @service-template.ts와 같이 다른 파일을 참조하여 추가 컨텍스트로 포함시킬 수 있습니다.

중첩된 Rules로 체계적인 관리

.cursor/rules 디렉토리 내에 하위 디렉토리를 만들어 Rules를 중첩하여 구성할 수 있습니다. 예를 들어, backend/.cursor/rules와 같이 특정 컴포넌트나 디렉토리 하위에 Rules를 두는 것입니다.

중첩된 Rules의 장점은 다음과 같습니다:

해당 디렉토리의 파일이 참조될 때 자동으로 연결됩니다.
컨텍스트 선택기 및 에이전트 접근 가능한 Rules 목록에서 여전히 사용 가능합니다.
모노레포나 명확히 구분된 컴포넌트를 가진 프로젝트에서 도메인별 Rules를 관련 코드와 더 가깝게 구성하는 데 완벽합니다.

Rules 생성 및 관리

Rules는 여러 방법으로 생성할 수 있습니다:

Cmd + Shift + P를 누르고 “New Cursor Rule” 명령을 사용합니다.
Cursor 설정 > Rules 메뉴에서 생성합니다. 설정에서는 모든 Rules 목록과 상태도 확인할 수 있습니다.
Chat에서 /Generate Cursor Rules 명령을 사용합니다. 대화 중에 결정된 AI 행동 방식을 Rules로 저장하여 나중에 재사용할 때 매우 유용합니다.

Rules 작성 Best Practices

효과적인 Rules는 집중적이고, 실행 가능하며, 범위가 명확해야 합니다.

간결하게 유지합니다 (500라인 미만을 목표로).
큰 개념은 여러 개의 조합 가능한 Rule로 나눕니다.
필요하다면 구체적인 예시나 참조 파일을 제공합니다.
모호한 지침은 피하고 명확한 내부 문서처럼 작성합니다.
Chat에서 프롬프트를 반복하고 있다면 Rules로 만들어서 재사용합니다.

Project Rules 예시

소스에는 다양한 Project Rules 예시가 제공됩니다:

프론트엔드 컴포넌트 표준: 컴포넌트 디렉토리에서 작업 시 항상 Tailwind 사용, Framer Motion 사용, 명명 규칙 준수.
API 엔드포인트 유효성 검사 표준: API 디렉토리에서 zod 사용, zod 스키마로 반환 타입 정의, 스키마에서 생성된 타입 내보내기.
Express 서비스 템플릿: 새로운 Express 서비스 생성 시 RESTful 원칙 따르기, 오류 처리 미들웨어 포함, 적절한 로깅 설정. (@express-service-template.ts 파일 참조)
React 컴포넌트 구조: Props 인터페이스 상단, 컴포넌트 명명된 내보내기, 스타일 하단. (@component-template.tsx 파일 참조)
앱 분석 워크플로우 자동화: 앱 분석 요청 시 npm run dev 실행, 콘솔 로그 가져오기, 성능 개선 제안.
코드에서 문서 생성: 코드 주석 추출, README.md 분석, 마크다운 문서 생성하여 문서 초안 작성.

Cursor 내부에서 사용되는 Rules 예시도 소개되어 있습니다. 또한 Next.js, Cloudflare, Browserbase 등 여러 제공업체 및 커뮤니티에서 제공하는 다양한 예시를 찾아볼 수 있습니다.

User Rules 자세히 살펴보기

User Rules는 여러분 개인의 작업 스타일에 맞게 AI를 조정하는 데 사용됩니다.

저장 위치: Cursor 설정 > Rules.
적용 범위: 전체 Cursor 환경에 걸쳐 적용됩니다.
적용 방식: 모델 컨텍스트에 항상 포함됩니다.
형식: 일반 텍스트만 지원하며, MDC 형식은 지원하지 않습니다.
활용 예시:
- AI의 응답 언어 또는 톤을 설정합니다.
- 개인적인 스타일 선호 사항을 추가합니다.
예시: “간결한 스타일로 응답해 주세요. 불필요한 반복이나 군더더기 표현은 피해주세요.”

팀 간 Rule 공유

현재 Cursor에는 팀 간 Rule을 공유하는 내장된 기능은 없습니다. 하지만 향후에는 팀 프로젝트 간에 참조할 수 있는 공유 가능한 MDC 형식의 Rule을 지원할 계획이라고 합니다. 그때까지는 다음과 같은 방법을 사용할 수 있습니다:

공유 Rule을 별도의 저장소에 저장합니다.
각 프로젝트의 .cursor/rules 디렉토리로 복사하거나 심볼릭 링크를 만듭니다.

자주 묻는 질문 (FAQ)

Rule이 적용되지 않는 이유는 무엇인가요? Rule 유형을 확인해 보세요. Agent Requested의 경우 설명이 정의되어 있는지 확인하고, Auto Attached의 경우 파일 패턴이 참조된 파일과 일치하는지 확인하세요.
Rule이 다른 Rule이나 파일을 참조할 수 있나요? 네. @filename.ts 형식을 사용하여 Rule의 컨텍스트에 파일을 포함할 수 있습니다.
Chat에서 Rule을 만들 수 있나요? 네. AI에게 “이것을 Rule로 만들어 줘” 또는 “이 프롬프트에서 재사용 가능한 Rule을 만들어 줘”와 같이 요청할 수 있습니다.
Rules가 Cursor Tab이나 다른 AI 기능에 영향을 미치나요? 아니요. Rules는 Agent 및 Cmd-K AI 모델에게만 제공됩니다.

마무리하며

Cursor Rules는 AI 어시스턴트가 여러분의 프로젝트나 개인 스타일에 맞춰 더욱 효과적으로 작업할 수 있도록 돕는 강력한 도구입니다. Project Rules를 통해 팀의 코딩 표준, 워크플로우, 도메인 지식을 AI에게 학습시키고, User Rules로 개인적인 선호도를 반영하세요. 이를 통해 AI의 도움을 받아 훨씬 더 효율적이고 일관성 있는 개발 작업을 수행할 수 있을 것입니다! 지금 바로 여러분만의 Rules를 만들어 보세요!

이 화면은 Cursor AI에서 프로젝트에 적용할 **규칙(Project Rules)**을 설정하는 화면입니다. 이 규칙들은 AI가 코드베이스를 더 잘 이해하고 프로젝트의 컨벤션을 따르도록 돕는 역할을 합니다.

각 항목을 자세히 설명드리면 다음과 같습니다:

🔷 상단 안내

Project-specific rules: 프로젝트에 특화된 규칙들을 의미합니다.
AI가 코드를 이해하고, 컨벤션에 맞춰 작업하도록 도와줍니다.
에이전트에 의해 자동으로 포함되거나 불러와질 수 있습니다.
코드베이스와 동기화됩니다.

📋 등록된 규칙들

1. cursor_rules.mdc

제목: Guidelines for creating and maintaining Cursor rules to ensure consistency and effectiveness.
설명: 일관성과 효율성을 위해 Cursor 규칙을 생성 및 유지하는 가이드라인.
적용 범위: 모든 요청(All requests)

2. dev_workflow.mdc

제목: Guide for using Task Master to manage task-driven development workflows
설명: Task Master를 사용하여 작업 기반 개발 워크플로우를 관리하는 가이드.
적용 범위: 모든 요청

3. self_improve.mdc

제목: Guidelines for continuously improving Cursor rules based on emerging code patterns and best practices.
설명: 최신 코드 패턴과 모범 사례에 따라 Cursor 규칙을 지속적으로 개선하는 가이드.
적용 범위: 모든 요청

4. taskmaster.mdc

제목: Comprehensive reference for Taskmaster MCP tools and CLI commands.
설명: Taskmaster MCP 도구 및 CLI 명령어에 대한 포괄적 레퍼런스.
적용 범위: 모든 요청

✅ Include `.cursorrules` file

체크되어 있으면 .cursorrules 파일을 요청에 포함합니다.
이 파일은 AI가 해당 규칙을 참고하여 더 정밀하고 일관된 작업을 할 수 있도록 도와줍니다.

cursor_rules.mdc

이 내용은 Cursor AI에서 사용하는 규칙 파일(cursor_rules.mdc)의 작성 방식과 관리 지침에 대한 설명입니다. AI가 프로젝트 코드에 일관되고 효과적으로 대응할 수 있도록 **규칙(Rules)**을 정의하는 포맷과 가이드를 제공합니다.

✅ Required Rule Structure (필수 규칙 구조)

---
description: Clear, one-line description of what the rule enforces
globs: path/to/files/*.ext, other/path/**/*
alwaysApply: boolean
---

- **Main Points in Bold**
  - Sub-points with details
  - Examples and explanations

--- YAML 블록은 메타데이터로, 규칙의 요약 설명, 적용 경로(globs), 항상 적용 여부(alwaysApply)를 설정합니다.
- description: 규칙이 무엇을 강제하는지를 한 줄로 설명
- globs: 어떤 파일 경로에 이 규칙이 적용되는지 지정 (예: src/**/*.ts)
- alwaysApply: 이 규칙을 항상 적용할지 여부 (true 또는 false)
그 아래는 규칙의 본문으로, 핵심 포인트를 굵은 글씨로 쓰고, 세부 사항 및 예시를 포함합니다.

🗂 File References (파일 참조)

규칙이나 코드 파일을 참조할 땐 @filename 형식 사용
예시:
- @prisma.mdc: 다른 규칙 파일을 참조할 때
- @schema.prisma: 실제 코드 파일을 참조할 때

💡 Code Examples (코드 예시)

// ✅ DO: Show good examples
const goodExample = true;

// ❌ DON'T: Show anti-patterns
const badExample = false;

언어에 맞는 코드 블록을 사용
✅ 좋은 예제와 ❌ 피해야 할 안티패턴을 함께 제시
AI가 문맥을 이해하는 데 도움을 줌

📚 Rule Content Guidelines (규칙 내용 작성 지침)

전체 구조는 다음과 같이 구성되어야 합니다:
- 규칙의 큰 그림(high-level overview) 설명
- 구체적이고 실행 가능한 요구사항
- 정확한 구현 예시
- 실제 코드 참조를 포함
- 반복되는 내용은 다른 규칙을 참조하여 중복 제거(DRY 원칙)

🔄 Rule Maintenance (규칙 유지보수)

새로운 코드 패턴이 나타나면 규칙 업데이트
실제 코드에서 예제를 수집하여 반영
더 이상 사용하지 않는 패턴은 제거
관련 규칙끼리 교차 참조로 연결

🧭 Best Practices (베스트 프랙티스)

목록(Bullet points) 형태로 명확하게 작성
설명은 간결하게
DO & DON’T 예제를 모두 포함
이론보다는 실제 코드 중심으로 작성
일관된 포맷 사용

요약하자면, 이 cursor_rules.mdc 포맷은 프로젝트 내에서 코드 품질과 일관성을 유지하고, AI가 자동화된 방식으로 코드를 분석하거나 수정할 때 근거로 삼을 수 있는 명확하고 구조화된 규칙 시스템입니다.

JiniAI – 비즈니스를 위한 AI 솔루션

Generative AI project lifecycle

AI 시대, 컴퓨터 과학 학습 전략: 문제에 빠져들고 AI와 함께 파도 타기

AI 시대, 코딩은 쉬워져도 개발자가 사라지지 않는 이유

🧠AI 개발 워크플로우를 10배 향상시키는 비결: 메모리 뱅크 활용하기

Cursor AI 개발 생산성 극대화하기: awesome-cursorrules 완벽 활용 가이드 🚀

Cursor Rules: AI 어시스턴트의 능력을 무한대로 확장하는 비결!

Cursor 사용법: 개발 효율을 극대화하는 팁들