gh-awudevelop-claude-plugins-session/commands/plan-status.md

You are executing the /session:plan-status command to show plan execution status.

NOTE: Plans are now global and independent of sessions.

CRITICAL - Command Format: All session plugin commands use the /session: prefix. DO NOT suggest commands without this prefix.

• ✅ Correct: /session:plan-execute, /session:plan-status, /session:plan-finalize, /session:plan-list
• ❌ Wrong: /plan-execute, /plan-status, /plan-show, /plan-list Use ONLY the exact command formats specified in this template.

Arguments

Parsed from user input:

• plan_name: {name} (optional - if not provided, show status for all plans)

ARGUMENTS: {name}

Workflow

Step 1: Get Plan Status

Plans are stored globally in .claude/plans/ and can be accessed without an active session.

If plan_name is provided, get status for that specific plan:

node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js plan-status {plan_name}

If no plan_name, list all global plans first:

node ${CLAUDE_PLUGIN_ROOT}/cli/session-cli.js plan-list

Then get status for each plan.

Step 2: Display Status

For a specific plan:

📋 Plan Status: {plan_name}

Goal: {goal}
Work Type: {work_type}
Scope: Global (accessible from any session)
Created: {created_date}
Last Updated: {updated_date}

Overall Progress: {completed_tasks}/{total_tasks} tasks ({percentage}%)
├─ Completed: {completed}
├─ In progress: {in_progress}
├─ Pending: {pending}
└─ Blocked: {blocked}

Phase Progress: {completed_phases}/{total_phases}

Phases:
  1. [✓] {phase_1_name} (completed)
     ├─ Tasks: 5/5 (100%)
     └─ Duration: {duration}

  2. [→] {phase_2_name} (in-progress)
     ├─ Tasks: 2/7 (29%)
     ├─ Current Task: {current_task_id} - {description}
     └─ Status: {task_status}

  3. [ ] {phase_3_name} (pending)
     ├─ Tasks: 0/6 (0%)
     └─ Depends on: Phase 2

  4. [ ] {phase_4_name} (pending)
     ├─ Tasks: 0/4 (0%)
     └─ Depends on: Phase 2, Phase 3

Current Task: {current_task_id}
  Description: {description}
  Details: {details}
  Status: {status}
  Phase: {phase_name}

Next Steps:
  /session:plan-execute {plan_name} - Continue execution
  /update-task-status {task_id} completed - Mark current task complete

For all plans:

📋 All Global Plans

1. oauth-implementation (feature)
   ├─ Progress: 15/22 tasks (68%)
   ├─ Status: in-progress
   ├─ Current: Phase 2 - OAuth Flow Implementation
   └─ Last Updated: 2 hours ago

2. database-migration (refactor)
   ├─ Progress: 8/8 tasks (100%)
   ├─ Status: completed
   └─ Completed: 1 day ago

3. api-redesign (spike)
   ├─ Progress: 0/12 tasks (0%)
   ├─ Status: pending
   └─ Created: 3 days ago

Use /session:plan-status {plan_name} for detailed status.
Use /session:plan-execute {plan_name} to start/continue execution.
Use /session:plan-list to see all available plans.

Step 3: Show Recommendations

Based on plan status, show context-aware recommendations:

If plan is in-progress:

💡 Recommendations:
- Current task is {status} - {recommendation}
- {next_task_count} tasks remaining in current phase
- Estimated completion: {estimate}

If plan is blocked:

⚠️ Blocked:
- Task {task_id} is blocked
- Blocker: {blocker_reason}
- Action needed: {action}

If plan is completed:

✅ Plan Complete:
- All {total_tasks} tasks completed
- Duration: {total_duration}
- Consider: Code review, testing, deployment

---

Display Formats

Progress Bar

Progress: [████████████░░░░░░░░] 68% (15/22 tasks)

Status Icons

• [✓] Completed
• [→] In Progress
• Pending
• [✗] Failed
• [⊘] Blocked
• [~] Skipped

Phase Status

Phase 2: OAuth Flow Implementation (in-progress)
  ├─ task-2-1: Create OAuth callback routes [✓]
  ├─ task-2-2: Implement JWT generation [→]
  ├─ task-2-3: Add session middleware [ ]
  └─ task-2-4: Configure passport.js [ ]

---

Error Handling

• Plan not found: Show available plans using /session:plan-list
• Corrupted plan data: Show error with recovery steps
• No plans exist: Show message about creating first plan with /session:save-plan {name}