커서 AI 규칙 마스터하기: AI 기반 앱 개발을 위한 완벽 가이드

esmile1 2025. 2. 13. 14:49

커서 AI 규칙 마스터하기: AI 기반 앱 개발을 위한 완벽 가이드

최근 몇 년간 AI 기술이 발전함에 따라 앱 개발 방식에도 혁신이 일어나고 있습니다. 커서(Cursor) AI는 이러한 변화를 주도하는 핵심 도구 중 하나로, AI 규칙을 통해 코드 생성 및 관리를 효율적으로 수행할 수 있도록 지원합니다. 본 가이드에서는 커서 AI 규칙을 마스터하고, 이를 활용하여 AI 기반 앱 개발 여정을 성공적으로 이끌 수 있도록 돕는 것을 목표로 합니다.

커서 AI 규칙이란 무엇인가?

커서 AI 규칙은 AI가 코드를 생성하고 수정하는 방식을 제어하는 데 사용되는 일종의 "규칙 모음"입니다. AI 모델(LLM)은 방대한 양의 데이터를 학습했지만, 특정 프로젝트의 요구 사항이나 개발자의 선호도를 완벽하게 반영하지 못할 수 있습니다. 커서 AI 규칙을 사용하면 LLM의 동작을 사용자 정의하고, 특정 코딩 스타일을 적용하거나, 특정 라이브러리 사용을 강제하는 등 다양한 방식으로 AI의 코드 생성 방식을 제어할 수 있습니다.

커서 AI 규칙의 중요성

코드 일관성 유지: 팀 전체가 동일한 코딩 스타일과 규칙을 따르도록 강제하여 코드의 일관성을 유지할 수 있습니다.
생산성 향상: 반복적인 작업 자동화, 코드 품질 향상, 오류 발생 가능성 감소 등을 통해 개발 생산성을 높일 수 있습니다.
지식 공유 및 재사용: 커뮤니티에서 공유되는 규칙을 활용하거나, 직접 규칙을 만들어 재사용함으로써 개발 효율성을 극대화할 수 있습니다.

커서 AI 규칙 사용 방법: 30단계 가이드

본 가이드에서는 커서 AI 규칙을 처음 사용하는 사용자도 쉽게 따라 할 수 있도록 30단계로 구성된 상세한 사용 방법을 제공합니다.

1단계: 커서(Cursor) 다운로드 및 설치

cursor.sh에서 커서를 다운로드하여 설치합니다.

2단계: 커서 설정 확인

커서를 실행하고, 설정 메뉴에서 AI 규칙 관련 설정을 확인합니다.

3단계: 전역 규칙 설정 (선택 사항)

모든 프로젝트에 적용할 전역 규칙을 설정합니다. 전역 규칙은 설정 메뉴의 "General" -> "Rules for AI"에서 설정할 수 있습니다.

(암시적 프롬프트): "모든 프로젝트에 적용할 규칙을 설정하세요."

4단계: 프로젝트 규칙 설정

특정 프로젝트에만 적용할 규칙을 설정합니다. 프로젝트 규칙은 프로젝트 폴더 내에 .cursor/rules 폴더를 생성하고, 규칙 파일을 해당 폴더에 저장하는 방식으로 설정할 수 있습니다.

5단계: .cursor/rules 폴더 생성

프로젝트 폴더 내에 .cursor/rules 폴더를 생성합니다.

6단계: 규칙 파일 생성

.cursor/rules 폴더 내에 규칙 파일을 생성합니다. 규칙 파일은 JSON, Markdown 등 다양한 형식으로 작성할 수 있습니다.

7단계: 규칙 작성: 이름 및 설명

새 규칙을 추가하려면 이름을 입력하고 설명합니다.

(암시적 프롬프트): "이 규칙의 이름은 무엇인가요?"
(암시적 프롬프트): "이 규칙은 어떤 역할을 하나요?"

8단계: 규칙 작성: Glob 패턴 설정 (선택 사항)

