AI 글쓰기cursor.com
Cursor 규칙(Rules) 파일 만들기말투와 금지 사항을 한 번만 적는 법
Cursor 프로젝트에 규칙 파일을 만들어, AI가 새 대화마다 정해 둔 말투와 금지 사항, 작업 방식을 따르게 합니다.
안녕하세요, muaco입니다.
이 글을 따라 하면 같은 당부를 다시 쓰지 않습니다
이 글을 끝까지 따라 하면 새 대화를 열 때마다 Cursor의 AI가 여러분이 정한 말투, 금지 사항, 작업 방식을 알아서 지킵니다. 프로젝트 폴더 안에 규칙 파일을 하나 만들어 두기만 하면 됩니다.
규칙이 없으면 "정중체로 써 주세요" 같은 당부를 대화마다 되풀이해야 합니다. 규칙 파일에 한 번 적어 두면 규칙이 적용될 때마다 그 내용이 AI가 읽는 대화 맨 앞에 붙습니다.
Cursor는 AI가 들어 있는 편집기입니다. 채팅 창에 심부름을 적듯 일을 맡기면 AI가 폴더의 파일을 직접 열어 읽고 고칩니다. 이렇게 일하는 AI를 Agent라고 부르며 규칙을 읽는 쪽도 Agent입니다.
규칙 파일이 놓일 자리도 알아 두세요. 서류함으로 치면 가장 바깥 상자에 해당하는 폴더를 프로젝트 루트라고 부릅니다. 규칙 파일은 그 안의 .cursor/rules 폴더에 쌓입니다.
시작 전에 준비할 세 가지
터미널(명령어를 쳐서 컴퓨터를 다루는 검은 창)은 열지 않습니다. 모든 단계를 Cursor 화면 안에서 끝냅니다. 그래도 아래 세 가지는 미리 갖춰 두세요.
- Cursor가 설치된 컴퓨터. 설치 과정은 이 글에서 다루지 않습니다.
- 규칙을 걸 프로젝트 폴더 하나. 보고서를 모아 둔 폴더도, 코드 폴더도 됩니다. 규칙은 폴더마다 따로 저장되므로 프로젝트마다 다른 규칙을 둘 수 있습니다.
- 요금제 확인. 프로젝트 규칙에 필요한 요금제는 공식 문서에 따로 적혀 있지 않습니다. 팀 전체에 같은 규칙을 거는 Team Rules만 Team·Enterprise 요금제에서 쓸 수 있습니다.
이 글은 2026년 10월에 읽은 Cursor 공식 문서가 기준입니다. 문서에 버전 번호가 적혀 있지 않으니 메뉴 이름이 달라졌다면 화면에 보이는 이름을 따르세요.
따라 하기의 전체 흐름은 이렇습니다.
따라 하기: 규칙 파일 만들고 시험하기
준비: 당부 모으기
- Cursor에서 규칙을 걸 프로젝트 폴더를 엽니다. 화면에 그 폴더의 파일 목록이 보이면 다음 단계로 넘어갑니다.
- 평소 채팅에서 되풀이하던 당부를 말투, 금지 사항, 작업 방식 세 묶음으로 나눠 메모장에 적어 두세요. 묶음마다 두세 줄이 모였다면 충분합니다.
설정: 규칙 파일 만들기
- Windows는
Ctrl+Shift+P, Mac은Cmd+Shift+P를 눌러 명령 팔레트를 엽니다. 글자를 칠 수 있는 입력 칸이 뜨면 제대로 열린 상태입니다. - 입력 칸에
New Cursor Rule을 치고 나타난 항목을 고릅니다. 규칙 이름을 정하는 단계로 넘어가면 제대로 고른 상태입니다. 이 명령이 보이지 않으면 사이드바의 Customize → Rules에서 Add Rule을 누르세요. - 규칙 이름을
writing-style처럼 내용이 짐작되게 짓습니다. - 본문에 모아 둔 당부를 마크다운으로 옮겨 적습니다.
# 말투 - 답변과 문서는 한국어 정중체로 씁니다. - 결론을 첫 문장에 둡니다.금지 사항
- 원본 파일을 지우거나 덮어쓰지 않습니다. 고칠 때는 사본을 만듭니다.
- 확인하지 않은 숫자를 지어내지 않습니다.
작업 방식
- 파일을 고치기 전에 바꿀 내용을 목록으로 먼저 보여 줍니다.
작업이 끝나면 바꾼 파일 이름을 정리해 알려 줍니다.
- 타입 드롭다운에서 Always Apply를 고릅니다. 말투와 금지 사항은 어느 대화에서나 지켜야 하므로 모든 대화에 들어가는 이 타입이 맞습니다.
- 저장합니다. 프로젝트의
.cursor/rules폴더에writing-style.mdc파일이 생겼다면 성공입니다. Add Rule로 만들었다면 이 폴더를 꼭 다시 보세요. 공식 문서와 달리 도움말은 같은 화면을 계정에 동기화되는 User Rules 자리로 설명합니다.
지금은 Always Apply 하나면 되지만 규칙이 늘어나면 아래 표를 보고 나눠 두세요.
| 타입 | 언제 대화에 들어가나 | 어울리는 규칙 |
|---|---|---|
| Always Apply | 모든 대화 | 말투, 금지 사항 |
| Apply Intelligently | Agent가 규칙 설명을 읽고 관련 있다고 판단할 때 | 회의록 정리 순서처럼 가끔 쓰는 절차 |
| Apply to Specific Files | 파일이 지정한 패턴에 맞을 때 | *.md 문서에만 쓰는 서식 |
| Apply Manually | 채팅에서 @규칙이름으로 부를 때 | 긴 점검표처럼 필요할 때만 쓰는 지침 |
규칙 파일 맨 위에는 택배 송장처럼 언제 꺼낼지 적는 칸이 있고 이 칸을 frontmatter라고 부릅니다. 파일을 직접 만든다면 아래처럼 적습니다.
---
description: 문서 말투와 금지 사항, 작업 순서
alwaysApply: true
---
말투
답변과 문서는 한국어 정중체로 씁니다.
Always Apply가 alwaysApply: true 한 줄입니다. Apply to Specific Files라면 이 값을 false로 두고 globs: docs/**/*.md(docs 폴더 안의 모든 .md 문서)처럼 패턴을 한 줄 더 적습니다.
확인: 규칙이 먹히는지 보기
- 사이드바의 Customize를 열고 Rules로 들어갑니다. 공식 문서에 따르면 모든 규칙과 상태가 이 화면에 모여 있으니 방금 지은 이름이 목록에 있는지 보세요.
- Agent 채팅에서 새 대화를 열고 "이 폴더의 문서 하나를 골라 세 줄로 요약해 주세요"처럼 가벼운 일을 맡깁니다. 정중체로 답하고 결론부터 꺼낸다면 규칙이 들어간 상태입니다.
시험한다고 "파일을 지워 달라"며 금지 사항을 직접 건드리지는 마세요. 규칙이 빠져 있었다면 파일이 정말로 지워집니다. 말투처럼 탈이 없는 부분으로 확인하는 편이 안전합니다.
막히기 쉬운 곳
규칙 파일을 넣었는데 아무 반응이 없습니다
- 보이는 모습:
.cursor/rules폴더에 파일을 직접 넣었는데 Agent가 그 내용을 모르는 듯 답합니다. - 이유: 확장자가
.md면 규칙 시스템이 무시합니다. - 할 일: 확장자를
.mdc로 바꾸고 맨 위에 frontmatter를 넣으세요. 설정 없이 평범한 메모로 두고 싶다면 프로젝트 루트에AGENTS.md를 만드는 방법도 있습니다.
같은 규칙을 지켰다 안 지켰다 합니다
- 보이는 모습: 어떤 대화에서는 규칙대로 답하고 다른 대화에서는 규칙을 모르는 듯합니다.
- 이유: Apply Intelligently는 Agent가 설명(description)을 읽고 판단하므로 설명이 없으면 대화에 끼어들지 못합니다. Apply to Specific Files는 파일이 지정한 패턴에 맞을 때만 들어갑니다.
- 할 일: 규칙의 타입을 확인하세요. Apply Intelligently라면 설명을 채우고 늘 지켜야 할 당부라면 Always Apply로 바꿉니다.
자동완성과 Ctrl+K 편집은 규칙을 따르지 않습니다
- 보이는 모습: 채팅 답은 규칙대로인데, 타이핑 중 뜨는 자동완성(Tab)이나
Ctrl+K(Mac은Cmd+K)로 부르는 Inline Edit 결과는 규칙과 다릅니다. - 이유: 규칙은 Agent(Chat)에만 들어갑니다. 공식 도움말은 Tab 자동완성, Inline Edit, Bugbot PR 리뷰에는 규칙이 적용되지 않는다고 밝힙니다.
- 할 일: 규칙을 지켜야 하는 일은 Agent 채팅으로 맡기세요.
적은 적 없는 지시를 따릅니다
- 보이는 모습: 내 규칙에 없는 말투나 절차로 답합니다.
- 이유: Agent가 읽는 파일이 규칙 폴더만은 아닙니다. 루트의
AGENTS.md는 자동으로 인식되고CLAUDE.md는 타입 설정과 관계없이 항상 적용됩니다. 회사 팀 규칙이 있다면 Team Rules, Project Rules, User Rules 순서로 앞섭니다. - 할 일: 루트에 그 두 파일이 있는지 먼저 열어 보세요. 팀 규칙과 부딪힌다면 관리자에게 물어야 합니다. 관리자가 강제로 걸어 둔 규칙은 사용자가 끌 수 없습니다.
.cursorrules 파일이 이미 있습니다
- 보이는 모습: 프로젝트 루트에
.cursorrules라는 파일이 있습니다. - 이유: 규칙을 적던 옛 방식입니다. 공식 도움말은 이 파일을 레거시로 분류하고 앞으로 사용 중단이 권고될(deprecated) 대상이라고 적고 있습니다.
- 할 일:
New Cursor Rule로 새 규칙을 만들어 내용을 옮기고 타입은 Always Apply로 고르세요. 그래야 예전과 똑같이 동작합니다. 새 규칙이 대화에서 먹히는지 확인한 뒤에만.cursorrules를 지웁니다. 먼저 지우면 옮기다 빠뜨린 내용을 되살리기 어렵습니다.
여기서 더 나아가려면
당부가 늘면 주제별로 파일을 나누고 Agent가 같은 실수를 되풀이할 때마다 규칙을 하나씩 더하세요. 손으로 쓰기 번거롭다면 Agent 채팅에 /create-rule을 입력하고 원하는 규칙을 말로 설명해 보세요.
Cursor CLI(터미널에 명령을 쳐서 Agent를 쓰는 방식)도 편집기와 같은 규칙을 읽습니다.
이상으로 글 마치겠습니다.