Cursor Notepads, 에이전트 컨텍스트에 어떻게 쓰나

Cursor Notepads는 Composer/Agent에 @로 붙이던 재사용 컨텍스트 묶음이었습니다. Cursor 공식 안내와 포럼 확인에 따르면 2.0(2025년 10월경)에서 Notepads 기능은 제거되었습니다. 지금은 같은 역할을 Rules, Skills, Memories/User Rules, 레포 Markdown으로 나눕니다.

이 글은 “사라진 UI를 되살리는 법”이 아니라, 예전 Notepad 내용을 어디에 옮길지와 에이전트 컨텍스트를 어떻게 나눌지만 다룹니다. 가격·플랜 비교는 없습니다.

Notepad vs rules?

한 줄 답: Notepad는 대화에 @로 끼워 넣던 수동 컨텍스트 패키지였고, Rules는 채팅 시작 시(또는 glob/설명 조건에 맞게) 프롬프트에 자동·반자동으로 포함되는 지속 지시입니다.

구분예전 Notepads지금 Rules
저장Cursor UI 쪽 노트.cursor/rules/*.mdc(프로젝트), User/Team Rules
주입대화에서 @NotepadAlways / Intelligent / globs / @rule
버전 관리UI 의존프로젝트 Rules는 git에 넣기 쉬움
후속 기능제거됨Rules + Skills + Memories로 분화

공식 Rules 문서 기준으로 Project Rules는 .mdc frontmatter(description, globs, alwaysApply)로 적용 범위를 정합니다. plain .md를 .cursor/rules에만 두면 Rules 시스템에서 무시되므로, 단순 문서는 AGENTS.md나 일반 Markdown을 씁니다.

Notepad에 넣었던 내용을 옮길 때의 기본 매핑은 다음과 같습니다.

  • 반복 행동 지침 → Project Rule (.cursor/rules/*.mdc)
  • 다단계 워크플로 → Skill (.cursor/skills/*/SKILL.md)
  • 개인 취향(레포에 올리지 않을 것) → User Rules 또는 Memories
  • 긴 아키텍처·온보딩 설명 → 레포 Markdown + 필요 시 @파일
  • 팀 공통 정책 → Team Rules 또는 레포 Rules

에이전트 프롬프트 쪽은 Prompting agents처럼 @로 파일·폴더·터미널·이전 채팅·diff를 붙이고, Rules/Skills는 컨텍스트 링에서 별도 카테고리로 잡힙니다.

언제 만드나?

한 줄 답: “같은 말을 세 번 이상 반복”하거나 “특정 경로에서만 지켜야 할 규칙”이 보일 때 Rule/Skill을 만들고, 일회성 초안·만료된 프롬프트는 만들지 않습니다.

만들기 좋은 신호:

  1. 매 PR마다 “테스트는 pnpm test, .env 커밋 금지”를 다시 적는다.
  2. src/api/**에서만 쓰는 에러 스키마·검증 규칙이 있다.
  3. 릴리스 체크리스트처럼 절차가 길다(이때는 Skill이 Rule보다 맞다).

만들지 않는 편이 나은 것:

  • 이미 린터/CI가 강제하는 포맷
  • 어제 쓰던 임시 프롬프트 초안
  • 문서 전체를 Rules에 복붙한 장문(파일 @ 참조로 대체)

최소 Project Rule 예:

---
description: API route validation and typed errors
globs: src/routes/api/**/*.ts
alwaysApply: false
---

- Validate inputs at the route boundary.
- Return the existing typed error shape.
- Update the nearest unit test before claiming done.

일회성 작업 맥락은 Notepad 대신 @Branch, @Commit, @Past Chats로 넘기는 편이 컨텍스트 창을 덜 잡아먹습니다(agent best practices).

팀 공유는?

한 줄 답: 레포에 묶을 규칙은 .cursor/rules와 AGENTS.md를 git에 커밋하고, 조직 전역은 Team Rules(대시보드)로 배포합니다. 예전 Notepad UI 공유에 의존하지 않습니다.

실무 나눔:

공유 단위어디에비고
레포 공통.cursor/rules/*.mdc, 루트 AGENTS.mdPR 리뷰 가능
패키지 한정globs 또는 중첩 AGENTS.md범위 좁히기
조직 정책Team RulesTeam/Enterprise, Enforce 옵션
개인만User Rules / Memories시크릿·취향

Team Rules는 Project/User Rules와 함께 쓰이며, 충돌 시 문서상 우선순위는 Team → Project → User입니다. Enforce를 켜면 멤버가 Customize에서 끌 수 없습니다.

마이그레이션 체크리스트:

  1. Cursor 2.0 Export로 남은 Notepad가 있으면 내보냅니다(포럼 안내).
  2. 행동 규칙 / 절차 / 문서를 위 매핑으로 나눕니다.
  3. 레포 Rules는 짧게 유지하고, 본문은 코드·문서 파일을 @로 가리킵니다.
  4. 팀원이 같은 실수를 반복하면 Rule 문구를 고칩니다—노트를 늘리지 않습니다.

마무리

Cursor Notepads는 2.0에서 제거되었습니다. Notepad vs rules의 핵심은 수동 @ 패키지 vs 지속 Rules/Skills이고, 만들 때는 반복·경로 한정·절차를 기준으로, 팀 공유는 git Rules + Team Rules로 가져가면 됩니다. 자세한 적용 타입은 Cursor Rules, 컨텍스트 붙이기는 Prompting agents를 참고하시기 바랍니다.

출처