Stats
Links
Categories
Dev Phase Manager
Professional phase and checkpoint management system for Claude Code
Dev Phase Manager is a non-invasive workflow enhancement plugin for Claude Code that enables context-aware, multi-phase development workflows with intelligent checkpoint management.
🎯 Key Features
📍 Checkpoint System
- State Persistence: Save plan execution state across
/clearoperations - Automatic Progress Detection: Parse completed tasks from git history
- Seamless Recovery: Resume execution from saved checkpoints without context loss
🔄 Phase Stack Management
- Multi-Phase Parallel: Suspend current phase to start urgent work
- Phase Hierarchy: Manage active and suspended phases with stack-based approach
- Smart Recovery: Resume suspended phases with full context restoration
🤝 Superpowers Integration
- Non-Invasive Design: Works alongside superpowers without modifications
- Enhanced Workflow: Integrates with
brainstorming,writing-plans,subagent-driven-development - File-Based State: Uses filesystem for state transfer, maintaining clean separation
🛡️ Idempotency & Safety
- Duplicate Prevention: Prevents accidental repeated operations
- Graceful Degradation: Works even when files are missing
- Smart Prompts: Intelligent confirmations and suggestions
📦 Installation
Method 1: From GitHub (Recommended)
# Add GitHub repository as marketplace
claude plugin marketplace add uukuguy/dev-phase-manager
# Install the plugin
claude plugin install dev-phase-manager
Method 2: Local Development
# Clone the repository
git clone https://github.com/uukuguy/dev-phase-manager.git
# Add local directory as marketplace
claude plugin marketplace add /path/to/dev-phase-manager
# Install the plugin
claude plugin install dev-phase-manager
🚀 Quick Start
Basic Workflow
# 1. Start a new phase
/start-phase "Phase 1 - Feature Implementation"
# 2. Design and plan
/brainstorming
/writing-plans
# 3. Save checkpoint before clearing context
/checkpoint-plan
/clear
# 4. Resume execution
/resume-plan
/subagent-driven-development
# 5. Complete phase
/end-phase
Multi-Phase Workflow
# Start Phase 1
/start-phase "Phase 1 - Core Features"
# ... work on Phase 1 ...
# Urgent: Start Phase 2 (suspends Phase 1)
/start-phase "Phase 2 - Critical Bugfix"
# → Prompts: Suspend Phase 1? (y)
# ... complete Phase 2 ...
/end-phase
# Resume Phase 1
/start-phase --resume phase1
# ... complete Phase 1 ...
/end-phase
🏛️ Architecture: Commands + Skills
Dev Phase Manager follows the dual-layer architecture pattern (same as superpowers):
dev-phase-manager/
├── commands/ ← User entry points (thin wrappers)
│ ├── start-phase.md ← One-line: invoke skill
│ ├── end-phase.md
│ ├── list-plan.md
│ ├── checkpoint-plan.md
│ ├── checkpoint-progress.md
│ ├── resume-plan.md
│ ├── mem-save.md ← NEW in v1.1.0
│ └── mem-search.md ← NEW in v1.1.0
└── skills/ ← Full skill logic
├── start-phase/SKILL.md
├── end-phase/SKILL.md
├── list-plan/SKILL.md
├── checkpoint-plan/SKILL.md
├── checkpoint-progress/SKILL.md
├── resume-plan/SKILL.md
├── mem-save/SKILL.md ← NEW in v1.1.0
└── mem-search/SKILL.md ← NEW in v1.1.0
commands/*.md are thin wrappers that invoke the corresponding skill:
---
description: "Start new phase or resume suspended phase"
disable-model-invocation: true
---
Invoke the dev-phase-manager:start-phase skill and follow it exactly as presented to you
skills/*/SKILL.md contain the complete behavior definition with all execution steps.
📚 Commands Reference
Core Commands
/checkpoint-plan
Save current plan execution state to filesystem.
Usage:
/checkpoint-plan
What it does:
- Locates latest plan file in
docs/plans/ - Collects execution state (phase, completed tasks, current task)
- Saves to
docs/plans/.checkpoint.json - Enables recovery after
/clear
Output:
✅ Checkpoint saved
Plan: Phase 5 - MCP Server
File: docs/plans/2026-02-22-mcp-server.md
Phase: design
Status: Design completed, ready for execution
Next steps:
1. /clear - Clear context
2. /resume-plan - Resume execution
/resume-plan
Resume plan execution from saved checkpoint.
Usage:
/resume-plan