Checkpoint

위험한 작업 전 안전 체크포인트. 롤백 지점을 생성하고 진행 전 위험도를 평가합니다.

트리거 시점

다음 작업 전에 활성화합니다:

• 3개 이상 파일에 영향을 미치는 리팩토링
• 파일 또는 디렉토리 삭제
• 데이터베이스 마이그레이션 (스키마 변경)
• 대규모 이름 변경 (함수, 클래스, 모듈)
• 핵심 추상화 수정 (기본 클래스, 공유 유틸리티)
• 인증 또는 권한 부여 로직 변경
• 빌드 또는 배포 설정 변경

단계

1. 위험 평가

위험 수준을 결정합니다:

수준	기준	예시
LOW	추가 위주 변경, 쉽게 되돌릴 수 있음	새 엔드포인트 추가
MEDIUM	기존 로직 수정, 3-5개 파일	서비스 리팩토링
HIGH	브레이킹 체인지, 5개 초과 파일, 데이터 손실 가능	스키마 마이그레이션
CRITICAL	프로덕션 데이터, 인증, 핵심 인프라	컬럼 삭제

2. 안전망 생성

변경 전에 다음을 수행합니다:

# Option A: Git commit (preferred)
git add -A && git commit -m "checkpoint: before [description]"

# Option B: Git stash (for uncommitted experiments)
git stash push -m "checkpoint: before [description]"

롤백 참조용으로 커밋 또는 스태시 해시를 기록합니다.

3. 사용자 확인

위험 평가 결과를 제시하고 명시적 확인을 요청합니다:

• 위험 수준 및 근거
• 영향받는 파일 수
• 발생 가능한 문제
• 롤백 계획 (되돌리기 위한 정확한 명령어)

MEDIUM 이상의 위험 수준에서는 사용자 확인 없이 절대 진행하지 않습니다.

4. 완료 후 검증

작업 성공 여부를 확인합니다:

• 기존 테스트 실행 (pytest / pnpm test)
• 애플리케이션이 에러 없이 시작되는지 확인
• git diff로 의도하지 않은 파일 변경이 없는지 확인

출력 형식

## Checkpoint: [operation description]

- Risk: [LOW/MEDIUM/HIGH/CRITICAL]
- Files affected: [count]
- Rollback: `git reset --hard [hash]`

### What will change
1. [file]: [what changes]

### What could go wrong
- [risk description]

### Proceed? (y/n)