Browse Source

refactor: Rename /checkpoint and /resume to /save and /load

- /checkpoint → /save (cleaner naming)
- /resume → /load (avoids confusion with native `claude --resume`)

The save/load pairing is more intuitive and doesn't clash with
Claude Code's built-in session resume functionality.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
0xDarkMatter 4 months ago
parent
commit
69857f7fa9
3 changed files with 54 additions and 54 deletions
  1. 2 2
      README.md
  2. 37 37
      commands/resume.md
  3. 15 15
      commands/checkpoint.md

+ 2 - 2
README.md

@@ -51,8 +51,8 @@ Then symlink or copy to your Claude directories:
 |---------|-------------|
 |---------|-------------|
 | [g-slave](commands/g-slave/) | Dispatch Gemini CLI to analyze large codebases. Gemini does the grunt work, Claude gets the summary. |
 | [g-slave](commands/g-slave/) | Dispatch Gemini CLI to analyze large codebases. Gemini does the grunt work, Claude gets the summary. |
 | [agent-genesis](commands/agent-genesis.md) | Generate Claude Code expert agent prompts for any technology platform. |
 | [agent-genesis](commands/agent-genesis.md) | Generate Claude Code expert agent prompts for any technology platform. |
-| [checkpoint](commands/checkpoint.md) | Save session state before ending. Creates claude-state.json and claude-progress.md for session continuity. |
-| [resume](commands/resume.md) | Restore session context from checkpoint. Shows what changed, suggests next action. |
+| [save](commands/save.md) | Save session state before ending. Creates claude-state.json and claude-progress.md for session continuity. |
+| [load](commands/load.md) | Load session context from saved state. Shows what changed, suggests next action. |
 | [review](commands/review.md) | Code review staged changes or specific files. Analyzes bugs, security, performance, style. |
 | [review](commands/review.md) | Code review staged changes or specific files. Analyzes bugs, security, performance, style. |
 | [test](commands/test.md) | Generate tests with automatic framework detection (Jest, Vitest, pytest, etc.). |
 | [test](commands/test.md) | Generate tests with automatic framework detection (Jest, Vitest, pytest, etc.). |
 | [explain](commands/explain.md) | Deep explanation of complex code, files, or concepts. Architecture, data flow, design decisions. |
 | [explain](commands/explain.md) | Deep explanation of complex code, files, or concepts. Architecture, data flow, design decisions. |

+ 37 - 37
commands/resume.md

@@ -1,10 +1,10 @@
 ---
 ---
-description: "Restore session context from checkpoint. Reads claude-state.json and claude-progress.md, shows what changed, suggests next action."
+description: "Load session context from saved state. Reads claude-state.json and claude-progress.md, shows what changed, suggests next action."
 ---
 ---
 
 
-# Resume - Restore Session Context
+# Load - Restore Session Context
 
 
-Restore your session context from a previous checkpoint. Reads state files, shows what's changed since, and suggests the next action.
+Load your session context from a previous save. Reads state files, shows what's changed since, and suggests the next action.
 
 
 ## Arguments
 ## Arguments
 
 
@@ -18,8 +18,8 @@ If no arguments, read from default `.claude/` location.
    - Load `.claude/claude-state.json`
    - Load `.claude/claude-state.json`
    - Load `.claude/claude-progress.md`
    - Load `.claude/claude-progress.md`
 
 
-2. **Analyze Changes Since Checkpoint**
-   - Git commits since last checkpoint
+2. **Analyze Changes Since Save**
+   - Git commits since last save
    - File modifications
    - File modifications
    - Time elapsed
    - Time elapsed
 
 
@@ -41,9 +41,9 @@ ls -la .claude/claude-state.json .claude/claude-progress.md 2>/dev/null
 
 
 If missing, report:
 If missing, report:
 ```
 ```
-⚠ No checkpoint found in .claude/
+⚠ No saved state found in .claude/
 
 
-To create one, use: /checkpoint
+To create one, use: /save
 ```
 ```
 
 
 ### Step 2: Read State
 ### Step 2: Read State
@@ -53,15 +53,15 @@ Parse `.claude/claude-state.json`:
 - Extract task arrays
 - Extract task arrays
 - Extract context (branch, last commit, notes)
 - Extract context (branch, last commit, notes)
 
 
