Cursor에서 YOLO 모드를 사용한 빠른 반복
Cursor의 YOLO 모드(You Only Live Once)는 AI가 생성한 모든 diff와 변경 사항을 각각 수동으로 승인하지 않고 자동으로 수락합니다. 이를 통해 반복적인 작업과 신뢰할 수 있는 워크플로우가 크게 가속화되지만 위험도 따릅니다. 이 가이드는 YOLO 모드를 안전하고 효과적으로 사용하는 방법을 다룹니다.
YOLO 모드란?
YOLO 모드를 사용하면:
- 자동 diff 수락 - AI 변경 사항이 즉시 적용됨
- 더 빠른 반복 - 모든 변경에 "수락"을 클릭할 필요 없음
- 일괄 작업 - 여러 변경 사항을 순차적으로 적용
- 마찰 감소 - 플로우 상태를 더 오래 유지
YOLO 모드를 사용할 시기
좋은 사용 사례
| 시나리오 | YOLO가 작동하는 이유 |
|---|---|
| JSDoc 주석 추가 | 위험이 낮고 예측 가능함 |
| 변수 이름 바꾸기 | 검색으로 쉽게 검증 가능 |
| 코드 포맷팅 | 안전하고 되돌릴 수 있음 |
| 타입 추가 | 컴파일러가 오류를 잡음 |
| 가져오기 리팩토링 | IDE가 문제를 강조 표시 |
| 테스트 작성 | 테스트 러너가 검증 |
| 구성 파일 업데이트 | 일반적으로 간단함 |
YOLO를 피해야 할 시나리오
| 시나리오 | 위험 수준 |
|---|---|
| 인증 변경 | 심각 |
| 데이터베이스 마이그레이션 | 심각 |
| 결제 처리 | 심각 |
| API 계약 변경 | 높음 |
| 대규모 아키텍처 변경 | 높음 |
| 프로덕션 배포 | 심각 |
| 파일 삭제 | 높음 |
YOLO 모드 활성화
방법 1: 설정
{
"cursor.yoloMode": true,
"cursor.autoAcceptDiffs": true,
"cursor.autoApplyChanges": true
}
방법 2: 명령 팔레트
Cmd/Ctrl + Shift + P를 누름- "YOLO Mode" 입력
- YOLO 모드 전환 선택
방법 3: 채팅 명령
/yolo
또는:
이 세션에 YOLO 모드 활성화
방법 4: 키보드 단축키
// keybindings.json
{
"key": "cmd+shift+y",
"command": "cursor.toggleYoloMode"
}
YOLO 모드 구성
안전한 YOLO 설정
{
"cursor.yoloMode": true,
"cursor.autoAcceptDiffs": true,
// 안전 제한
"cursor.yolo.maxFilesPerSession": 20,
"cursor.yolo.maxLinesChanged": 500,
"cursor.yolo.requireTestsPass": true,
"cursor.yolo.excludePatterns": [
"src/auth/**",
"src/payment/**",
"src/database/migrations/**",
"**/*.env*",
"config/production/**"
],
// 자동 저장 설정
"cursor.yolo.autoSaveBeforeApply": true,
"cursor.yolo.createGitCheckpoint": true
}
프로젝트별 YOLO
.cursor/yolo-config.json 생성:
{
"enabled": true,
"safePatterns": [
"src/components/**/*.tsx",
"src/hooks/**/*.ts",
"src/utils/**/*.ts",
"tests/**/*.ts"
],
"unsafePatterns": [
"src/auth/**",
"src/api/**",
"src/database/**"
],
"maxChangesPerFile": 50,
"requireReviewFor": [
"*.config.*",
"*.env*",
"Dockerfile"
]
}
안전한 YOLO 워크플로우
워크플로우 1: 문서화 스프린트
[YOLO ON] src/utils/의 모든 함수에 JSDoc 주석 추가
src/utils/helpers.ts의 기존 스타일 따르기
예상: 15-20개 파일 수정, 모든 주석 추가됨 검증: 몇 개 파일을 무작위로 확인
워크플로우 2: TypeScript 마이그레이션
[YOLO ON] src/components/에 TypeScript 타입 추가
src/types/의 인터페이스 사용
기존 런타임 동작 유지
예상: 타입 추가됨, 논리 변경 없음
검증: tsc --noEmit 실행
워크플로우 3: 테스트 생성
[YOLO ON] src/services/user.ts에 대한 단위 테스트 작성
tests/services/auth.test.ts의 패턴 따르기
모든 공개 메서드 커버
예상: 새 테스트 파일 생성됨
검증: npm test로 테스트 실행
워크플로우 4: 가져오기 정리
[YOLO ON] src/pages/의 가져오기 정리
그룹: React, 외부 라이브러리, 내부, 타입
사용하지 않는 가져오기 제거
예상: 깔끔한 가져오기, 기능 변경 없음 검증: 앱이 여전히 빌드됨
안전 조치
1. Git 체크포인트
YOLO 전에 항상 체크포인트 생성:
# YOLO 체크포인트 브랜치 생성
git checkout -b yolo/task-name
# 현재 상태 커밋
git add -A && git commit -m "checkpoint: before YOLO session"
2. YOLO 후 검토
YOLO 세션 후:
# 모든 변경 사항 검토
git diff
# 변경된 파일 확인
git diff --stat
# 테스트 실행
npm test
# 문제가 있으면 되돌리기
git checkout -- .
3. 테스트와 함께 YOLO
테스트가 통과할 때만 YOLO하도록 구성:
{
"cursor.yolo.requireTestsPass": true,
"cursor.yolo.testCommand": "npm test",
"cursor.yolo.stopOnTestFailure": true
}
4. 파일 크기 제한
{
"cursor.yolo.maxFileSizeKB": 100,
"cursor.yolo.maxFilesPerChange": 10,
"cursor.yolo.maxLinesPerFile": 200
}
YOLO 모드 명령
채팅 명령
| 명령 | 작업 |
|---|---|
/yolo on | YOLO 모드 활성화 |
/yolo off | YOLO 모드 비활성화 |
/yolo status | YOLO 상태 확인 |
/yolo safe | 안전한 패턴만 YOLO |
/yolo full | 전체 YOLO(모든 파일) |
세션 명령
[yolo on] 모든 API 엔드포인트에 오류 처리 추가
[yolo safe] 컴포넌트 props를 인터페이스 사용하도록 리팩토링
[yolo off] 잠깐, 마지막 변경부터 먼저 검토하게 해줘
YOLO 효과 측정
이러한 지표를 추적:
| 지표 | YOLO 없음 | YOLO 사용 |
|---|---|---|
| 작업당 시간 | 15-30분 | 5-10분 |
| 변경당 클릭 | 3-5 | 0 |
| 컨텍스트 전환 | 높음 | 낮음 |
| 오류율 | 낮음 | 약간 높음 |
| 되돌림율 | 낮음 | 5-10% |
팀 YOLO 가이드라인
팀이 YOLO를 사용해야 할 때
- 코드 스타일 업데이트
- 문서 개선
- 타입 추가
- 내부 유틸리티 리팩토링
- 테스트 작성
YOLO가 금지된 경우
- 프로덕션 핫픽스
- 보안 관련 변경
- 데이터베이스 스키마 변경
- API 버전 변경
- 구성 변경
YOLO 변경용 PR 템플릿
## YOLO 세션
### 작업
[YOLO 세션이 수행한 작업 설명]
### 변경된 파일
- [x] 모든 변경 사항 검토됨
- [x] 테스트 통과
- [x] 민감한 파일 수정되지 않음
### 검증
- [x] 수동 무작위 검사 완료
- [x] 자동화된 테스트 통과
- [x] 회귀 감지되지 않음
### 롤백
```bash
git revert HEAD
## YOLO 모드 + 기타 기능
### YOLO + 백그라운드 에이전트
[Background, YOLO ON] src/models/의 모든 파일에 타입 추가
### YOLO + 사용자 지정 모드
```json
{
"name": "Safe YOLO",
"systemPrompt": "You are in YOLO mode but with safety constraints. Only modify: .tsx components, .ts utilities, and tests. Never modify: auth, payment, or database files. Always add types, never remove them.",
"tools": {
"write": true,
"edit": true
}
}
YOLO + 계획 모드
[PLAN MODE] 리팩토링 계획
[Review plan]
[YOLO ON] 승인된 계획 실행
일반적인 YOLO 함정
| 함정 | 예방 |
|---|---|
| 잘못된 파일에서 YOLO | excludePatterns 사용 |
| 너무 많은 변경 | maxFilesPerSession 설정 |
| 중단 변경 | 테스트 통과 요구 |
| 추적 상실 | Git 체크포인트 생성 |
| 보안 문제 | auth/payment 파일 제외 |
빠른 YOLO 안전 체크리스트
YOLO 세션 시작 전:
- Git 체크포인트 브랜치 생성
- YOLO 구성 검토
- 작업이 YOLO에 안전한지 확인
- 민감한 디렉터리 제외
- 이후에 테스트를 실행할 수 있음
- 롤백 계획 준비됨
YOLO 세션 후:
-
git diff로 diff 검토 - 테스트 실행
- 핵심 파일 무작위 확인
- 커밋 또는 되돌림