75 lines
1.5 KiB
Markdown
75 lines
1.5 KiB
Markdown
# Checkpoint Command
|
|
|
|
Create or verify a checkpoint in your workflow.
|
|
|
|
## Usage
|
|
|
|
`/checkpoint [create|verify|list] [name]`
|
|
|
|
## Create Checkpoint
|
|
|
|
When creating a checkpoint:
|
|
|
|
1. Run `/verify quick` to ensure current state is clean
|
|
2. Create a git stash or commit with checkpoint name
|
|
3. Log checkpoint to `.claude/checkpoints.log`:
|
|
|
|
```bash
|
|
echo "$(date +%Y-%m-%d-%H:%M) | $CHECKPOINT_NAME | $(git rev-parse --short HEAD)" >> .claude/checkpoints.log
|
|
```
|
|
|
|
4. Report checkpoint created
|
|
|
|
## Verify Checkpoint
|
|
|
|
When verifying against a checkpoint:
|
|
|
|
1. Read checkpoint from log
|
|
2. Compare current state to checkpoint:
|
|
- Files added since checkpoint
|
|
- Files modified since checkpoint
|
|
- Test pass rate now vs then
|
|
- Coverage now vs then
|
|
|
|
3. Report:
|
|
```
|
|
CHECKPOINT COMPARISON: $NAME
|
|
============================
|
|
Files changed: X
|
|
Tests: +Y passed / -Z failed
|
|
Coverage: +X% / -Y%
|
|
Build: [PASS/FAIL]
|
|
```
|
|
|
|
## List Checkpoints
|
|
|
|
Show all checkpoints with:
|
|
- Name
|
|
- Timestamp
|
|
- Git SHA
|
|
- Status (current, behind, ahead)
|
|
|
|
## Workflow
|
|
|
|
Typical checkpoint flow:
|
|
|
|
```
|
|
[Start] --> /checkpoint create "feature-start"
|
|
|
|
|
[Implement] --> /checkpoint create "core-done"
|
|
|
|
|
[Test] --> /checkpoint verify "core-done"
|
|
|
|
|
[Refactor] --> /checkpoint create "refactor-done"
|
|
|
|
|
[PR] --> /checkpoint verify "feature-start"
|
|
```
|
|
|
|
## Arguments
|
|
|
|
$ARGUMENTS:
|
|
- `create <name>` - Create named checkpoint
|
|
- `verify <name>` - Verify against named checkpoint
|
|
- `list` - Show all checkpoints
|
|
- `clear` - Remove old checkpoints (keeps last 5)
|