Skip to content
specdacular

/specd.status

Display a task status dashboard showing all in-progress tasks, their stage, plan progress, and recommended next action.

/specd.status [--all]

What it does

Section titled “What it does”

/specd.status reads every task in .specd/tasks/ and renders a table with:

  • Stage — Current position in the lifecycle (discussion, research, planning, execution)
  • Plans — Completed vs. total phase count (e.g. 2/5)
  • Created — When the task was initialized
  • Next Action — The recommended next step extracted from STATE.md

By default, completed tasks are hidden. Use --all to include them in a separate section.

Arguments

Section titled “Arguments”
ArgumentRequiredDescription
--allNoInclude completed tasks in a separate section at the bottom

Example output

Section titled “Example output”
# Task Status


_3 features, 2 in progress_


| Feature        | Stage     | Plans | Created    | Next Action              |
|----------------|-----------|-------|------------|--------------------------|
| user-dashboard | execution | 2/5   | 2025-01-10 | Execute phase 3          |
| payment-flow   | planning  | —     | 2025-01-14 | Create roadmap           |

With --all:

### Completed


| Feature   | Plans | Completed  |
|-----------|-------|------------|
| user-auth | 4/4   | 2025-01-08 |

Stages

Section titled “Stages”
StageMeaning
discussionInitial requirements gathering
researchParallel agents investigating patterns/pitfalls
planningCreating ROADMAP.md with phase goals
executionPhase-by-phase implementation loop
completeAll phases executed and reviewed

Orchestrator mode

Section titled “Orchestrator mode”

In a monorepo with orchestrator mode, the dashboard shows a tree view with sub-project rows indented under their parent feature:

# Task Status


_2 features, 2 in progress — orchestrator mode_


| Feature          | Stage     | Plans | Created    | Next Action     |
|------------------|-----------|-------|------------|-----------------|
| auth-system      | execution | 3/6   | 2025-01-10 | Execute phase 2 |
|  └ api           | execution | 2/3   |            | Execute phase 2 |
|  └ web           | planning  | —     |            | Create roadmap  |

No output

Section titled “No output”

If no tasks exist yet:

No tasks found. Start one with `/specd.new [name]`.
Section titled “Related commands”