규칙을 적용할 파일 패턴을 설정합니다. Glob 패턴을 사용하면 특정 파일 또는 폴더에만 규칙을 적용할 수 있습니다.

(암시적 프롬프트): "이 규칙을 적용할 파일 패턴은 무엇인가요?"

9단계: 규칙 작성: 규칙 내용 정의

규칙 파일에 규칙 내용을 정의합니다. 규칙 내용은 AI가 코드를 생성하고 수정하는 방식을 제어하는 명령어 또는 코드 조각으로 구성됩니다.

10단계: 규칙 작성: 규칙 적용 예시 추가 (권장)

규칙이 실제로 어떻게 적용될지 보여주는 예시를 추가합니다. 예시는 AI가 규칙을 더 잘 이해하고, 규칙에 따라 코드를 생성하는 데 도움이 됩니다.

11단계: 규칙 작성: 응답 형식 지정 (선택 사항)

AI가 생성하는 코드의 응답 형식을 지정합니다. 예를 들어, 특정 접두사를 추가하거나, 특정 스타일 가이드를 따르도록 지시할 수 있습니다.

12단계: 작성 규칙 저장

작성한 규칙을 저장합니다.

13단계: codebase indexing

상단 Feature -> Codebase Indexing에 들어가서 리싱크를 진행한다.

14단계: 규칙 활성화

작성한 규칙을 활성화합니다.

15단계: 코드 생성 또는 수정

커서 AI를 사용하여 코드를 생성하거나 수정합니다.

16단계: 규칙 적용 확인

AI가 생성하거나 수정한 코드가 설정한 규칙에 따라 생성되었는지 확인합니다.

17단계: 규칙 디버깅

규칙이 예상대로 작동하지 않는 경우, 규칙 파일을 수정하고 다시 시도합니다.

18단계: 규칙 테스트

다양한 시나리오에서 규칙을 테스트하여 규칙의 효과를 검증합니다.

19단계: 규칙 개선

테스트 결과를 바탕으로 규칙을 개선합니다.

20단계: 규칙 공유 (선택 사항)

작성한 규칙을 커뮤니티에 공유하여 다른 개발자들과 함께 규칙을 개선합니다.

21단계: 새로운 규칙 추가

필요에 따라 새로운 규칙을 추가합니다.

22단계: 규칙 관리

규칙을 체계적으로 관리합니다. 규칙의 이름, 설명, 적용 범위 등을 명확하게 정의하고, 규칙 파일을 체계적으로 정리합니다.

23단계: 버전 관리

규칙 파일의 버전을 관리합니다. Git과 같은 버전 관리 도구를 사용하면 규칙 변경 사항을 추적하고, 이전 버전으로 롤백할 수 있습니다.

24단계: 규칙 문서화

규칙에 대한 문서를 작성합니다. 규칙의 목적, 사용 방법, 예시 등을 문서화하면 다른 개발자들이 규칙을 더 쉽게 이해하고 활용할 수 있습니다.

25단계: 규칙 자동화

CI/CD 파이프라인에 규칙 검사를 자동화합니다. 이를 통해 코드 변경 사항이 규칙을 위반하는지 자동으로 검사하고, 규칙 위반 시 빌드를 중단시킬 수 있습니다.

26단계: 섀드 CN 설치

MPX를 사용하여 섀드 CN을 설치합니다.

27단계: 프로젝트 파일 설정

커서를 사용하기 전에 항상 올바른 폴더를 여십시오.

28단계: Lucid React 설치

Lucid React를 설치합니다.

29단계: 소나 토스트 설치

설치가 안 되어있다면 소나 토스트를 설치합니다.

30단계: 버전 관리

언제든지 커밋할 것을 잊지 마십시오.

추가 팁

명확하고 구체적인 규칙: AI가 이해하기 쉽도록 명확하고 구체적인 규칙을 작성합니다.
간단한 규칙부터 시작: 복잡한 규칙부터 시작하기보다는 간단한 규칙부터 시작하여 점차 복잡도를 높여나갑니다.
주석 활용: 규칙 파일에 주석을