-### Step 3: Calculate Time Since Checkpoint
+### Step 3: Calculate Time Since Save
 
 
-Compare checkpoint timestamp to current time:
+Compare save timestamp to current time:
 - Format as human-readable ("2 hours ago", "3 days ago")
 - Format as human-readable ("2 hours ago", "3 days ago")
 
 
 ### Step 4: Analyze Git Changes
 ### Step 4: Analyze Git Changes
 
 
 ```bash
 ```bash
-# Commits since checkpoint
+# Commits since save
 git log --oneline <last_commit>..HEAD
 git log --oneline <last_commit>..HEAD
 
 
 # Current status
 # Current status
@@ -78,12 +78,12 @@ Use TodoWrite tool to restore tasks:
 ### Step 6: Display Summary
 ### Step 6: Display Summary
 
 
 ```markdown
 ```markdown
-# Session Resumed
+# Session Loaded
 
 
-**Checkpoint from**: <timestamp> (<relative time>)
+**Saved**: <timestamp> (<relative time>)
 **Branch**: <branch>
 **Branch**: <branch>
 
 
-## Since Last Checkpoint
+## Since Last Save
 - <N> new commits
 - <N> new commits
 - <M> files modified
 - <M> files modified
 - <time> elapsed
 - <time> elapsed
@@ -112,72 +112,72 @@ Based on your in-progress task: **<task name>**
 ## Usage Examples
 ## Usage Examples
 
 
 ```bash
 ```bash
-# Basic resume
-/resume
+# Basic load
+/load
 
 
-# Resume from specific directory
-/resume path/to/project
+# Load from specific directory
+/load path/to/project
 
 
-# Resume with verbose git log
-/resume --verbose
+# Load with verbose git log
+/load --verbose
 ```
 ```
 
 
 ## Flags
 ## Flags
 
 
 | Flag | Effect |
 | Flag | Effect |
 |------|--------|
 |------|--------|
-| `--verbose` | Show full git log since checkpoint |
+| `--verbose` | Show full git log since save |
 | `--no-restore` | Show state without restoring TodoWrite |
 | `--no-restore` | Show state without restoring TodoWrite |
-| `--clear` | Clear checkpoint after resuming |
+| `--clear` | Clear saved state after loading |
 
 
 ## Edge Cases
 ## Edge Cases
 
 
-### No Checkpoint Found
+### No Saved State Found
 ```
 ```
-⚠ No checkpoint found
+⚠ No saved state found
 
 
 This could mean:
 This could mean:
-1. You haven't checkpointed yet (use /checkpoint)
+1. You haven't saved yet (use /save)
 2. Wrong directory (check pwd)
 2. Wrong directory (check pwd)
 3. State files were deleted
 3. State files were deleted
 
 
 To start fresh, just begin working normally.
 To start fresh, just begin working normally.
 ```
 ```
 
 
-### Stale Checkpoint (>7 days)
+### Stale State (>7 days)
 ```
 ```
-⚠ Checkpoint is 12 days old
+⚠ Saved state is 12 days old
 
 
 A lot may have changed. Consider:
 A lot may have changed. Consider:
 1. Review git log manually
 1. Review git log manually
 2. Start fresh if context is lost
 2. Start fresh if context is lost
-3. Resume anyway with: /resume --force
+3. Load anyway with: /load --force
 ```
 ```
 
 
 ### Branch Changed
 ### Branch Changed
 ```
 ```
-⚠ Branch changed since checkpoint
+⚠ Branch changed since save
 
 
-Checkpoint branch: feature/old-branch
+Saved branch: feature/old-branch
 Current branch: feature/new-branch
 Current branch: feature/new-branch
 
 
-The checkpoint may not be relevant. Options:
+The saved state may not be relevant. Options:
 1. Switch back: git checkout feature/old-branch
 1. Switch back: git checkout feature/old-branch
-2. Resume anyway (tasks may still apply)
-3. Clear and start fresh: /resume --clear
+2. Load anyway (tasks may still apply)
+3. Clear and start fresh: /load --clear
 ```
 ```
 
 
-## Integration with /checkpoint
+## Integration with /save
 
 
 These commands form a pair:
 These commands form a pair:
 
 
 ```
 ```
 Session 1:
 Session 1:
   [work on tasks]
   [work on tasks]
