프로젝트를 시작하기 전에 5-10개의 명확한 규칙을 설정하여 Cursor가 코드베이스의 구조와 제약 조건을 이해할 수 있도록 합니다.

예시 규칙:

• 모든 함수에는 JSDoc 주석을 포함한다
• 상태 관리는 Redux를 사용한다
• 비동기 작업은 async/await로 처리한다
• 컴포넌트는 함수형으로 작성한다
• 모든 API 호출은 try-catch로 오류 처리한다

Cursor에 요청할 때 기술 스택, 동작 방식, 제약 조건을 명확히 명시한 미니 스펙 형태로 작성합니다.

전체 애플리케이션을 한 번에 생성하려고 하지 말고, 파일별로 코드를 생성하고 테스트한 후 검토하는 방식으로 작업합니다.

권장 작업 흐름:

1. 핵심 데이터 모델 파일 생성
2. 기본 API 호출 유틸리티 구현
3. 컴포넌트 별로 UI 코드 생성
4. 각 단계별로 테스트 및 검토

테스트를 먼저 작성하고 잠근 다음, 모든 테스트를 통과하는 코드를 생성하도록 요청합니다.

테스트 우선 개발 단계:

1. 기능에 대한 테스트 케이스 작성 요청
2. 생성된 테스트 검토 및 수정
3. 테스트를 충족하는 구현 코드 생성 요청
4. 테스트 실행으로 검증

Cursor가 생성한 코드를 항상 검토하고, 문제가 있는 부분은 직접 수정한 후 해당 수정사항을 예시로 삼도록 안내합니다.

효과적인 피드백 방법:

• “이 부분의 코드 패턴이 더 좋습니다. 앞으로 이런 방식으로 작성해주세요.”
• “이 함수는 [특정 이유]로 인해 문제가 있어 수정했습니다. 유사한 상황에서 참고해주세요.”
• “여기서 사용한 디자인 패턴을 프로젝트 전체에 일관되게 적용해주세요.”

@ file, @ folders, @ git 명령을 사용하여 Cursor가 코드베이스의 올바른 부분에 집중하도록 범위를 지정합니다.

유용한 범위 지정 명령어:

• @ file:src/components/Auth.jsx – 특정 파일에 집중
• @ folders:src/utils – 특정 폴더의 모든 파일 포함
• @ git:feature/login – 특정 Git 브랜치의 변경사항 포함

.cursor/ 디렉토리에 설계 문서와 체크리스트를 보관하여 에이전트가 다음에 수행할 작업의 전체 컨텍스트를 파악할 수 있도록 합니다.

포함할 문서 유형:

• 프로젝트 아키텍처 설명
• 기능별 요구사항 명세
• 코딩 표준 및 가이드라인
• 완료해야 할 작업 체크리스트

코드가 잘못된 경우 길게 설명하기보다 직접 수정하세요. Cursor는 설명보다 편집을 통해 더 빠르게 학습합니다.

처음부터 다시 시작하지 않고 채팅 기록을 사용하여 이전 프롬프트를 반복하고 개선합니다.

채팅 기록 활용 팁:

• 이전 생성 결과에 대해 “이 코드를 기반으로 [추가 기능]을 구현해줘” 요청
• “방금 생성한 코드에서 [특정 부분]만 변경하고 나머지는 유지해줘” 활용
• 이전 대화에서 나온 설명이나 패턴을 참조하여 일관성 유지

의도적으로 모델을 선택하세요. Gemini는 정밀함을, Claude는 폭넓은 이해를 위해 사용합니다.

새롭거나 익숙하지 않은 기술 스택에서 작업할 때는 문서 링크를 제공하세요. Cursor에게 모든 오류와 수정 사항을 라인별로 설명하도록 요청합니다.

효과적인 문서 활용 방법:

• “React Query v5 문서를 참조하여 무한 스크롤 기능을 구현해주세요: [문서 링크]”
• “이 코드에서 발생하는 모든 오류를 식별하고 Next.js 13 문서에 따라 수정해주세요: [문서 링크]”
• “이 GraphQL 스키마를 기반으로 Apollo Client 쿼리를 작성하세요. 참조 문서: [문서 링크]”

대규모 프로젝트는 야간에 인덱싱하도록 하고, 성능을 빠르게 유지하기 위해 컨텍스트 범위를 제한합니다.

대규모 프로젝트 최적화 전략:

• 야간에 전체 코드베이스 인덱싱 실행
• 현재 작업 중인 모듈이나 기능에 관련된 파일만 컨텍스트에 포함
• 큰 프로젝트를 논리적인 하위 모듈로 나누어 관리
• 정기적으로 불필요한 캐시를 정리하여 성능 유지