Initial commit

commands/checkpoint.md

@@ -0,0 +1,99 @@
+---
+description: Create session checkpoint with automatic state capture
+---
+
+# Checkpoint Workflow
+
+Execute the session-management skill's checkpoint workflow to save progress.
+
+## Step 1: Analyze Current State
+
+The checkpoint manager will automatically analyze:
+- Git changes (modified, added, deleted files)
+- TDD metrics (if TDD mode active)
+- Session metrics (time elapsed, objectives completed)
+
+## Step 2: Gather Optional Inputs (if desired)
+
+Use `AskUserQuestion` to ask if the user wants to provide additional context:
+
+Ask: "Would you like to add notes or create a git commit with this checkpoint?"
+
+Options:
+- **Just save checkpoint** - Create checkpoint document only
+- **Add notes** - Prompt for checkpoint notes (proceed to Question 2a)
+- **Add notes and commit** - Prompt for notes and create git commit (proceed to Question 2a and 2b)
+- **Commit without notes** - Skip notes, create commit with auto-generated message (proceed to Question 2b)
+
+### Question 2a: Checkpoint Notes (if requested)
+
+Ask: "What notes would you like to add to this checkpoint?"
+
+Options:
+- **"Completed [feature/task]"** - Standard completion note
+- **"Work in progress on [area]"** - WIP note
+- **"Blocked on [issue]"** - Blocker note
+- **Other** - Let user type custom notes
+
+### Question 2b: Git Commit (if requested)
+
+Ask: "Should we create a git commit for this checkpoint?"
+
+Options:
+- **Auto-generate commit message** - Use checkpoint analysis to create message
+- **Custom commit message** - Let user type custom message
+- **Skip commit** - Just save checkpoint, no git commit
+
+## Step 3: Execute Checkpoint
+
+Based on collected inputs, execute the checkpoint command:
+
+```bash
+cd ${CLAUDE_PLUGIN_ROOT}/skills/session-management/scripts
+
+# Basic checkpoint (no notes, no commit)
+python session.py checkpoint
+
+# With notes
+python session.py checkpoint --notes "[user notes]"
+
+# With notes and commit
+python session.py checkpoint --notes "[user notes]" --commit
+
+# With commit and custom message
+python session.py checkpoint --commit --message "[custom message]"
+
+# With TDD phase tracking
+python session.py checkpoint --tdd-phase [RED|GREEN|REFACTOR]
+```
+
+The script will:
+- Analyze git diff for changes
+- Capture current metrics
+- Generate checkpoint document
+- Save to `.sessions/checkpoints/checkpoint_[timestamp].md`
+- Optionally create git commit
+
+## Step 4: Confirm Checkpoint Saved
+
+Report to user:
+- Checkpoint file location
+- Summary of changes captured
+- Git commit hash (if commit created)
+- Current session progress
+
+---
+
+## Use This Command
+
+At logical milestones during work:
+- After completing a sub-task
+- Before switching contexts
+- When you want to save progress
+- After each TDD cycle (RED, GREEN, REFACTOR)
+
+## Integration Notes
+
+- Integrates with **tdd-workflow** for automatic phase tracking
+- Checkpoints saved to `.sessions/checkpoints/` directory
+- Git commits tagged with checkpoint metadata