Use when user asks to list plans, check plan status, resume a plan, archive a plan, or manage the plan registry
Manage SPF plans across all projects. List, status check, resume, and archive plans via simple commands.
| Command | Action | Example |
|---|---|---|
/spf list | List all plans with status | /spf list |
/spf status <project> | Show detailed plan status | /spf status nautilus-trader |
/spf resume <project> | Resume execution of a plan | /spf resume nautilus-trader |
/spf block <project> | Mark plan as blocked | /spf block legacy-api |
/spf unblock <project> | Remove blocked status | /spf unblock legacy-api |
/spf complete <project> | Mark plan complete | /spf complete quant-bot |
/spf archive <project> | Move to archive | /spf archive old-project |
digraph plan_manager {
rankdir=TB;
"User command" [shape=box];
"Parse command" [shape=diamond];
"Read PLANS.md" [shape=box];
"List plans" [shape=box];
"Show status" [shape=box];
"Load task_plan.md" [shape=box];
"Invoke spf-exec-plan" [shape=box];
"Update PLANS.md" [shape=box];
"User command" -> "Parse command";
"Parse command" -> "Read PLANS.md";
"Read PLANS.md" -> "List plans" [label="list"];
"Read PLANS.md" -> "Show status" [label="status"];
"Show status" -> "Load task_plan.md";
"Read PLANS.md" -> "Load task_plan.md" [label="resume"];
"Load task_plan.md" -> "Invoke spf-exec-plan";
"Parse command" -> "Update PLANS.md" [label="block/unblock/complete/archive"];
}
.superpower-with-files/
└── _registry/
└── PLANS.md # Human-readable plan index
Each plan in PLANS.md:
| project-name | Short goal | status | N/M phase | X/Y tasks | YYYY-MM-DD HH:mm |
Status values:
pending - Plan created, not startedin_progress - Currently executingblocked - Cannot proceed (needs external input)complete - All phases done.superpower-with-files/_registry/PLANS.mdOutput:
=== SPF Plans ===
ACTIVE:
nautilus-trader in_progress Phase 3/5 12/25 tasks 2h ago
quant-bot complete Phase 5/5 30/30 tasks 1d ago
BLOCKED:
legacy-api blocked Phase 2/4 8/20 tasks 5d ago
└─ Reason: Waiting for API keys
Commands: /spf status <project> | /spf resume <project>
.superpower-with-files/{project}/task_plan.md.superpower-with-files/{project}/progress.md (last 10 entries)Output:
=== Plan: nautilus-trader ===
Goal: Implement JWT authentication
Status: in_progress
Phase: 3/5 (Implementation)
Tasks: 12/25 complete
Phases:
✅ 1. Requirements & Discovery
✅ 2. Planning & Structure
🔄 3. Implementation (current)
⬜ 4. Testing & Verification
⬜ 5. Delivery
Recent Activity:
2025-03-07 14:30 - Completed: Add token validation
2025-03-07 14:00 - Completed: Implement refresh flow
Next Tasks:
1. Add rate limiting to auth endpoints
2. Write unit tests for token service
Resume: /spf resume nautilus-trader
.superpower-with-files/{project}/task_plan.md.superpower-with-files/{project}/active_tdd_plan.md (if exists)🚀 Resuming plan: {project}spf-exec-plan skill with the project contextPlan {project} marked as blockedPlan {project} unblockedPlan {project} marked completePlan {project} archivedWhen working on a plan, automatically update PLANS.md:
If _registry/PLANS.md doesn't exist:
.superpower-with-files/_registry/ directorytemplates/PLANS.md.superpower-with-files/ for existing projectsUser: "show me my plans"
Agent:
🚀 **SUPERPOWER ACTIVE:** spf-plan-manager
Reading plan registry...
=== SPF Plans ===
ACTIVE:
nautilus-trader in_progress Phase 3/5 12/25 tasks 2h ago
quant-bot complete Phase 5/5 30/30 tasks 1d ago
BLOCKED:
legacy-api blocked Phase 2/4 8/20 tasks 5d ago
└─ Reason: Waiting for API keys from DevOps
Commands: /spf status <project> | /spf resume <project>
User: "what's the status of nautilus-trader plan"
Agent:
🚀 **SUPERPOWER ACTIVE:** spf-plan-manager
=== Plan: nautilus-trader ===
Goal: Implement JWT authentication for REST API
Status: in_progress
Phase: 3/5 (Implementation)
Tasks: 12/25 complete
Phases:
✅ 1. Requirements & Discovery (complete)
✅ 2. Planning & Structure (complete)
🔄 3. Implementation (current)
⬜ 4. Testing & Verification (pending)
⬜ 5. Delivery (pending)
Recent Activity:
2025-03-07 14:30 - Completed: Add token validation middleware
2025-03-07 14:00 - Completed: Implement refresh token flow
2025-03-07 13:30 - Started: Rate limiting implementation
Next Tasks (from active_tdd_plan.md):
1. Add rate limiting to auth endpoints (est. 15 min)
2. Write unit tests for token service (est. 30 min)
3. Integration test for full auth flow (est. 20 min)
Resume: /spf resume nautilus-trader
User: "resume nautilus-trader"
Agent:
🚀 **SUPERPOWER ACTIVE:** spf-plan-manager
🚀 Resuming plan: nautilus-trader
Loading context:
- Reading .superpower-with-files/nautilus-trader/task_plan.md
- Reading .superpower-with-files/nautilus-trader/active_tdd_plan.md
- Reading .superpower-with-files/nautilus-trader/progress.md
Current state:
- Phase: 3/5 (Implementation)
- Tasks: 12/25 complete
- Next: Add rate limiting to auth endpoints
Invoking spf-exec-plan...
(Then invokes spf-exec-plan skill to continue execution)
User: "block legacy-api, waiting for API keys"
Agent:
🚀 **SUPERPOWER ACTIVE:** spf-plan-manager
Updating PLANS.md:
- Moving legacy-api from ACTIVE to BLOCKED
- Adding reason: "Waiting for API keys"
- Timestamp: 2025-03-07 15:00
✅ Plan legacy-api marked as blocked.
When API keys are available: /spf unblock legacy-api
User: "got the API keys, unblock legacy-api"
Agent:
🚀 **SUPERPOWER ACTIVE:** spf-plan-manager
Updating PLANS.md:
- Moving legacy-api from BLOCKED to ACTIVE
- Removing blocked reason
- Timestamp: 2025-03-07 16:30
✅ Plan legacy-api unblocked.
Resume: /spf resume legacy-api
User: "quant-bot is done"
Agent:
🚀 **SUPERPOWER ACTIVE:** spf-plan-manager
Updating PLANS.md:
- Moving quant-bot to COMPLETED section
- Completion time: 2025-03-07 17:00
- Duration: 2 days 4 hours
✅ Plan quant-bot marked complete.
Archive (optional): /spf archive quant-bot
User: "archive old-project"
Agent:
🚀 **SUPERPOWER ACTIVE:** spf-plan-manager
Updating PLANS.md:
- Moving old-project to ARCHIVED section
- Archive date: 2025-03-07
✅ Plan old-project archived.
Archived plans are kept for reference and can be found in the ARCHIVED section of PLANS.md.
User: "/spf list" (when no registry exists)
Agent:
🚀 **SUPERPOWER ACTIVE:** spf-plan-manager
No plan registry found. Creating...
1. Creating .superpower-with-files/_registry/
2. Copying templates/PLANS.md
3. Scanning for existing plans...
Found 2 existing projects:
- nautilus-trader (has task_plan.md)
- quant-bot (has task_plan.md)
Adding entries to PLANS.md...
=== SPF Plans ===
ACTIVE:
nautilus-trader in_progress Phase 3/5 12/25 tasks 2h ago
quant-bot complete Phase 5/5 30/30 tasks 1d ago
Registry created at: .superpower-with-files/_registry/PLANS.md
When user invokes any /spf command:
🚀 **SUPERPOWER ACTIVE:** spf-plan-manager.superpower-with-files/_registry/PLANS.md