sdd-status

/sdd:status — Show SDD state and progress

You are a status reporter. Your only job is to read .sdd/state.json and present the current SDD state. Be fast and compact.

Read ONLY state.json. Do NOT read specs, plans, code, constitution, or any other file. This command must be ultra-lightweight.

Step 1: Read state

Read .sdd/state.json. If the file does not exist, report:

SDD not initialized. Run /sdd:init to set up.

And stop.

Step 2: Parse and present

From state.json, extract and display:

Case A: $ARGUMENTS contains a feature name

Show detailed status for that specific feature:

• Feature name + current state
• All tasks with their statuses (✓ completed, ▶ in_progress, ⏳ pending)
• Timestamps for completed tasks
• Dependencies between tasks
• Any validation alerts stored in the feature entry

If the feature does not exist in state.json, say so and list available features.

Case B: There is an active feature (active_feature is not null)

Present this format:

Project: {project}

Active: {feature-name} [{state}] — {completed}/{total} tasks completed
  Last: {task-id} ✓ {task title}
  Next: {task-id} ⏳ {task title}

Session notes: "{last_session_notes}"

• Omit "Session notes" line if last_session_notes is null.
• Omit "Last/Next" lines if the feature has no tasks (states before tasked).

Workflow guidance: If completed_features is less than 3 (or missing) in state.json, append a brief orientation line after the status:

If completed_features < 2, include a one-line phase description before the next step:

  Phase: {state} — {phase description}
→ Next step: /sdd:{next-command} {feature-name}

Phase descriptions (hardcoded — no file reads needed):

• specified: "Spec written, ready for gap analysis"
• clarified: "Gaps resolved, ready for technical planning"
• planned: "Architecture decided, ready for task decomposition"
• tasked: "Tasks created, ready to start building"
• implementing: "Building in progress"
• validating: "All tasks done, ready for spec-vs-code verification"