[Cursor] AI 프로그래밍의 정석: 생산성을 10배 높이는 10가지 모범 사례
Cursor는 단순한 에디터가 아니라 내 프로젝트를 완벽히 이해하는 AI 페어 프로그래머입니다. 단순히 코드를 자동 생성하는 수준을 넘어, Cursor를 전략적으로 활용하여 더 똑똑하게 개발하는 10가지 방법을 정리했습니다.
요약: Cursor 활용 10대 원칙
| 번호 | 항목 | 설명 |
|---|---|---|
| 1 | PRD 파일 생성 | 개발의 방향성을 잡는 기획 문서를 먼저 작성하세요. |
| 2 | 프로젝트 규칙 설정 | .cursorrules로 내 코드 스타일을 AI에게 학습시키세요. |
| 3 | AGENT vs ASK 구분 | 수행할 것인지 질문할 것인지 명확히 선택하세요. |
| 4 | 최적의 모델 선택 | 작업 난이도에 따라 Claude, GPT, Gemini를 교체하세요. |
| 5 | @ 참조 활용 | 정확한 맥락(파일, 웹, 터미널)을 AI에게 제공하세요. |
| 6 | 정밀한 프롬프트 | 구체적으로 지시할수록 결과물의 품질이 올라갑니다. |
| 7 | 사후 관리 요청 | 로깅, 유닛 테스트, 문서화를 잊지 말고 요청하세요. |
| 8 | 반복적 개선 | 한 번에 끝내지 말고 대화를 통해 코드를 다듬으세요. |
| 9 | 인덱싱 최적화 | 불필요한 파일은 AI의 시야에서 가리세요. |
| 10 | MCP 서버 활용 | 외부 도구를 연결해 AI의 능력을 확장하세요. |
1. 프로젝트의 북극성, PRD 파일 생성
코드를 작성하기 전, 제품 요구 사양서(PRD)를 먼저 만드세요. AI가 프로젝트의 목적과 기능을 완벽히 이해한 상태에서 코드를 작성하게 됩니다.
Tip: instructions.md 또는 PRD.md 파일을 만들고 Cursor에게 요구사항을 정리하게 하세요.
2. .cursorrules로 프로젝트 규칙 정의
프로젝트마다 사용하는 라이브러리와 컨벤션이 다릅니다. 이를 .cursor/rules/ 폴더에 .mdc 파일로 저장하면 AI가 항상 우리 팀의 규칙을 준수합니다.
- FastAPI 규칙 예시: 모든 엔드포인트는 비동기(async def)로 작성하고, Pydantic 모델을 사용해라.
- Streamlit 규칙 예시: 직접적인 HTML 대신 Streamlit 네이티브 컴포넌트를 우선 사용해라.
3. 모드 선택: AGENT(Composer) vs ASK
상황에 맞는 모드 선택이 생산성을 결정합니다.
- AGENT 모드 (Ctrl+I): AI가 직접 파일을 수정하고 터미널 명령을 실행합니다. 기능 구현에 사용하세요.
- ASK 모드 (Ctrl+L): 코드를 수정하지 않고 질문에만 답합니다. 코드 분석 및 디버깅에 최적입니다.
4. 작업에 맞는 최적의 모델 활용
Cursor는 다양한 최신 모델을 지원합니다.
- Claude 3.5 Sonnet: 코딩 실력이 가장 뛰어난 모델 중 하나로 일반적인 개발 작업에 추천합니다.
- GPT-4o / o1 / o3: 논리적 추론이나 복잡한 알고리즘 설계 시 유리합니다.
- Gemini 2.5 Pro: 수만 줄의 코드나 대용량 문서를 한 번에 읽어야 할 때 사용하세요.
5. @ 기호로 정확한 맥락 주입
AI에게 필요한 정보를 정확히 지정해 주세요.
- @File: 특정 파일 전체 내용을 전달
- @Code: 특정 함수나 클래스 조각만 참조
- @Web: 최신 공식 문서나 라이브러리 정보를 검색
- @Terminal: 발생한 에러 로그를 그대로 전달
6. 정밀하고 구체적인 프롬프트 작성
단순히 기능을 만들어 달라고 하기보다 구체적으로 지시하세요.
"FastAPI에서 OAuth2PasswordBearer를 사용해 JWT 기반 로그인을 구현해 줘. 비밀번호는 passlib으로 해싱하고, 결과는 @auth.py에 저장해."
7. 로깅, 테스트, 문서화 생활화
기능 구현만 요청하지 마세요. 유지보수가 가능한 코드를 위해 다음을 추가 요청하세요.
- 로깅: 주요 로직마다 디버깅을 위한 로그를 남겨줘.
- 테스트: 이 로직을 검증할 수 있는 Pytest 코드를 작성해 줘.
- 문서화: 함수 상단에 Google 스타일 Docstring을 추가해 줘.
8. 반복적인 피드백 (Iterative Refinement)
AI가 만든 첫 코드는 초안입니다. 결과를 검토하고 부족한 부분을 대화로 수정해 나가세요. 이 과정을 통해 코드는 점점 더 견고해집니다.
9. 인덱싱 최적화 (.cursorignore)
node_modules나 빌드 결과물(dist)처럼 AI가 읽을 필요 없는 파일은 .cursorignore에 추가하세요. AI의 응답 속도가 빨라지고 엉뚱한 파일을 참조하는 일이 줄어듭니다.
10. MCP 서버로 능력 확장
고급 사용자라면 Model Context Protocol(MCP)을 활용해 보세요. Cursor를 외부 데이터베이스, 로컬 툴, 또는 실시간 API 문서와 연결하여 에디터 이상의 환경을 구축할 수 있습니다.
마치며
Cursor는 단순한 도구가 아니라 사용자의 역량을 증폭시키는 지렛대입니다. 위의 10가지 원칙을 지키며 더 효율적인 개발 환경을 만들어 보세요.
