티스토리 뷰

 

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 가 나왔으니, 그것을 스킬에 녹여만 내도 퀄리티는 보장되는 결과물을 만들 수 있게 될 것 입니다.

공지사항
최근에 올라온 글
최근에 달린 댓글
Total
Today
Yesterday
링크
«   2026/01   »
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
글 보관함