개발ChatGPTClaudeGemini

커서 프롬프트: 내 프로젝트 규칙 파일(.cursor/rules) 만들기

스택·폴더 구조·코딩 규칙을 넣으면 Cursor 공식 형식의 .cursor/rules 규칙 파일과 AGENTS.md 초안을 만듭니다. 예전 .cursorrules 도 옮겨요.

프롬프트 복사: 아래 원문을 복사합니다. 로그인은 필요 없습니다.
[ ] 칸 채우기: [한두 문장] [언어·프레임워크·DB·테스트 도구] [주요 폴더와 하는 일] [예: npm run dev, npm test] 등 7곳을 내 상황으로 바꿉니다. 모르는 칸은 비워 둬도 돼요. AI 가 지어내지 않고 물어봅니다.
AI 에 보내기: ChatGPT·Claude·Gemini 대화창에 붙여 넣고 보냅니다.

드림보트가 쓰고 직접 돌려 본 프롬프트·1주 전 갱신

프롬프트 원문

당신은 Cursor 를 오래 써 온 시니어 개발자입니다. 아래 프로젝트 정보로 Cursor 규칙 파일 초안을 만들어 주세요.

먼저 알아 둘 형식(Cursor 공식 문서, 2026년 10월 기준)
- 프로젝트 규칙은 .cursor/rules 폴더에 .mdc 파일로 둡니다. 확장자가 .md 인 파일은 그 폴더에 있어도 규칙으로 읽히지 않습니다.
- 파일 맨 위 머리말(--- 두 줄 사이)에 description, globs, alwaysApply 를 씁니다. alwaysApply: true 면 모든 채팅에 붙고, globs 를 주면 맞는 파일이 대화에 들어와 있을 때 붙고, description 만 주면 에이전트가 설명을 읽고 필요할 때 붙이고, 셋 다 없으면 채팅에서 @규칙이름 으로 부를 때만 붙습니다.
- 메타데이터 없이 쓰려면 AGENTS.md 를 프로젝트 루트나 하위 폴더에 둡니다. 하위 폴더의 AGENTS.md 는 위 폴더 것과 합쳐지고, 더 가까운 폴더의 지시가 앞섭니다.
- 루트의 .cursorrules 는 예전 방식입니다. 새로 만들지 말고, 적어 준 .cursorrules 가 있으면 그 내용을 .mdc 로 옮겨 적으세요.
- 규칙 하나는 500줄 아래로 두고, 길어지면 여러 파일로 나눕니다.

만들 것
1. 파일 목록 표: 파일 이름 / 적용 방식(항상·특정 파일·필요할 때·부를 때) / 한 줄 설명. 3~6개.
2. 파일마다 전체 내용: 머리말과 본문을 그대로 복사해 저장할 수 있게 코드 블록으로. 본문은 짧은 명령문 목록으로 쓰고, 이유가 필요한 줄에만 한 줄 붙이세요.
3. 항상 적용 규칙에 넣을 것: 프로젝트 한 줄 설명, 스택과 버전, 폴더 구조 요약, 실행·테스트 명령, 꼭 지킬 규칙
4. 특정 파일 규칙: 적어 준 폴더 구조에서 폴더마다 규칙이 달라야 하는 곳에만 globs 로
5. 원하는 형식에 AGENTS.md 가 있으면: 같은 내용을 메타데이터 없이 정리한 AGENTS.md 초안
6. 적어 준 .cursorrules 가 있으면: 어느 줄을 어느 .mdc 로 옮겼는지 표
7. 끝에 내가 직접 확인할 것 2~3개: 예) 에이전트에게 작은 일을 시켜 규칙대로 하는지 보기, 적어 준 명령이 실제로 도는지, 규칙끼리 부딪히는 줄

