Cursor Rules 47종 모음 — 16개 프레임워크용 AI 코딩 규칙

Cursor에서 "왜 내가 원하는 스타일로 코드를 안 짜지?"라고 답답했다면, 룰 파일을 쓰지 않은 것이다.

GitHub의 survivorforge/cursor-rules 리포에는 16개 프레임워크용 47개 룰 파일이 모여 있다. React부터 Django, Rust, Laravel까지. 이걸 프로젝트에 넣는 순간 AI의 산출물이 확연히 달라진다.

Cursor Rules가 뭔가

Cursor Rules는 프로젝트 루트에 두는 AI 행동 규약 파일이다. .cursorrules 또는 .cursor/rules/*.md 형태로 존재한다.

# React 프로젝트 규칙
 
- 함수형 컴포넌트만 사용, 클래스형 금지
- useState 대신 필요 시 useReducer 우선 고려
- 파일명은 PascalCase, hook은 camelCase
- import 순서: external → internal → styles
- TypeScript strict 모드 전제

이 파일이 있으면 AI가 코드 생성 시 매번 이 규칙을 참고한다. 프롬프트마다 같은 말을 반복할 필요가 없다.

[💡 잠깐! 이 용어는?] .cursorrules: Cursor 에디터가 읽는 규칙 파일. 프로젝트별 AI 행동을 정의한다. VS Code의 .editorconfig와 비슷한 위치.

47개 룰 중 인기 있는 것

리포에서 가장 자주 클론되는 룰은 이렇다.

각 룰은 평균 100~300줄로, 프레임워크의 흔한 함정과 모범 사례를 담고 있다.

좋은 룰 파일의 조건

리포를 훑어보면 잘 쓰인 룰에는 공통점이 있다.

1. 구체적 예시가 있다

## 에러 처리
 
- try/catch는 실제로 처리할 수 있는 곳에서만 사용
- 최상위 경계에서 로깅 + 사용자용 메시지로 변환
- 예시:
  ```ts
  try { await fetchUser() }
  catch (e) {
    logger.error('user fetch failed', e)
    throw new UserFriendlyError('잠시 후 다시 시도해주세요')
  }

"에러 처리를 잘 하라"가 아니라 **패턴을 코드로 보여준다**.

### 2. 금지사항이 명확하다

```markdown title="금지 리스트"
## 절대 하지 말 것

- any 타입 사용 (unknown + 타입 가드로 대체)
- console.log를 프로덕션 코드에 남기기
- eslint-disable 주석 (이슈 번호 없는 경우)

AI는 "하지 마라"가 명확할 때 규칙을 잘 지킨다. 모호한 권고는 무시되기 쉽다.

3. 프로젝트 맥락을 반영한다

범용 룰에 우리 팀 고유 규칙을 얹어야 진짜 효과가 난다.

## 이 프로젝트 고유 규칙
 
- DB 마이그레이션은 반드시 `/migrations` 디렉토리에 두고 번호 prefix 붙임
- 모든 API 응답은 `{ ok, data, error }` 공통 래퍼 사용
- 결제 관련 코드는 @payment-team 리뷰 필수 (PR 템플릿에 명시)

적용 흐름

# 1. 해당 프레임워크 룰 다운로드
curl -o .cursor/rules/react.md \
  https://raw.githubusercontent.com/survivorforge/cursor-rules/main/react/rules.md
 
# 2. 프로젝트 맥락 추가
echo "
## 프로젝트별 규칙
- API 베이스 URL: process.env.API_URL
- 공통 에러 핸들러: src/lib/error.ts
" >> .cursor/rules/react.md
 
# 3. 커밋
git add .cursor/rules/
git commit -m "chore: add cursor rules for react"

룰을 커밋하면 팀원 모두에게 동일한 AI 행동이 적용된다. 개인 설정이 아니라 팀 설정이다.

주의할 점

룰이 너무 길면 무시된다. 컨텍스트 윈도우를 먹기 때문에 500줄 이상은 권장하지 않는다. 도메인별로 파일을 쪼개는 게 낫다.

프레임워크 업데이트를 따라가야 한다. Next.js 15 룰을 Next.js 14 프로젝트에 쓰면 오히려 혼란을 준다.

룰과 코드가 불일치하면 룰이 이긴다. 레거시 코드를 건드릴 때 AI가 "룰대로" 리팩토링을 시도할 수 있으니, 범위를 명시할 것.

정리

• Cursor Rules는 AI 코딩 행동을 팀 단위로 통일하는 설정 파일이다
• 좋은 룰은 구체적 예시, 명확한 금지, 프로젝트 맥락을 담는다
• 47개 공개 룰을 출발점으로 쓰고, 팀 고유 규칙을 얹는 방식이 효율적이다
• 룰이 너무 길거나 오래되면 오히려 역효과다

프롬프트를 매번 새로 쓰는 시대는 끝났다. 규칙을 파일로 남기고 버전 관리하는 팀이 AI 시대의 코드 품질을 지킬 수 있다.

참고:

• cursor-rules 리포: https://github.com/survivorforge/cursor-rules