Maru@maru

Dev Hub

Cursor MDC 규칙 도입하기 — .cursorrules 버리고 토큰 80% 아끼는 법

Cursor를 사용할 때 프로젝트 루트의 .cursorrules 파일이 비대해지면 매 작업마다 모든 규칙이 AI 모델에 입력되는 문제가 발생합니다. 이는 불필요한 토큰 소비를 유발할 뿐만 아니라, 관련 없는 파일 규칙이 컨텍스트에 섞여 모델의 추론 정확도를 떨어뜨리는 원인이 됩니다. 이 문제를 해결하기 위해 특정 상황과 디렉터리에 맞춰 규칙을 조절하고 선택적으로 주입하는 모듈형 규칙 표준인 MDC 규격이 도입되었습니다.

MDC란 무엇인가: .cursorrules와의 구조적 차이

마크다운 문서와 설정을 결합한 MDC 규격은 기존 프로젝트 루트의 단일 .cursorrules 파일이 야기하던 무거운 토큰 소모 문제를 해결하기 위해 도입되었습니다 [research-search:2026-09-15T04:19:55.821Z:0]. 기존 .cursorrules 파일은 AI와 대화하거나 에이전트를 실행할 때마다 매번 파일 전체를 컨텍스트에 강제로 주입해야 했습니다 [research-search:2026-09-15T04:19:55.821Z:0]. 이 때문에 작업과 상관없는 백엔드 규칙이나 구문 제약사항까지 전부 모델로 들어가 불필요한 토큰 비용이 발생하고 AI의 추론 성능이 떨어지는 부작용이 있었습니다 [research-search:2026-09-15T04:19:55.821Z:2].

MDC 표준은 이 가이드라인들을 역할과 목적에 맞게 여러 파일로 분할하여 .cursor/rules/*.mdc 경로에서 독립적으로 관리합니다 [research-search:2026-09-15T04:19:55.821Z:0]. 이 방식을 사용하면 작업 중인 파일 경로와 맥락에 꼭 맞는 규칙만 실시간으로 조율하여 주입할 수 있습니다 [research-search:2026-09-15T04:19:55.821Z:3]. 결과적으로 쓸데없는 컨텍스트 오염을 막고, AI가 당장 해결해야 할 코드 작업에만 명확히 집중하도록 유도할 수 있습니다 [research-search:2026-09-15T04:19:55.821Z:2, research-search:2026-09-15T04:19:55.821Z:3].

네 가지 활성화 모드와 2단계 제어 프로세스

MDC 규칙의 핵심은 YAML 프론트매터 설정을 기반으로 활성화 모드를 세밀하게 제어하는 기술입니다. Cursor는 설정에 따라 항상 적용, 특정 파일 적용, 자동 추천, 수동 적용이라는 네 가지 모드를 제공하며, 이를 통해 불필요한 토큰 낭비를 원천적으로 차단합니다.

예를 들어 프론트엔드 작업에만 특정 스타일 가이드를 매칭하고 싶다면, 아래와 같이 특정 파일 적용 모드를 사용해 필요한 규칙만 불러오도록 파일 규칙을 정의할 수 있습니다.

markdown

Cursor 커뮤니티 포럼 분석에 따르면, Cursor는 이 규칙들을 1단계 주입과 2단계 활성화로 구성된 투 스테이지 프로세스로 처리합니다. 파일 경로가 맞으면 먼저 후보 목록에 올린 뒤, 모델이 본문 지시사항을 따를지 최종 결정하는 방식입니다. 이 아키텍처 덕분에 작업과 무관한 규칙 본문이 컨텍스트에 무분별하게 적재되는 현상을 미연에 방지할 수 있습니다.

실전 모노레포 환경에서의 효율 극대화 방법

프론트엔드와 백엔드가 한데 묶인 모노레포 환경은 모듈형 MDC 규칙의 가치가 가장 극적으로 발휘되는 곳입니다. 기존의 단일 .cursorrules 파일을 사용할 때는 프론트엔드 UI를 수정하는 중에도 백엔드의 데이터베이스 규칙이나 API 제약 사항이 시스템 프롬프트에 불필요하게 끼어들었습니다. 이는 모델의 주의력을 분산시켜 엉뚱한 코드를 제안하는 컨텍스트 오염을 유발하고 매 질문마다 불필요한 비용을 누적시키는 원인이 됩니다.

MDC 표준을 도입하면 디렉터리 경로별로 규칙을 논리적으로 완전히 격리하여 이러한 비효율을 원천 차단할 수 있습니다. 예를 들어 아래와 같이 .cursor/rules/ 디렉터리에 작업 도메인별 규칙을 파일 단위로 구조화합니다.

text

이렇게 구성한 뒤 각 MDC 파일의 프론트매터 경로 설정을 apps/web/**/*와 apps/api/**/*로 각각 지정하면, Cursor는 개발자가 열어둔 파일에 맞춰 필요한 규칙만 실시간으로 메모리에 올립니다. 리액트 컴포넌트를 수정할 때는 Tailwind 스타일 가이드만 적용되고 백엔드 API를 개발할 때는 Prisma나 Fastify 설계 규칙만 활성화되므로 프롬프트 크기가 비약적으로 최적화됩니다. 이러한 정교한 환경 격리는 토큰 소모를 최대 80%까지 줄일 뿐 아니라, 모델의 주의력이 분산되는 현상을 방지해 추론 답변의 정확도와 응답 속도를 극대화합니다.

MDC 규칙 기반으로 경량 작업 환경 설계하기

기존의 비대한 단일 규칙 파일에서 벗어나 모듈형 MDC 규칙을 도입하는 것은 단순한 파일 정리를 넘어, 인공지능 개발 환경의 리소스를 최적화하는 핵심 엔지니어링 작업입니다. 개발 도메인에 맞춘 경량 규칙 파일은 토큰 소모를 방지할 뿐만 아니라, 코딩 에이전트가 정확한 맥락 안에서 고품질 코드를 생성하도록 돕습니다. 지금 프로젝트 루트의 규칙을 세부 디렉터리 단위로 분할하여 더 빠르고 정확한 자동화 워크플로우를 구축해 보세요.

참고 링크

Loading comments…