지켜 줄 것
- 적어 준 정보에 없는 스택·라이브러리·명령·폴더는 지어내지 말고 「확인 필요」로 남기세요.
- 누구에게나 맞는 말(「깨끗한 코드를 쓴다」 「모범 사례를 따른다」), 린터가 잡는 스타일, npm·git 같은 흔한 도구 설명은 빼세요. 이 프로젝트에서만 의미 있는 규칙만 남깁니다.
- 규칙은 지켰는지 확인할 수 있게 구체적으로 쓰세요. 예) 「컴포넌트 파일 하나에 컴포넌트 하나만 둔다」
- 코드를 통째로 옮겨 적지 말고, 본보기가 되는 파일을 @경로 로 가리키세요.
- 규칙 파일에 API 키·토큰·비밀번호·내부 주소를 넣지 마세요. 규칙은 git 으로 팀과 공유됩니다.
- 마지막에 한 줄: 처음엔 짧게 시작하고, 에이전트가 같은 실수를 되풀이할 때 규칙을 더하라고.

정보가 모자라면 바로 쓰지 말고, 꼭 필요한 것만 먼저 물어보세요(최대 3개).

내 프로젝트
- 만드는 것: [한두 문장]
- 스택과 버전: [언어·프레임워크·DB·테스트 도구]
- 폴더 구조: [주요 폴더와 하는 일]
- 실행·테스트 명령: [예: npm run dev, npm test]
- 꼭 지킬 규칙: [팀 규칙, AI 가 자주 틀리는 것]
- 지금 있는 규칙: [.cursorrules 내용 붙이기 / 없음]
- 원하는 형식: [.mdc / AGENTS.md / 둘 다]

바꿔 넣을 칸: [한두 문장][언어·프레임워크·DB·테스트 도구][주요 폴더와 하는 일][예: npm run dev, npm test][팀 규칙, AI 가 자주 틀리는 것][.cursorrules 내용 붙이기 / 없음][.mdc / AGENTS.md / 둘 다]

이렇게 넣으면 이런 답이 와요

예시 입력

- 만드는 것: 동네 필라테스 스튜디오 예약 웹앱(예시용 가상 서비스). 회원은 수업을 예약하고 취소하며, 강사는 출석을 체크한다
- 스택과 버전: Next.js 15(App Router), TypeScript 5, Tailwind CSS 4, Prisma 6와 PostgreSQL, 테스트는 Vitest
- 폴더 구조: app/(화면과 라우트), app/api/(서버 API), components/(공용 UI), lib/(DB·인증·날짜 함수), prisma/schema.prisma(DB 스키마), tests/(Vitest 테스트)
- 실행·테스트 명령: npm run dev, npm run test, npm run lint
- 꼭 지킬 규칙: 서버 컴포넌트가 기본이고 클라이언트 컴포넌트는 꼭 필요할 때만 / 날짜 계산은 lib/date.ts 의 함수만 쓴다(시간대 버그가 두 번 났다) / DB 는 lib/db.ts 를 거쳐서만 쓴다 / 예약 취소는 수업 3시간 전까지만 / AI 가 자꾸 default export 로 만드는데 named export 로
- 지금 있는 규칙: 루트에 .cursorrules 가 있다. 내용은 "Use TypeScript. Prefer functional components. Write tests for new features." 세 줄
- 원하는 형식: 둘 다

실제로 돌린 결과

주신 정보로 초안을 쓸 수 있어서 질문 없이 바로 만들었습니다. 정보에 없는 것은 지어내지 않고 「확인 필요」로 남겼습니다.

1. 파일 목록

파일 이름	적용 방식	한 줄 설명
`.cursor/rules/project.mdc`	항상	프로젝트 설명, 스택과 버전, 폴더, 명령, 꼭 지킬 규칙
`.cursor/rules/ui.mdc`	특정 파일 (`app/*/.tsx`, `components/*/.tsx`)	서버·클라이언트 컴포넌트 나누기, export 예외, 화면의 날짜 표시
`.cursor/rules/api.mdc`	특정 파일 (`app/api/**`)	권한 확인, 취소 마감을 서버 시각으로 막기
`.cursor/rules/date-time.mdc`	필요할 때	날짜·시간을 계산하거나 보여 줄 때의 세부 규칙
`.cursor/rules/tests.mdc`	특정 파일 (`tests/**`)	시각 고정, 3시간 경계와 시간대 경계 테스트