-  /checkpoint "Stopped at auth module"
+  /save "Stopped at auth module"
 
 
 Session 2:
 Session 2:
-  /resume
+  /load
   → Shows: "In progress: Auth module refactor"
   → Shows: "In progress: Auth module refactor"
   → Notes: "Stopped at auth module"
   → Notes: "Stopped at auth module"
   → Suggests: "Continue with auth module testing"
   → Suggests: "Continue with auth module testing"
@@ -185,7 +185,7 @@ Session 2:
 
 
 ## Notes
 ## Notes
 
 
-- Resume automatically populates TodoWrite
+- Load automatically populates TodoWrite
 - Use `--no-restore` to preview without changing state
 - Use `--no-restore` to preview without changing state
-- Clear old checkpoints periodically with `--clear`
+- Clear old saves periodically with `--clear`
 - Works across machines if .claude/ is committed
 - Works across machines if .claude/ is committed

+ 15 - 15
commands/checkpoint.md

@@ -2,7 +2,7 @@
 description: "Save session state before ending. Creates claude-state.json and claude-progress.md for session continuity."
 description: "Save session state before ending. Creates claude-state.json and claude-progress.md for session continuity."
 ---
 ---
 
 
-# Checkpoint - Session State Persistence
+# Save - Session State Persistence
 
 
 Save your current session state before ending work. Creates both machine-readable and human-readable progress files.
 Save your current session state before ending work. Creates both machine-readable and human-readable progress files.
 
 
@@ -10,7 +10,7 @@ Save your current session state before ending work. Creates both machine-readabl
 
 
 $ARGUMENTS
 $ARGUMENTS
 
 
-If no arguments, checkpoint current TodoWrite state and git context.
+If no arguments, save current TodoWrite state and git context.
 
 
 ## What This Command Does
 ## What This Command Does
 
 
@@ -76,17 +76,17 @@ If no arguments, checkpoint current TodoWrite state and git context.
 ## Usage Examples
 ## Usage Examples
 
 
 ```bash
 ```bash
-# Basic checkpoint
-/checkpoint
+# Basic save
+/save
 
 
-# Checkpoint with notes
-/checkpoint "Stopped mid-refactor, auth module needs testing"
+# Save with notes
+/save "Stopped mid-refactor, auth module needs testing"
 
 
-# Checkpoint and commit
-/checkpoint --commit
+# Save and commit
+/save --commit
 
 
-# Checkpoint with notes and commit
-/checkpoint "Ready for review" --commit
+# Save with notes and commit
+/save "Ready for review" --commit
 ```
 ```
 
 
 ## Execution Steps
 ## Execution Steps
@@ -135,7 +135,7 @@ Create `.claude/claude-progress.md` with human-readable format:
 If `--commit` flag present:
 If `--commit` flag present:
 ```bash
 ```bash
 git add .claude/claude-state.json .claude/claude-progress.md
 git add .claude/claude-state.json .claude/claude-progress.md
-git commit -m "chore: checkpoint session state"
+git commit -m "chore: save session state"
 ```
 ```
 
 
 ## Output
 ## Output
@@ -143,7 +143,7 @@ git commit -m "chore: checkpoint session state"
 After creating files, report:
 After creating files, report:
 
 
 ```
 ```
-✓ Session checkpointed
+✓ Session saved
 
 
 State saved to:
 State saved to:
   • .claude/claude-state.json
   • .claude/claude-state.json
@@ -155,7 +155,7 @@ Summary:
   • Pending: Z tasks
   • Pending: Z tasks
   • Uncommitted files: N
   • Uncommitted files: N
 
 
-Resume with: /resume
+Load with: /load
 ```
 ```
 
 
 ## Flags
 ## Flags
@@ -168,6 +168,6 @@ Resume with: /resume
 ## Notes
 ## Notes
 
 
 - State files are gitignored by default (add to .gitignore if needed)
 - State files are gitignored by default (add to .gitignore if needed)
-- Use `/resume` to restore state in a new session
-- Checkpoint frequently during long tasks
+- Use `/load` to restore state in a new session
+- Save frequently during long tasks
 - Notes are preserved across sessions
 - Notes are preserved across sessions