Prompt file imported from DojoCodingLabs/claude-code-waypoint (
.claude/commands/resume.md). Fill in{{arguments}}before use. Copyright stays with the author.
Resume work from waypoint plan documentation.
Task Selection
If argument provided: Resume specific task {{arguments}}
If no argument: Show all active tasks and let user choose
Step 1: Discover Active Tasks
List all directories in plans/active/:
ls -la plans/active/
For each task directory found, read the context file to get:
- Task name
- Last updated timestamp
- Current status
- Progress summary
Step 2: Display Task Summary
If multiple tasks exist and no argument provided:
## Active Tasks
### š [task-slug-1]
- **Last Updated**: 2 hours ago (YYYY-MM-DD HH:MM)
- **Status**: In Progress
- **Progress**: 5/12 tasks completed (42%)
- **Current**: Implementing token refresh in auth.ts
- **Next**: Test token refresh flow
### š [task-slug-2]
- **Last Updated**: 1 day ago (YYYY-MM-DD HH:MM)
- **Status**: Blocked
- **Progress**: 3/8 tasks completed (38%)
- **Current**: Waiting for Stripe API keys
- **Blocker**: Need production Stripe keys from team
---
Which task would you like to resume? (Or I can help with the most recent: [task-slug-1])
Step 3: Load Task Context
For the selected task (either from argument or user choice):
Read All Three Files
[task-slug]-plan.md- Overall strategy[task-slug]-context.md- Current state and progress[task-slug]-tasks.md- Detailed checklist
Check Context Freshness
## Context Freshness Check
**Last Updated**: [timestamp]
**Age**: [X hours/days ago]
**Status**:
ā
Fresh (< 3 hours) - Context is current
ā ļø Moderate (3 hours - 1 day) - Might need verification
šØ Stale (> 1 day) - Should verify code state matches context
If context is stale (> 1 day):
ā ļø **Context is stale** (last updated [X days] ago)
**Recommended Actions**:
1. Verify current code state matches context
2. Check for changes by others: `git log --since="[last-update-date]" --oneline`
3. Update context.md before proceeding
4. Run tests to verify current state
Would you like me to:
- [ ] Refresh context automatically
- [ ] Show git changes since last update
- [ ] Proceed anyway (I trust the context)
Step 4: Present Context Summary
# Resuming: [Task Name]
## š Context Summary
**Last Updated**: [timestamp] ([X hours/days] ago)
**Status**: [proposed/in-progress/blocked]
**Overall Progress**: [X/Y] tasks completed ([Z%])
## ā
What's Been Completed ([X] tasks)
- [x] Task 1 completed
- [x] Task 2 completed
- [x] Task 3 completed
## š” What's In Progress ([X] task)
- [ ] **Current Task**: [task description]
- **Working on**: [specific file and function]
- **Status**: [detailed status]
## ā³ What's Coming Next ([X] tasks)
- [ ] Next task 1
- [ ] Next task 2
- [ ] Next task 3
## š« Blockers (if any)
- **Blocker**: [description]
- **Needed**: [what's required to unblock]
## šÆ Next Action
**File**: `[exact file path]`
**Function/Component**: `[exact name]`
**Action**: [Very specific action to take]
**After That**: [Following step]
**Estimated Time**: [time estimate]
---
## š Files to Review
### Recently Modified
- `[file1]` - [what changed]
- `[file2]` - [what changed]
### Key Files
- `[file3]` - [purpose]
- `[file4]` - [purpose]
---
## š Key Decisions Made
[List important decisions from context.md]
## š” Important Discoveries
[List important findings from context.md]
---
## Quick Start Commands
```bash
# Review current implementation
code [current-file-path]
# Run tests
npm run test
# Run development server (if applicable)
npm run dev
# Check git status
git status
Ready to continue? I'll start working on: [NEXT ACTION]
Reply 'yes' to proceed, or tell me what you'd like to do differently.
## Step 5: Verify Code State (Optional)
If context is stale or user wants verification:
```bash
# Check recent git changes
git log --since="[last-update-date]" --oneline --decorate
# Check current file state
ls -la [files from context]
# Run tests to verify state
npm run test 2>&1 | head -20
Present findings:
## Code State Verification
### Git Changes Since Last Update
[Show commits if any]
### File Status
ā
All files from context exist
ā ļø [file] was modified by others
šØ [file] no longer exists
### Test Status
ā
All tests passing
ā ļø [X] tests failing (might be expected)
šØ Build is broken
**Recommendation**: [Update context / Proceed / Investigate]
Step 6: Begin Work
If everything looks good:
ā
Context loaded successfully!
**Starting work on**: [NEXT ACTION]
I'll keep you updated as I make progress. Use `/update-context` before any long break or when approaching context limits.
Then proceed with the next action from the context.
Special Cases
No Active Tasks Found
š No active tasks found in `plans/active/`
Would you like to:
1. Create a new plan with `/create-plan [task-name]`
2. Check archived tasks in `plans/archived/`
3. Start working without formal waypoint plans
Multiple Tasks, User Needs Help Choosing
You have [X] active tasks. Here's my recommendation:
**Most Urgent**: [task-name]
- Last worked on [time] ago
- [X%] complete
- Currently: [status]
**Also Active**:
- [other-task-1]: [brief status]
- [other-task-2]: [brief status]
Which would you like to resume? (Or I can help you decide based on priority)
Context Files Corrupted or Incomplete
ā ļø **Context Issue Detected**
The context files for [task-slug] appear incomplete or corrupted:
- Missing: [list missing sections]
- Incomplete: [list incomplete sections]
**Recovery Options**:
1. Reconstruct context from code and git history
2. Start fresh documentation for this task
3. Manually fix the context files
Which approach would you prefer?
Best Practices
For Claude:
- Always read all three files (plan, context, tasks)
- Check context freshness before proceeding
- Verify file existence if context is stale
- Be specific about NEXT ACTION
- Offer to update context if it's outdated
For Users:
- Keep context.md updated frequently (after significant changes)
- Update timestamps when making changes
- Be specific in NEXT ACTION (file + function + action)
- Archive completed tasks to keep plans/active/ clean
- Use
/update-contextbefore long breaks
Integration with Other Commands
/create-plan [task-name]- Create new waypoint plan structure/update-context- Update SESSION PROGRESS before context reset
See Also
.claude/skills/context-persistence/SKILL.md- Full waypoint plan patterns.claude/skills/memory-management/SKILL.md- Memory storage patternsplans/active/README.md- Task management guidelines (if exists)