이렇게 나눴습니다.

꼭 지킬 규칙과, 새 파일을 만들 때도 지켜야 하는 줄(export, 날짜, DB, 테스트 위치)은 항상 규칙에 넣었습니다. globs 규칙은 맞는 파일이 대화에 들어와 있어야 붙기 때문입니다.
lib/ 와 prisma/ 는 globs 규칙을 따로 두지 않았습니다. 지킬 것(date.ts·db.ts)이 이미 항상 규칙에 있고, 그 폴더만의 규칙은 아직 없습니다.
@경로 는 조건부 규칙에만 걸었습니다. @ 로 건 파일은 규칙이 붙을 때 같이 들어가서, 항상 규칙에 걸면 모든 채팅이 그 파일을 싣게 됩니다.

2. 파일 내용

`.cursor/rules/project.mdc`

---
description: 필라테스 예약 웹앱의 개요, 스택, 폴더, 명령, 꼭 지킬 규칙
globs:
alwaysApply: true
---

# 프로젝트
- 동네 필라테스 스튜디오 예약 웹앱(예시용 가상 서비스). 회원은 수업을 예약하고 취소하며, 강사는 출석을 체크한다

# 스택
- Next.js 15(App Router), TypeScript 5, Tailwind CSS 4, Prisma 6, PostgreSQL, Vitest
- 새 파일은 `.ts`·`.tsx` 로 만든다. `.js`·`.jsx` 파일을 새로 만들지 않는다
- `params`·`searchParams`·`cookies()`·`headers()` 는 Promise 다. `await` 한 뒤 쓴다
  - 이유: Next.js 15 에서 비동기로 바뀌었는데 예전 방식 코드가 자주 나온다
- `package.json` 에 의존성을 더하기 전에 먼저 묻는다

# 폴더
- `app/`: 화면과 라우트
- `app/api/`: 서버 API
- `components/`: 공용 UI
- `lib/`: DB(`db.ts`), 인증(파일 이름 「확인 필요」), 날짜(`date.ts`) 함수
- `prisma/schema.prisma`: DB 스키마
- `tests/`: Vitest 테스트
- 이 목록에 없는 최상위 폴더는 만들기 전에 묻는다

# 명령
- 개발 서버: `npm run dev`
- 테스트: `npm run test`
- 린트: `npm run lint`
- 일을 마쳤다고 하기 전에 `npm run test` 와 `npm run lint` 를 돌리고 결과를 함께 알린다
- 빌드, 타입 검사, DB 마이그레이션 명령: 「확인 필요」

# 꼭 지킬 규칙
- 서버 컴포넌트가 기본이다. `'use client'` 는 `useState`·`useEffect` 같은 훅, `onClick` 같은 이벤트 핸들러, 브라우저 API 를 쓰는 파일에만 붙인다
- 날짜·시간 계산은 `lib/date.ts` 의 함수로만 한다. 필요한 함수가 없으면 `lib/date.ts` 에 더한다
  - 이유: 시간대 버그가 두 번 났다
- DB 는 `lib/db.ts` 를 거쳐서만 쓴다. `new PrismaClient()` 는 `lib/db.ts` 에만 둔다
- 예약 취소는 수업 시작 3시간 전까지만 받는다(정확히 3시간 전을 받을지는 「확인 필요」). 판단은 서버(`app/api/`)에서 한다
- named export 만 쓴다
- `export default` 는 Next.js 가 요구하는 파일에만 쓴다: `app/` 의 `page.tsx`·`layout.tsx`·`loading.tsx`·`error.tsx`·`not-found.tsx` 처럼 이름이 정해진 파일, `next.config` 같은 설정 파일
- 새 기능에는 같은 변경 안에 `tests/` 에 테스트를 더한다. 테스트 파일을 소스 옆에 두지 않는다

