sdd-forge.flow-status

Query and present live SDD flow state with branches, worktree, steps, and commits.

2|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/SpreadWorks/sdd-forge --skill sdd-forge-flow-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-forge.flow-status
Source: https://github.com/SpreadWorks/sdd-forge/tree/main/src/templates/skills/sdd-forge.flow-status
Command: npx skills add https://github.com/SpreadWorks/sdd-forge --skill sdd-forge-flow-status

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The SDD Flow Status skill provides a realtime snapshot of the active SDD workflow, aggregating branch info, worktree state, step progress, requirements, and commit status to help you quickly understand where you stand in the flow.

Core Features & Use Cases

  • Shows current mode (Worktree, Branch, or Spec only) and the feature/base branches.
  • Displays step progress and requirements using the latest flow status, with the ability to read the involved spec for context.
  • Helps teams monitor progress, identify blockers, and verify that local changes are in sync with the active flow.

Quick Start

Run the command to display the current SDD flow status and resolve-context details for your active flow.

Frequently Asked Questions about sdd-forge.flow-status

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check the current SDD workflow status and active branches?

SDD flow status provides a realtime snapshot of your active workflow, aggregating branch info, worktree state, step progress, requirements, and commit status. It reads flow get status and resolve-context data to reveal your current mode and uncommitted changes.

What does spec-driven development flow status include in the progress summary?

Flow status uses the sdd-forge flow get status and flow get resolve-context commands as its data sources. It reads this data to present the current mode, branch details, spec location, and uncommitted changes in a readable summary format.

Can I view SDD worktree and branch state without modifying my repository files?

Yes, viewing flow status is completely read-only. The query reads data from flow get status and resolve-context commands and extracts spec titles and goals without modifying any files, ensuring your repository state remains untouched.

How do I identify which SDD flow mode and base branch my ongoing work is using?

The status query reveals the current flow mode, showing whether you are in Worktree, Branch, or Spec only mode. It also identifies the active feature and base branches associated with your ongoing work for quick verification.

Does the SDD flow status display uncommitted changes and spec location details?

Yes, the status output includes uncommitted changes and the spec location. By reading the resolve-context data, it shows uncommitted changes alongside the spec location to help you verify local changes are in sync with the active flow.