Cursor 규칙 파일로 팀 방식대로 코딩시키기

1단계규칙 파일 만들기

1. 프로젝트 맨 위에 .cursor/rules 폴더를 만들고, 그 안에 .mdc 파일을 둬요. 채팅에서 /create-rule 을 입력하면 AI가 초안을 써 줘요.
2. 파일 맨 위에는 언제 적용할지 적는 머리말이 들어가요. 아래는 우리가 만든 예시예요. 리액트 컴포넌트 파일을 건드릴 때만 붙어요.
   복사

   ---
   description: 리액트 컴포넌트 작성 규칙
   globs: src/components/**/*.tsx
   alwaysApply: false
   ---
   
   - 컴포넌트 하나에 파일 하나.
   - 스타일은 CSS 모듈만 쓴다. 인라인 스타일 금지.
   - 새 컴포넌트를 만들면 같은 폴더에 테스트 파일도 만든다.
   - 모르는 라이브러리는 설치하지 말고 먼저 물어본다.

• 규칙은 짧을수록 잘 지켜요. 한 파일에 한 주제, 명령형 문장으로 쓰세요.

2단계적용 방식 네 가지 고르기

1. 항상 적용: alwaysApply를 true로. 모든 대화에 붙어요. 언어·폴더 구조처럼 늘 필요한 것만.
2. 알아서 적용: alwaysApply false에 description만. AI가 설명을 보고 필요할 때 가져가요.
3. 특정 파일에만: globs에 파일 패턴을 적어요. 그 파일을 다룰 때만 붙어요.
4. 직접 부를 때만: 셋 다 비워 두고, 채팅에서 @규칙이름 으로 불러요.

3단계같이 챙기면 좋은 것

1. 머리말이 귀찮으면 프로젝트 맨 위에 AGENTS.md 라는 평범한 마크다운 파일 하나로도 돼요. 하위 폴더마다 따로 둘 수도 있어요.
2. 큰 작업은 계획 모드로 시작해요. Shift+Tab 으로 모드를 바꾸면 AI가 먼저 코드를 훑고 계획을 보여 줘요. 계획을 고친 뒤 실행시키세요.
3. 결과가 마음에 안 들면 이어서 고쳐 달라고 하기보다, 되돌리고 계획을 더 구체적으로 적어 다시 돌리는 게 빨라요(공식 문서 권장).
4. AI가 보면 안 되는 파일은 .cursorignore 에 적어요. .env 같은 환경변수 파일은 기본으로 빠져 있어요.

• 공식 문서도 .cursorignore가 완벽한 보안 장치는 아니라고 해요. 터미널·MCP 도구는 막지 못해요. 진짜 비밀값은 저장소 밖에 두세요.