`.cursor/rules/ui.mdc`

---
description:
globs: app/**/*.tsx,components/**/*.tsx
alwaysApply: false
---

# 화면: app/ 의 .tsx, components/
- `page.tsx`·`layout.tsx` 에는 `'use client'` 를 붙이지 않는다. 버튼·폼처럼 상호작용이 필요한 부분만 클라이언트 컴포넌트로 떼어 낸다
- `error.tsx` 는 예외로 `'use client'` 를 붙인다. Next.js 가 요구한다
- `'use client'` 파일은 `lib/db.ts` 를 import 하지 않는다. 데이터는 서버 컴포넌트에서 읽어 props 로 넘긴다
- 컴포넌트는 함수로 만들고 named export 로 내보낸다. class 컴포넌트를 쓰지 않는다
- 화면에 보여 줄 날짜·시각 문자열도 `lib/date.ts` 의 함수로 만든다. `toLocaleString()`·`toLocaleDateString()` 을 직접 부르지 않는다
  - 이유: 서버와 브라우저의 시간대가 다르면 같은 수업이 다른 시각으로 보인다
- `tailwind.config` 파일(.js·.ts)을 새로 만들지 않는다
  - 이유: Tailwind 4 는 설정을 CSS 파일에 둔다

# 본보기
- 서버 컴포넌트 화면: 「확인 필요」
- 클라이언트 컴포넌트: 「확인 필요」

`.cursor/rules/api.mdc`

