Cursor 실전 사용 가이드

현재 상황: [기능 설명]. 원하는 결과: [완료 조건]. 관련 파일은 [파일 목록]이다. 먼저 기존 흐름과 변경 계획을 설명하고, 이 파일 밖은 수정하지 마. 작은 diff로 구현한 뒤 [테스트 명령]을 실행하고 실패 원인과 남은 위험을 보고해줘.

사용 팁: 관련 파일과 금지 범위를 함께 주면 예상 밖 수정이 줄어듭니다.

다음 오류를 분석해줘: [오류 로그]. 재현 단계: [재현 단계]. 기대 동작: [기대 동작]. 먼저 가능한 원인을 증거와 함께 순위화하고, 재현 가능한 최소 테스트를 만든 뒤 가장 작은 수정만 적용해줘. 추측으로 의존성을 바꾸지 마.

사용 팁: 오류 메시지 앞뒤 로그와 최근 변경 파일을 같이 제공하세요.

[대상 파일]의 [개선 목표]를 리팩터링해줘. 공개 API와 현재 동작은 유지하고, 먼저 특성 테스트를 추가해줘. 한 단계씩 작은 diff로 진행하고 각 단계 후 [테스트 명령]을 실행해줘. 성능 향상은 측정 없이 단정하지 마.

사용 팁: 리팩터링과 기능 변경을 한 요청에 섞지 마세요.

[사용자 행동]이 코드에서 어떻게 처리되는지 찾아줘. 라우트·이벤트 진입점부터 데이터 저장까지 파일과 함수 순서로 설명하고, 확인한 근거와 아직 추정인 부분을 구분해줘. 아직 파일을 수정하지 마.

사용 팁: 읽기 전용 탐색을 먼저 요청하면 불필요한 수정이 줄어듭니다.

[버그 설명]을 재현하는 가장 작은 테스트를 먼저 작성해줘. 테스트가 현재 코드에서 실패하는지 확인한 뒤 원인을 수정하고 전체 관련 테스트를 실행해줘. 테스트를 통과시키기 위해 기대값을 바꾸지 마.

사용 팁: 재현이 어렵다면 먼저 관찰 로그나 검증 지점을 추가하게 하세요.

[API 또는 타입]을 [새 요구사항]에 맞게 바꾸기 전에 모든 참조와 외부 소비자를 찾아줘. 호환성 위험, 단계적 전환안, 필요한 테스트를 보고하고 승인 전에는 수정하지 마.

사용 팁: 전체 검색 결과를 먼저 검토한 뒤 구현을 분리하세요.

[느린 동작]의 현재 측정값과 관련 코드 [파일]을 분석해줘. 추측으로 최적화하지 말고 프로파일링 지점, 기준 시나리오, 병목 후보를 정리한 뒤 가장 작은 실험을 제안해줘.

사용 팁: 최적화 전후 같은 입력으로 측정해야 합니다.

[컴포넌트]를 semantic HTML, 이름·역할·값, 키보드 탐색, 포커스 표시, 색상 외 정보 전달 기준으로 검토해줘. 실제 문제만 지적하고 수정 후 관련 테스트 또는 수동 확인 절차를 작성해줘.

사용 팁: 스크린리더와 키보드 수동 검수를 테스트와 함께 남기세요.

[현재 기술]에서 [목표 기술]로 옮기는 계획을 세워줘. 호환 레이어, 단계별 배포, 데이터 영향, 관찰 지표, 롤백 조건을 정의하고 한 번에 전체 교체하지 마.

사용 팁: 계획과 구현을 같은 요청에서 모두 실행시키지 마세요.

현재 변경사항을 [요구사항]과 대조해줘. 변경 파일, 사용자 영향, 누락된 예외, 테스트 결과, 보안·데이터 위험, 롤백 방법을 요약해줘. 무관한 변경이나 생성된 임시 파일이 있으면 표시하고 자동으로 삭제하지 마.

사용 팁: diff와 git status를 함께 확인하게 하세요.