체크포인트 커맨드

언제 쓰나

워크플로우의 특정 단계를 검증하거나 기록해야 할 때

---
description: 워크플로우에서 검증 확인을 실행한 후 워크플로우 체크포인트를 생성, 확인 또는 목록화합니다.
---

# 체크포인트 명령

워크플로우에서 체크포인트를 생성하거나 확인합니다.

## 사용법

`/checkpoint [create|verify|list] [name]`

## 체크포인트 생성

체크포인트를 생성할 때:

1. `/verify quick`를 실행하여 현재 상태가 깨끗한지 확인합니다.
2. 체크포인트 이름으로 Git stash 또는 커밋을 생성합니다.
3. `.claude/checkpoints.log`에 체크포인트를 기록합니다:

```bash
echo "$(date +%Y-%m-%d-%H:%M) | $CHECKPOINT_NAME | $(git rev-parse --short HEAD)" >> .claude/checkpoints.log
```

4. 체크포인트 생성을 보고합니다.

## 체크포인트 확인

체크포인트를 확인할 때:

1. 로그에서 체크포인트를 읽습니다.
2. 현재 상태를 체크포인트와 비교합니다:
   - 체크포인트 이후 추가된 파일
   - 체크포인트 이후 수정된 파일
   - 테스트 통과율 (현재 vs 이전)
   - 커버리지 (현재 vs 이전)

3. 보고합니다:
```
체크포인트 비교: $NAME
============================
파일 변경: X
테스트: +Y 통과 / -Z 실패
커버리지: +X% / -Y%
빌드: [통과/실패]
```

## 체크포인트 목록

- 이름
- 타임스탬프
- Git SHA
- 상태 (현재, 이전, 이후)

체크포인트를 모두 표시합니다.

## 워크플로우

일반적인 체크포인트 흐름:

```
[시작] --> /checkpoint create "기능 시작"
   |
[구현] --> /checkpoint create "코어 완료"
   |
[테스트] --> /checkpoint verify "코어 완료"
   |
[리팩토링] --> /checkpoint create "리팩토링 완료"
   |
[PR] --> /checkpoint verify "기능 시작"
```

## 인자

$ARGUMENTS:
- `create <name>` - 이름이 지정된 체크포인트 생성
- `verify <name>` - 이름이 지정된 체크포인트 확인
- `list` - 모든 체크포인트 표시
- `clear` - 이전 체크포인트 제거 (최근 5개 유지)

1. 1

   SKILL.md 저장

   아래 버튼으로 복사 → 다음 경로로 저장.

   SKILL.md 복사

   macOSLinuxWindows

   ~/.claude/skills/everything-claude-code/SKILL.md경로 복사
2. 2

   호출

   Claude Code 채팅창에서 자연어로 부르면 자동 발동:

   예) 워크플로우의 특정 단계를 검증하거나 기록해야 할 때

   트리거가 안 잡히면 SKILL.md의 description 줄에 더 구체적인 한국어 키워드를 추가해보세요.