티스토리 뷰
AI 코딩 도구 중에서도 Cursor 를 쓰는 사람이 엄청 많을 것 입니다.
이제 커서를 그냥 쓰는 것과 잘 쓰는 것은 차이가 분명합니다.
우리는 AI 로 만들어진 코드 품질이 떨어진다고 생각하여 꼭 인간이 개입해야 한다고 생각합니다.
하지만 어떤 프롬프트로 개인화를 했냐에 따라서 그 퀄리티는 차기아 많이 납니다.
그 차이를 만드는 핵심은 프롬프트가 아니라 👉 Rules와 Skills 설정입니다.
이 글에서는 Cursor를 처음 쓰거나, 이미 쓰고 있지만 매번 수정 지시를 반복하고 있다면 꼭 알아야 할 핵심만 정리해봅니다.
Cursor를 쓰면서 이런 경험 없나요?
- 매번 “함수형 컴포넌트로”, “TypeScript로”, “Tailwind 써줘” 반복
- 프로젝트마다 코드 스타일이 미묘하게 달라짐
- AI가 우리 아키텍처를 전혀 모르는 느낌
- 처음 생성은 괜찮은데, 수정 요청이 계속 늘어남
이 문제의 원인은 단순합니다.
AI는 프로젝트의 ‘기준’을 모른다
그래서 Cursor에는 기준을 고정하는 Rules, 필요할 때만 꺼내 쓰는 Skills라는 개념이 있습니다.
Rules란 무엇인가?
Rules는 “이 프로젝트에서는 이렇게 코딩한다”를 정의하는 규칙입니다.
- 항상 적용됨
- 모든 대화에 자동 포함됨
- AI의 기본 행동을 결정함
쉽게 말하면:
Rules = 프로젝트 헌법
Rules는 이런 걸 정의합니다
- React / TypeScript 코딩 스타일
- 폴더 구조
- 파일 네이밍 규칙
- 상태 관리 방식
- 에러 처리 기본 원칙
최신 Rules 구조
현재 Cursor는 .mdc 파일 기반의 Rules를 권장합니다.
.cursor/
└── rules/
├── index.mdc
├── typescript.mdc
├── react.mdc
└── api.mdc
각 파일은 역할별 규칙을 담습니다.
Rules 파일 예시
---
description: React 컴포넌트 규칙
globs: ["**/*.tsx"]
---
## 컴포넌트 규칙
- 함수형 컴포넌트만 사용
- props는 interface로 정의
- Tailwind CSS 사용
- 복잡한 로직은 custom hook으로 분리
중요한 포인트는 하나입니다.
❌ “좋은 코드 작성”
✅ “이 프로젝트에서는 이렇게 한다”
Skills란 무엇인가?
Rules가 항상 적용되는 기준이라면, Skills는 필요할 때만 불러오는 도메인 전문 지식입니다.
Skills = 상황별 작업 매뉴얼
Rules vs Skills 한눈에 보기
구분RulesSkills
| 적용 | 항상 | 필요할 때 |
| 목적 | 기준 / 제약 | 절차 / 노하우 |
| 예시 | 코딩 스타일 | API 패턴, 배포 방법 |
| 컨텍스트 | 고정 | 동적 로드 |
Skills는 언제 쓰나?
- API 통합 패턴
- 배포 절차
- 테스트 전략
- 특정 도메인 로직
즉,
매번 쓰지는 않지만,
쓸 때는 정확해야 하는 것들
Skills 구조 예시
.cursor/
└── skills/
└── api-integration/
└── SKILL.md
---
name: api-integration
description: REST API 통합 패턴
---
## 원칙
- axios 공통 client 사용
- 응답은 제네릭 타입으로 정의
- 에러는 공통 훅에서 처리
Rules와 Skills를 같이 쓰면 뭐가 달라질까?
설정이 없는 경우
User: 로그인 폼 만들어줘
AI: 클래스 컴포넌트 + inline style
User: 함수형으로
User: Tailwind로
User: 타입 추가
User: validation도…
👉 수정 요청이 계속 늘어남
Rules + Skills 설정 후
User: 로그인 폼 만들어줘
AI는 이미 알고 있습니다.
- 함수형 컴포넌트
- Tailwind 사용
- TypeScript interface
- validation 패턴
- 접근성 고려
👉 한 번에 끝
어떻게 시작하면 좋을까?
처음부터 많이 만들 필요 없습니다.
추천 최소 세트
Rules (5개 이내)
- 프로젝트 공통 규칙
- TypeScript 규칙
- React 규칙
- API 규칙
- 에러 처리 규칙
Skills (선택)
- api-integration
- deploy-guide
- test-strategy
Rules는 적게, 강하게
Skills는 필요할 때만
핵심 정리
- Rules
- AI의 기본 성격을 만든다
- 항상 적용되는 프로젝트 기준
- Skills
- AI의 전문 지식 창고
- 필요할 때만 꺼내 쓰는 매뉴얼
Cursor를 잘 쓰는 팀은
AI에게 일을 “시킨다”기보다
👉 미리 가르쳐두고 함께 일한다
마무리
Cursor Rules와 Skills는
단순한 설정 파일이 아닙니다.
팀의 개발 기준을 AI에게 이식하는 방법
현재 대 AI 시대에서는 AI Tools 을 어떻게 사용하냐가 많은 차이를 내고 있는 것 같습니다.
특히 프론트엔드 개발자들의 경우, vercel 에서 react best practices 가 나왔으니, 그것을 스킬에 녹여만 내도 퀄리티는 보장되는 결과물을 만들 수 있게 될 것 입니다.
'업무 메모..' 카테고리의 다른 글
| Claude Code .claude 폴더 사용 가이드 (0) | 2026.01.21 |
|---|---|
| AX 자동화시 AI 인프라 구축에 필요성 (0) | 2025.12.16 |
| Framelink 를 사용해서 Figma to Cursor 도입 (0) | 2025.11.03 |
| 모노레포 구조에 supabase 연동하기 (2) | 2025.08.18 |
| Figma MCP + VSCode + Github Copilot 가이드 (3) | 2025.08.05 |
- Total
- Today
- Yesterday
- nextjs15
- ChatGPT
- 스벨트
- 서버 to 서버
- Vite
- 티스토리챌린지
- svelte
- Ai
- 깃허브
- vscode
- React
- NextJS
- Zustand
- 오블완
- nextjs13
- Git
- 모노레포
- vue composition api
- AWS
- 타입스크립트
- seo
- nuxt2
- NUXT
- Github Actions
- vue router
- openAI
- nodejs
- nextjs14
- github
- cors
| 일 | 월 | 화 | 수 | 목 | 금 | 토 |
|---|---|---|---|---|---|---|
| 1 | 2 | 3 | ||||
| 4 | 5 | 6 | 7 | 8 | 9 | 10 |
| 11 | 12 | 13 | 14 | 15 | 16 | 17 |
| 18 | 19 | 20 | 21 | 22 | 23 | 24 |
| 25 | 26 | 27 | 28 | 29 | 30 | 31 |
