---
name: next-step
description: Show the next unchecked step in the active MASTER_PLAN
---

# /next-step Command

Display the next step to work on from the active phase. This is a **read-only** command — it does not modify any files.

## Behavior

### Step 1: Read Active Phase

Read `WORKFLOW_STATE.md` and find the `## Active Phase` section.

**If no active phase** (Phase is `idle` or section is missing):
> No active phase. Use `/promote` to activate a plan, or `/next-plan` to create one.

Then stop.

### Step 2: Parse the Plan

Extract the `Plan:` filename from the Active Phase section. Read that file from the project root.

Run the parse script:

```bash
bash "${CLAUDE_PLUGIN_ROOT}/scripts/parse-plan-steps.sh" "PLAN_FILE"
```

### Step 3: Find Next Unchecked Step

From the parsed output, find the first step with status `unchecked`.

**If all steps are checked:**
> All steps in [plan title] are complete! (DONE/TOTAL)
>
> Use `/archive` to archive this plan and reset the active phase.

Then stop.

### Step 4: Display the Step

Show the next step to work on:

```
Active Phase: [plan title]
Progress: DONE/TOTAL steps complete

Next step: **N. [Step title]**
```

Then read the plan file and display the full content of that step (the bullet points under the checkbox line, up to the next step or section header).

Suggest: "Use `/complete-step N` when this step is done."
