Resume work from a previous session via handoff document or workflow state. Efficiently restores context for session continuity. Triggered when user needs to continue interrupted work, switch between features, or restore context from a different session. Uses minimal context loading (target under 20%) while providing full situational awareness.
/plugin marketplace add astrosteveo/claude-code-plugins/plugin install astrosteveo-epic-plugins-epic@astrosteveo/claude-code-pluginsThis skill is limited to using the following tools:
Efficiently restore context from a previous EPIC workflow session by loading handoff documents or active workflow state. This skill enables seamless session transitions with minimal context consumption.
/epic:resume [path]Start
│
├─ Path argument provided?
│ ├─ Yes → Validate path → Load item (Step 3)
│ └─ No ↓
│
├─ Discover options (Step 2)
│ ├─ Find handoffs: .claude/handoffs/**/*.md
│ └─ Find workflows: .claude/workflows/*/state.md
│
├─ Options found?
│ ├─ Yes → Present picker → Get user selection
│ └─ No → Report "Nothing to Resume"
│
├─ Load selected item (Step 3)
│ ├─ Handoff → Parse frontmatter + sections
│ └─ Workflow → Parse state.md
│
├─ Determine phase → Selectively load artifacts (Step 4)
│
└─ Present context summary (Step 6)
Check for optional path argument:
Use Glob to find resumable items:
# Pattern: .claude/handoffs/**/*.md
Extract from frontmatter:
date - When created (ISO format)feature - Feature slugtopic - Descriptiontags - Includes phaseSort by date (most recent first).
# Pattern: .claude/workflows/*/state.md
Extract from frontmatter:
feature - Feature slugcurrent_phase - Phase namelast_updated - Last modified dateFrom body:
Sort by last_updated (most recent first).
Use AskUserQuestion with clear formatting:
Which session would you like to resume?
**Recent Handoffs:**
1. [2025-01-15 14:30] 003-add-auth - Phase 2 complete
2. [2025-01-14 09:15] 002-caching - Implementation blocked
**Active Workflows:**
3. [Implement] 003-add-auth - Phase 2 of 4
4. [Plan] 004-logging - Ready for implement
Options: [1] / [2] / [3] / [4]
Limit: Show 4 most recent options total. If more exist, note: "Run with explicit path for older sessions."
Read the handoff file and extract:
From Frontmatter:
date, feature, topic, branch, git_committags - determines phasestatus - completion stateFrom Sections:
## Task(s) - table with task status, current phase## Critical References - most important docs to follow## Recent Changes - file:line references## Learnings - patterns/discoveries## Artifacts - table of artifact paths and status## Action Items & Next Steps - what to do nextRead state.md and extract:
From Frontmatter:
feature, current_phase, last_updatedFrom Sections:
## Phase Status - table showing completed phases## Background Agents - task IDs and status (if in Explore)## Current Progress - Phase Summary table + Active Work## Verification Results - test/lint/type check status## Blockers - current blockers## Next Steps - what to do nextLoad artifacts based on current phase to minimize context:
| Phase | Load | Rationale |
|---|---|---|
| Explore | state.md summary only | Research in progress, nothing to implement yet |
| Plan | state.md + research summaries (first 50 lines each) | Need research context for planning |
| Implement | state.md + plan.md (full) + current phase from progress | Need full plan + current progress |
| Validate | state.md + plan.md (summary) + progress + validation.md | Need to know what was built + test results |
| Commit | state.md + all artifact summaries (first 30 lines each) | Need overview for commit message |
DO:
file:line references instead of full contentDON'T:
Target: Use < 20% of context window while providing full situational awareness.
Based on loaded context, identify:
Examples:
✓ Resumed from Handoff
Source: .claude/handoffs/003-add-auth/2025-01-15_14-30-22_phase2-complete.md
Feature: Add JWT authentication to API endpoints
Phase: Implement - Phase 2 of 4
Git: feature/add-auth @ a1b2c3d
## Current State
Phase 2 (middleware implementation) completed and tested.
JWT validation middleware working with test coverage.
## In Progress
- [x] JWT middleware implementation
- [x] Unit tests for middleware
- [ ] Integration tests with protected routes
## Next Steps
1. Run /epic:implement --phase 3 to begin Phase 3 (protected routes)
2. Update existing route handlers to use auth middleware
3. Run /epic:validate after implementation
## Critical References
- .claude/workflows/003-add-auth/plan.md - Full implementation plan
- src/middleware/auth.ts:15-45 - JWT middleware implementation
## Loaded Artifacts
- Handoff document (full)
- plan.md (summary - phases 3-4)
- state.md (referenced)
Context: 18% | Ready to continue. What would you like to do?
✓ Resumed from Workflow
Source: .claude/workflows/004-logging/state.md
Feature: Add structured logging with Winston
Phase: Plan
Last Updated: 2025-01-15 09:30
## Current State
Research complete. Codebase and documentation explored.
Ready to create implementation plan.
## In Progress
- [x] Codebase exploration (agent completed)
- [x] Winston v3 documentation review (agent completed)
- [ ] Create phased implementation plan
## Next Steps
1. Run /epic:plan to create implementation plan
2. Review plan for approval
3. Begin implementation after approval
## Loaded Artifacts
- state.md (full)
- codebase-research.md (summary)
- docs-research.md (summary)
Context: 15% | Ready to continue. What would you like to do?
⚠️ Nothing to Resume
No handoffs found in .claude/handoffs/
No active workflows found in .claude/workflows/
Start a new workflow with: /epic:explore [feature]
⚠️ Cannot Resume
Path not found: .claude/handoffs/003-add-auth/nonexistent.md
Available handoffs:
- .claude/handoffs/003-add-auth/2025-01-15_14-30-22_phase2-complete.md
- .claude/handoffs/002-caching/2025-01-14_09-15-00_blocked.md
Available workflows:
- .claude/workflows/003-add-auth/state.md
- .claude/workflows/004-logging/state.md
Run /epic:resume without arguments to see a picker.
If a handoff or state file lacks required frontmatter fields, report:
⚠️ Invalid Document
File: [path]
Issue: Missing required frontmatter: [field names]
This file may be corrupted. Please check the file structure.
If artifacts listed in handoff don't exist, continue gracefully:
⚠️ Artifact Not Found
Expected: .claude/workflows/003-add-auth/plan.md
Status: File does not exist (may have been moved or deleted)
Continuing with available artifacts...
If phase is not recognized:
⚠️ Unknown Phase
Phase: [unknown phase]
Expected: Explore, Plan, Implement, Validate, or Commit
Defaulting to minimal artifact loading.
Always report context utilization in the summary:
Context: 18% | Ready to continue
This transparency helps users understand context efficiency.
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.