[AI] Cursor로 context engineering 다루기: Cursor Rules

본 글은 2026.02 cursor 공식 문서 기반으로 작성되었으며,
cursor 업데이트 사항에 따라 아래 정보는 변동될 수 있습니다. (발전 속도가 너무 빨라요,,)

 

작년쯤 chatgpt를 서두로 AI가 한창 떠오를 때는 어떻게 AI한테 질문해야 할지에 대해 다루는 프롬프트 엔지니어링이 떠올랐는데,
시대가 빠르게 바뀌면서 최근에는 AI에게 어떤 정보를 잘 제공해줘야 할지 다루는 컨텍스트 엔지니어링이 떠오르고 있다.
(몇달 뒤에는 Context Engineering Is Dead .. 이런 글이 나오지 않을까..😅;;)

Prompt Engineering Is Dead, and Context Engineering Is Already Obsolete: Why the Future Is Automated Workflow Architecture with

cursor에서도 컨텍스트 정보를 사용자가 직접 정의하고 제공하면서 활용할 수 있으며, 이를 Rule로 정의하고 있다.
LLM은 각 chat마다 오고간 내용을 기억하고 있을 수 없는데,
rule 정의를 통해 prompt 단에서 정보를 사전에 제공하면서 이러한 단점을 해소할 수 있다.

cursor에서 정의하고 있는 Rule 은 크게 4가지로 분류할 수 있다.

• Project Rules: codebase 범위 기준 rule (.cursor/rules 에 저장해서 관리)
• User Rules: 개인 cursor 환경 기준 rule
• Team Rules: dashboard에 정의된 팀 단위 rule (Team / Enterprise plan에서 제공중)
• AGENTS.md: .cursor/rules를 하나의 파일로 대체

Project Rules

project rule은 코드에 대한 도메인별 지식을 제공하거나, 프로젝트별 workflow나 템플릿 자동화를 위해, 그리고 스타일이나 아키텍쳐를 표준화 하고자 할 때 사용할 수 있다.

아래와 같이 .cursor/rules에 markdown 형식 파일로 정의하면서 해당 프로젝트를 작업하는 사람들과 함께 관리할 수 있다.

.cursor/rules/
  react-patterns.mdc       # Rule with frontmatter (description, globs)
  api-guidelines.md        # Simple markdown rule
  frontend/                # Organize rules in folders
    components.md

.mdc 라는 확장자의 파일은 기존 markdown 파일에 상단에 frontmatter 정보를 제공해주는 형식으로
해당 규칙이 언제, 어떤 파일에 적용되어야 하는지를 제어해줄 수 있다.

---
description: "프론트엔드 컴포넌트 및 API 유효성 검사 표준"
globs: "src/components/**"
alwaysApply: false
---

- Tailwind를 사용하여 스타일링
- Framer Motion으로 애니메이션 처리

cursor 공식 문서에서는 다음과 같은 가이드라인을 제시해주고 있다.

• 500줄 이하로 작성 (단순하게 시작하기)
• 단위가 크면 여러 규칙으로 쪼개기
• 규체적인 예시나 참고할 파일 제공하고, 모호하게 지침하지 말기
• 반복적으로 입력하는 프롬프트가 있을 때 rule로 만들어서 재사용
• 파일 내용을 그대로 넣지 말고, 파일을 참조하도록 처리
• 일반적인 도구(npm, git, pytest 등)에 대한 문서화는 지양 (이미 agent도 알고 있는 정보)
• 자주 사용하는 패턴에 대해서 정의 (edge case에 대해서는 rule로 정의하지 않는 것이 좋음)

 

User Rules

user rules는 개인 로컬 cursor에서 지정할 수 있는 규칙으로, 사용자의 여러 프로젝트에서 공통으로 사용될 수 있다.

chat 실행 시마다 사용될 수 있는 규칙으로, 커뮤니케이션 스타일이나 코딩 컨벤션 등을 정의해둘 수 있다.
(예시: Please reply in a concise style. Avoid unnecessary repetition or filler language.)

 

Team Rules

Team 또는 Enterprise 플랜을 사용하고 있다면, 아래와 같이 팀 단위로 rule을 정의해두고 사용할 수 있다.
이는 cursor dashboard 홈페이지에서 제공하고 있는 기능이다. 

 

AGENTS.md

하나의 마크다운 파일로 복잡한 메타데이터나 설정 없이 제공해줄 수 있는 rule이다.
단순한 코드 스타일, 공통 아키텍쳐 등을 아래와 같이 일반 markdown 형식으로 정의해줄 수 있다.

# Project Instructions

## Code Style

- Use TypeScript for all new files
- Prefer functional components in React
- Use snake_case for database columns

## Architecture

- Follow the repository pattern
- Keep business logic in service layers

또한 아래와 같이 subdirectory에 각각 AGENTS.md 파일을 정의하면서 경로별 세부 rule을 정의해줄 수도 있다고 한다.

project/
  AGENTS.md              # Global instructions
  frontend/
    AGENTS.md            # Frontend-specific instructions
    components/
      AGENTS.md          # Component-specific instructions
  backend/
    AGENTS.md            # Backend-specific instructions

---

이렇게 다양한 방식으로 cursor에 rule을 정의해주면서 context engineering을 진행할 수 있다고 하는데,
실제 rule 정의 유무에 따른 성능 차이는 직접 사용하면서 체감해봐야 할 것 같다.
그리고 지금은 rule을 이렇게 파일 형식으로 정의해주고 있지만..
머지않아 직접 agent가 context를 따로 저장해두고 학습하는 기능도 나오지 않을까..?라는 기대(?)를 해본다.
결론은.. 한번 재밌게 써먹어봐야겠다!

 

References

Rules | Cursor Docs