테마
Checkpoints
목표
Kiro의 Checkpoints and rewind 기능을 이해하고, 작업 이력 관리와 안전한 실험 방법을 파악합니다.
개념
Checkpoints and rewind는 Kiro가 수행한 모든 작업을 시간순으로 기록하고, 각 시점의 Checkpoint로 이전 상태를 복원하는 기능입니다.
활용
| 기능 | 설명 |
|---|---|
| 작업 이력 확인 | 어떤 변경이 언제 이루어졌는지 추적 |
| Checkpoint 복원 | 특정 시점으로 되돌리기 |
| 실험적 변경 | 안전하게 시도 후 원복 가능 |
사용 방법
- Kiro 패널에서 Checkpoints and rewind 열기
- 각 Checkpoint에는 변경된 파일과 설명이 표시됨
- 원하는 시점을 선택하여 복원
💡 "Ctrl+Z"의 AI 버전 — 파일 단위가 아닌 작업 단위로 되돌릴 수 있습니다.
사전 준비
- Kiro IDE에서 변경해도 되는 연습용 프로젝트 열기
해볼 것
1단계: 작업 이력 만들기
Kiro 채팅에서 파일 생성이나 문구 수정처럼 결과를 쉽게 확인할 수 있는 코드 변경을 두세 번 요청합니다. 각 요청이 끝날 때마다 변경된 파일을 열어 현재 내용을 확인합니다.
2단계: 시점 목록 확인하기
Kiro 패널의 Checkpoints and rewind에서 방금 수행한 작업의 시점 목록을 확인합니다. 되돌리려는 변경의 직전 시점을 찾습니다.
3단계: 특정 시점으로 되돌리기
목록에서 원하는 시점을 선택해 rewind를 실행합니다. 실제 선택 화면과 표시 정보는 현재 Kiro 패널에서 확인하세요.
4단계: 파일로 결과 확인하기
변경했던 파일을 다시 열고 선택한 시점의 내용으로 돌아갔는지 확인합니다. 예상과 다르면 다른 시점을 선택하기 전에 현재 파일 상태를 먼저 확인합니다.
💡 Vibe 실습이나 Spec 실습에서 위험한 리팩터링을 요청하기 전에 현재 시점을 기억해두세요. 결과가 기대와 다르면 Checkpoints and rewind로 작업 단위 전체를 되돌릴 수 있습니다.
기대 결과
- Kiro 작업에 따라 생성된 시점 목록을 확인함
- 특정 시점으로 rewind한 뒤 파일 내용이 이전 상태로 돌아감
- 채팅으로 두 번 이상 코드 변경 요청필수
- Checkpoints and rewind에서 시점 목록 확인필수
- 특정 시점으로 rewind 실행필수
- 파일을 열어 이전 상태 복원 확인필수
다른 기능과의 조합
Checkpoints는 커스텀 에이전트나 헤드리스 실행과 함께 사용하면 더욱 강력합니다. 자동화된 작업에서도 각 단계를 Checkpoint로 기록하므로, 문제가 발생하면 안전하게 이전 상태로 되돌릴 수 있습니다.
🚨 문제 해결
- rewind 후에도 파일이 그대로임: 되돌릴 대상 시점이 변경 이전인지 다시 확인하고, 변경했던 파일을 다시 열어 현재 내용을 확인하세요.
- 작업 이력이 안 보임: Kiro 패널에서 Checkpoints and rewind 위치를 다시 확인하고, 연습용 변경이 완료되었는지 확인하세요.
✅ 핵심 요약
Checkpoints and rewind = 작업 단위 버전 관리. 안전하게 실험 가능