---
description:
globs: app/api/**
alwaysApply: false
---

# 서버 API: app/api/
- 핸들러는 `route.ts` 에서 `GET`·`POST` 같은 HTTP 메서드 이름으로 내보낸다
- 로그인과 역할 확인은 `lib/` 의 인증 함수로 한다(파일 이름 「확인 필요」). 핸들러 안에서 따로 만들지 않는다
- 출석 체크 API 는 요청한 사람이 강사인지 먼저 확인한다
- 예약 취소 API 는 그 예약이 요청한 회원의 것인지 먼저 확인한다
- 취소 마감(수업 시작 3시간 전)은 이 API 에서 막는다. 화면에서 버튼을 숨겼더라도 다시 확인한다
- 마감 판단에 쓰는 현재 시각은 서버에서 얻는다. 요청 본문이나 쿼리로 받은 시각을 쓰지 않는다
  - 이유: 브라우저의 시계와 시간대는 믿을 수 없다

# 본보기
- DB 쓰는 법: @lib/db.ts
- 잘 만든 API: 「확인 필요」

`.cursor/rules/date-time.mdc`

---
description: 날짜와 시간을 다루는 코드(수업 시각, 예약 취소 마감, 출석 날짜, 화면의 날짜 표시)를 쓰거나 고칠 때 읽는다
globs:
alwaysApply: false
---

# 날짜와 시간
- 날짜 계산(더하기, 빼기, 비교, 시간대 바꾸기, 표시 형식)은 @lib/date.ts 의 함수로만 한다
- `lib/date.ts` 와 `tests/` 밖에서 `new Date(문자열)` 로 날짜를 읽지 않는다
  - 이유: `'2026-11-02'` 는 UTC 자정으로, `'2026-11-02T10:00'` 은 실행하는 곳의 시간대로 읽혀 기대와 다른 시각이 된다
- `lib/date.ts` 와 `tests/` 밖에서 `getHours()`·`setDate()` 같은 Date 메서드나 밀리초 빼기로 시각을 계산하지 않는다
- 필요한 함수가 없으면 `lib/date.ts` 에 더하고, 같은 변경에 `tests/` 테스트를 넣는다. 다른 파일에 날짜 함수를 만들지 않는다
- 스튜디오 기준 시간대: 「확인 필요」
- DB 에 시각을 저장하는 기준(UTC 인지): 「확인 필요」

`.cursor/rules/tests.mdc`

---
description:
globs: tests/**
alwaysApply: false
---

# 테스트: tests/ (Vitest)
- 현재 시각에 기대는 테스트는 `vi.setSystemTime()` 으로 시각을 고정한다
- 테스트에 넣는 시각은 끝에 `Z` 나 `+09:00` 같은 오프셋을 붙인 문자열로 만든다
- 취소 마감 테스트에는 수업 시작 2시간 59분 전, 정확히 3시간 전, 3시간 1분 전을 모두 넣는다
- 날짜를 다루는 테스트에는 기준 시간대의 날짜와 UTC 날짜가 다른 시각의 수업을 하나 넣는다
  - 이유: 서울 기준이라면 오전 9시 전 수업은 UTC 로 전날이다
- 테스트는 운영 서버와 같은 시간대로 돌린다(서버 시간대와 맞추는 방법 「확인 필요」)
  - 이유: 개발자 컴퓨터의 시간대에서만 맞는 코드를 잡는다
- 테스트 파일 이름 규칙: 「확인 필요」
- 테스트에서 DB 를 다루는 방법(mock 인지 테스트용 DB 인지): 「확인 필요」

# 본보기
- 잘 만든 테스트: 「확인 필요」

3. AGENTS.md 초안

위 다섯 파일을 머리말 없이 한 파일로 합쳤습니다. 프로젝트 루트에 둡니다.

# 필라테스 스튜디오 예약 웹앱

## 프로젝트
- 동네 필라테스 스튜디오 예약 웹앱(예시용 가상 서비스). 회원은 수업을 예약하고 취소하며, 강사는 출석을 체크한다

## 스택
- Next.js 15(App Router), TypeScript 5, Tailwind CSS 4, Prisma 6, PostgreSQL, Vitest
- 새 파일은 `.ts`·`.tsx` 로 만든다. `.js`·`.jsx` 파일을 새로 만들지 않는다
- `params`·`searchParams`·`cookies()`·`headers()` 는 Promise 다. `await` 한 뒤 쓴다
  - 이유: Next.js 15 에서 비동기로 바뀌었는데 예전 방식 코드가 자주 나온다
- `package.json` 에 의존성을 더하기 전에 먼저 묻는다

## 폴더
- `app/`: 화면과 라우트
- `app/api/`: 서버 API
- `components/`: 공용 UI
- `lib/`: DB(`db.ts`), 인증(파일 이름 「확인 필요」), 날짜(`date.ts`) 함수
- `prisma/schema.prisma`: DB 스키마
- `tests/`: Vitest 테스트
- 이 목록에 없는 최상위 폴더는 만들기 전에 묻는다

## 명령
- 개발 서버: `npm run dev`
- 테스트: `npm run test`
- 린트: `npm run lint`
- 일을 마쳤다고 하기 전에 `npm run test` 와 `npm run lint` 를 돌리고 결과를 함께 알린다
- 빌드, 타입 검사, DB 마이그레이션 명령: 「확인 필요」

## 꼭 지킬 규칙
- 서버 컴포넌트가 기본이다. `'use client'` 는 `useState`·`useEffect` 같은 훅, `onClick` 같은 이벤트 핸들러, 브라우저 API 를 쓰는 파일에만 붙인다
- 날짜·시간 계산은 `lib/date.ts` 의 함수로만 한다. 필요한 함수가 없으면 `lib/date.ts` 에 더한다
  - 이유: 시간대 버그가 두 번 났다
- DB 는 `lib/db.ts` 를 거쳐서만 쓴다. `new PrismaClient()` 는 `lib/db.ts` 에만 둔다
- 예약 취소는 수업 시작 3시간 전까지만 받는다(정확히 3시간 전을 받을지는 「확인 필요」). 판단은 서버(`app/api/`)에서 한다
- named export 만 쓴다
- `export default` 는 Next.js 가 요구하는 파일에만 쓴다: `app/` 의 `page.tsx`·`layout.tsx`·`loading.tsx`·`error.tsx`·`not-found.tsx` 처럼 이름이 정해진 파일, `next.config` 같은 설정 파일
- 새 기능에는 같은 변경 안에 `tests/` 에 테스트를 더한다. 테스트 파일을 소스 옆에 두지 않는다

## 화면: `app/` 의 `.tsx`, `components/`
- `page.tsx`·`layout.tsx` 에는 `'use client'` 를 붙이지 않는다. 버튼·폼처럼 상호작용이 필요한 부분만 클라이언트 컴포넌트로 떼어 낸다
- `error.tsx` 는 예외로 `'use client'` 를 붙인다. Next.js 가 요구한다
- `'use client'` 파일은 `lib/db.ts` 를 import 하지 않는다. 데이터는 서버 컴포넌트에서 읽어 props 로 넘긴다
- 컴포넌트는 함수로 만들고 named export 로 내보낸다. class 컴포넌트를 쓰지 않는다
- 화면에 보여 줄 날짜·시각 문자열도 `lib/date.ts` 의 함수로 만든다. `toLocaleString()`·`toLocaleDateString()` 을 직접 부르지 않는다
  - 이유: 서버와 브라우저의 시간대가 다르면 같은 수업이 다른 시각으로 보인다
- `tailwind.config` 파일(.js·.ts)을 새로 만들지 않는다
  - 이유: Tailwind 4 는 설정을 CSS 파일에 둔다
- 본보기: 서버 컴포넌트 화면 「확인 필요」, 클라이언트 컴포넌트 「확인 필요」

## 서버 API: `app/api/`
- 핸들러는 `route.ts` 에서 `GET`·`POST` 같은 HTTP 메서드 이름으로 내보낸다
- 로그인과 역할 확인은 `lib/` 의 인증 함수로 한다(파일 이름 「확인 필요」). 핸들러 안에서 따로 만들지 않는다
- 출석 체크 API 는 요청한 사람이 강사인지 먼저 확인한다
- 예약 취소 API 는 그 예약이 요청한 회원의 것인지 먼저 확인한다
- 취소 마감(수업 시작 3시간 전)은 이 API 에서 막는다. 화면에서 버튼을 숨겼더라도 다시 확인한다
- 마감 판단에 쓰는 현재 시각은 서버에서 얻는다. 요청 본문이나 쿼리로 받은 시각을 쓰지 않는다
  - 이유: 브라우저의 시계와 시간대는 믿을 수 없다
- 본보기: DB 쓰는 법 `lib/db.ts`, 잘 만든 API 「확인 필요」

## 날짜와 시간: 날짜·시간을 계산하거나 보여 줄 때
- 날짜 계산(더하기, 빼기, 비교, 시간대 바꾸기, 표시 형식)은 `lib/date.ts` 의 함수로만 한다
- `lib/date.ts` 와 `tests/` 밖에서 `new Date(문자열)` 로 날짜를 읽지 않는다
  - 이유: `'2026-11-02'` 는 UTC 자정으로, `'2026-11-02T10:00'` 은 실행하는 곳의 시간대로 읽혀 기대와 다른 시각이 된다
- `lib/date.ts` 와 `tests/` 밖에서 `getHours()`·`setDate()` 같은 Date 메서드나 밀리초 빼기로 시각을 계산하지 않는다
- 필요한 함수가 없으면 `lib/date.ts` 에 더하고, 같은 변경에 `tests/` 테스트를 넣는다. 다른 파일에 날짜 함수를 만들지 않는다
- 스튜디오 기준 시간대: 「확인 필요」
- DB 에 시각을 저장하는 기준(UTC 인지): 「확인 필요」

## 테스트: `tests/` (Vitest)
- 현재 시각에 기대는 테스트는 `vi.setSystemTime()` 으로 시각을 고정한다
- 테스트에 넣는 시각은 끝에 `Z` 나 `+09:00` 같은 오프셋을 붙인 문자열로 만든다
- 취소 마감 테스트에는 수업 시작 2시간 59분 전, 정확히 3시간 전, 3시간 1분 전을 모두 넣는다
- 날짜를 다루는 테스트에는 기준 시간대의 날짜와 UTC 날짜가 다른 시각의 수업을 하나 넣는다
  - 이유: 서울 기준이라면 오전 9시 전 수업은 UTC 로 전날이다
- 테스트는 운영 서버와 같은 시간대로 돌린다(서버 시간대와 맞추는 방법 「확인 필요」)
  - 이유: 개발자 컴퓨터의 시간대에서만 맞는 코드를 잡는다
- 테스트 파일 이름 규칙: 「확인 필요」
- 테스트에서 DB 를 다루는 방법(mock 인지 테스트용 DB 인지): 「확인 필요」
- 본보기: 잘 만든 테스트 「확인 필요」

폴더별 절은 app/api/AGENTS.md·tests/AGENTS.md 처럼 그 폴더로 옮겨 나눠도 됩니다. 더 가까운 폴더의 지시가 앞섭니다.
한 저장소에 둘 다 두면 Cursor 에는 같은 규칙이 두 번 붙을 수 있습니다. Cursor 만 쓴다면 .mdc 쪽만 두는 편이 관리하기 쉽고, 둘 다 둔다면 고칠 때 두 곳을 같이 고치세요.

4. `.cursorrules` 옮긴 표

`.cursorrules` 의 줄	옮긴 곳	바꾼 모습
`Use TypeScript.`	`project.mdc` 의 스택	새 파일은 `.ts`·`.tsx` 로 만든다. `.js`·`.jsx` 파일을 새로 만들지 않는다
`Prefer functional components.`	`ui.mdc`	컴포넌트는 함수로 만들고 named export 로 내보낸다. class 컴포넌트를 쓰지 않는다
`Write tests for new features.`	`project.mdc` 의 꼭 지킬 규칙·명령, `tests.mdc`	새 기능에는 같은 변경 안에 `tests/` 에 테스트를 더한다. 끝냈다고 하기 전에 `npm run test` 를 돌린다. 무엇을 넣을지는 `tests.mdc` 에 적었다

「Prefer」처럼 지켰는지 가릴 수 없는 말은 확인할 수 있는 모양으로 바꿨습니다. AGENTS.md 에서도 같은 이름의 절에 들어 있습니다. 다 옮겼으면 루트의 .cursorrules 는 지우세요. 남겨 두면 옛 규칙이 새 규칙과 같이 붙을 수 있습니다.

5. 직접 확인할 것

작은 일 하나 시켜 보기. 새 채팅에서 「내 예약 목록에 취소 버튼을 달아 줘」라고 시킨 뒤 봅니다.
- page.tsx 는 서버 컴포넌트 그대로이고 'use client' 는 버튼 컴포넌트에만 붙었는지
- 새로 생긴 파일에 export default 가 없는지
- 3시간 계산이 lib/date.ts 의 함수를 거치고, 취소 API 가 서버 시각으로 막는지
- tests/ 에 2시간 59분·3시간·3시간 1분 테스트가 생겼는지
명령과 「확인 필요」 채우기. npm run dev·npm run test·npm run lint 가 실제로 도는지, npm run test 가 tests/ 의 테스트를 실제로 찾아 돌리는지(테스트 수가 0이 아닌지) 봅니다. 그다음 「확인 필요」 자리(시간대, 3시간 경계, 인증 파일, 빌드·마이그레이션 명령, 테스트 방식, 본보기 파일)를 채웁니다. 본보기 자리에는 잘 만든 파일의 경로를 적고, .mdc 에서는 앞에 @ 를 붙입니다.
규칙끼리 부딪히는 줄.
- named export 규칙을 따르다 page.tsx·layout.tsx 의 export default 까지 바꾸지 않는지 봅니다. 바꾸면 그 화면이 깨집니다.
- 서버 컴포넌트 규칙을 따르다 error.tsx 의 'use client' 를 지우지 않는지 봅니다. Next.js 는 error.tsx 를 클라이언트 컴포넌트로 요구합니다.
- .mdc 와 AGENTS.md 를 둘 다 둔다면 한쪽만 고쳐 둘이 어긋나지 않았는지 봅니다.

처음엔 이 정도로 짧게 시작하고, 에이전트가 같은 실수를 되풀이할 때마다 그 실수를 막는 줄을 하나씩 더하세요.

위 예시 입력으로 이 프롬프트를 AI(Claude)에 그대로 넣어 받은 답이에요. 모델과 시점에 따라 표현은 달라질 수 있어요.

더 잘 쓰는 법

받은 .mdc 파일은 프로젝트의 .cursor/rules 폴더에 그대로 저장하세요. Cursor 에이전트 채팅에서 /create-rule 을 치고 결과를 붙여도 머리말을 갖춘 규칙 파일로 저장해 줍니다.
폴더 구조는 주요 폴더 이름과 하는 일만 적어도 충분해요. 파일 하나하나까지 붙일 필요는 없어요.
규칙이 안 붙는 것 같으면 적용 방식을 보세요. 필요할 때 붙는 규칙은 description 이 있어야 하고, 특정 파일 규칙은 globs 가 실제 파일과 맞아야 해요.

자주 묻는 질문

커서 프롬프트 설정은 어디서 하나요?

모든 프로젝트에 쓸 내 규칙(User Rules)은 Cursor 의 Customize → Rules 에서, 이 프로젝트에만 쓸 규칙은 프로젝트의 .cursor/rules 폴더에 둡니다. Team·Enterprise 요금제는 대시보드에서 Team Rules 도 걸 수 있고, 서로 부딪히면 Team Rules, 프로젝트 규칙, User Rules 순으로 앞선 쪽을 따릅니다.

.cursorrules 는 이제 안 쓰나요?

루트의 .cursorrules 는 예전 방식이에요. 지금 Cursor 공식 문서는 .cursor/rules 의 .mdc 파일과 AGENTS.md 를 안내합니다. 이미 있다면 「지금 있는 규칙」 칸에 붙이세요. .mdc 로 옮겨 적어 줍니다.

.mdc 와 AGENTS.md 중 무엇을 써야 하나요?

파일마다 적용 범위(항상·특정 파일·필요할 때)를 나누고 싶으면 .mdc, 메타데이터 없이 마크다운 한 파일이 편하면 AGENTS.md 예요. AGENTS.md 는 하위 폴더에도 둘 수 있고, 더 가까운 폴더의 지시가 앞서요.

규칙은 얼마나 길게 써야 하나요?

공식 문서는 규칙 하나를 500줄 아래로 두고 큰 규칙은 나누라고 권해요. 처음엔 짧게 시작하고, AI 가 같은 실수를 되풀이할 때 한 줄씩 더하는 편이 잘 지켜져요.

아직 스택을 정하지 않았으면 어떻게 하나요?

바이브코딩 프롬프트로 기획과 단계별 계획부터 세우고, 정해진 스택을 이 프롬프트에 넣으세요. 만든 코드를 점검할 때는 코드 리뷰 프롬프트를 쓰세요.

#커서 프롬프트 설정#커서 룰#커서 ai#cursor rules#.cursorrules#.cursor/rules#AGENTS.md#커서 기본 프롬프트