Cursor .mdc 도입 가이드 — 컨텍스트 낭비와 AI 환각 줄이기

Cursor의 단일 파일 기반 규칙 설정 방식인 기존 .cursorrules는 프로젝트 규모가 커질수록 불필요한 규칙까지 컨텍스트에 포함해 토큰을 낭비하고 AI 환각을 유발하는 원인이 되었습니다. 이를 해결하기 위해 개발 환경에서 필요한 시점에 필요한 규칙만 로드하는 새로운 모듈형 표준인 .mdc 시스템이 도입되었습니다. 이 글에서는 기존의 무거운 글로벌 규칙을 고도로 최적화된 개별 규칙으로 전환하여 프롬프트 크기를 줄이고 AI의 추론 성능을 극대화하는 실전 마이그레이션 방식을 살펴봅니다.

기존 .cursorrules의 한계와 불필요한 토큰 소모

프로젝트 루트에 단 하나의 규칙만 정의하는 기존 .cursorrules 방식은 코드베이스가 커질수록 극심한 비효율을 초래합니다. 백엔드 데이터베이스 스키마와 프론트엔드 컴포넌트 설계 가이드라인처럼 서로 무관한 도메인의 규칙들이 하나의 파일에 혼재되기 때문입니다.

이로 인해 단순한 리액트 컴포넌트 스타일을 수정할 때도 데이터베이스 관련 규칙이 프롬프트에 함께 주입되는 컨텍스트 부패 현상이 발생합니다. 무관한 규칙이 컨텍스트 창을 채우면 불필요한 API 토큰 소모가 늘어날 뿐만 아니라, AI 모델의 주의 집중 영역이 흐려져 추론 정확도가 떨어지고 원치 않는 환각 현상이 유발됩니다.

.mdc 파일의 핵심 메커니즘: YAML 기반의 조건부 활성화

새롭게 도입된 .mdc 표준은 개별 규칙을 여러 파일로 분리하고, 필요한 규칙만 상황에 맞춰 실시간으로 불러오는 적시 적재 방식을 채택했습니다. 개발자가 프로젝트 루트의 .cursor/rules 폴더 안에 개별 .mdc 파일을 생성하면, Cursor는 파일 상단에 정의된 설정을 읽어 규칙의 활성화 여부를 스스로 판단합니다. 이를 통해 불필요한 지시사항이 컨텍스트에 포함되는 현상을 원천 차단합니다.

다음은 특정 리액트 컴포넌트 폴더에만 스타일 규칙을 자동으로 적용하도록 구성한 .mdc 파일의 메타데이터 예시입니다.

이 설정에서 핵심 역할을 하는 세 가지 필드는 바로 description, globs, alwaysApply입니다. alwaysApply가 활성화되면 모든 상황에 규칙이 상시 적용되며, 비활성화된 상태에서는 globs에 지정된 파일 경로를 수정할 때만 규칙이 자동 로드됩니다. 만약 특정 경로에 묶이지 않는 유연한 규칙이라면 AI 에이전트가 description을 직접 읽고 현재 작업 맥락과 관련이 있는지 분석하여 스스로 규칙을 컨텍스트 윈도우에 집어넣습니다.

실전 마이그레이션과 모노레포를 위한 룰 설계

실제 풀스택 프로젝트나 모노레포 환경에서 .mdc 규칙은 격리된 폴더 구조를 통해 진가를 발휘합니다. 프로젝트 루트의 .cursor/rules/ 디렉터리에 각 영역에 맞는 독립적인 규칙 파일을 배치하면, Cursor는 정의된 파일 패턴에 매칭될 때만 해당 규칙을 컨텍스트에 포함합니다.

가장 대표적인 풀스택 프로젝트의 규칙 디렉터리 구성 예시는 다음과 같습니다.

프론트엔드 규칙 파일인 react-components.mdc는 frontend/src/**/*.tsx와 같은 파일 패턴을 감시하며 UI 작성 스타일이나 상태 관리 가이드라인을 제공합니다. 반면, 백엔드 규칙 파일인 prisma-database.mdc는 backend/prisma/schema.prisma나 데이터베이스 접근 코드에만 활성화되어 쿼리 최적화와 트랜잭션 처리 방식을 정의합니다.

이렇게 프론트엔드와 백엔드의 관심사를 철저하게 분리하면, 프론트엔드 스타일을 수정할 때 데이터베이스 스키마 규칙이 컨텍스트를 침범하는 현상을 방지할 수 있습니다. 커뮤니티 경험에 따르면 이러한 구조적 격리를 통해 대규모 프로젝트에서 불필요한 토큰 낭비를 60%에서 80%까지 절감하고 AI의 답변 정확도를 눈에 띄게 개선할 수 있습니다.

결론: 가벼운 규칙이 더 똑똑한 AI를 만든다

AI 모델에게 불필요한 컨텍스트를 과도하게 제공하는 것은 오히려 추론 능력을 떨어뜨리고 무의미한 토큰 낭비를 야기합니다. 프로젝트 루트의 무거운 단일 규칙 파일을 상황에 따라 적시에 활성화되는 모듈형 규칙 파일로 전환해야 하는 이유가 바로 여기에 있습니다. 가볍고 명확하게 설계된 규칙 세트는 대규모 프로젝트에서도 AI의 레이턴시를 낮추고 일관성 높은 결과물을 보장합니다.

기존 규칙 파일을 분석하여 도메인별로 맥락을 분리하는 작업부터 점진적으로 마이그레이션을 시작해 보시기 바랍니다. 필요한 순간에만 적재적소에 개입하는 영리한 규칙 설계가 개발 도구의 가치를 극대화하고 개발 생산성을 한 단계 더 끌어올리는 강력한 열쇠가 될 것입니다.

참고 링크