OpenParable
Skip to content
← Back to skills

gsd:workstreams

Productivity

gsd:workstreams is an Agent Skill for productivity published in the davepoon/buildwithclaude repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Manage parallel workstreams — list, create, switch, status, progress, complete, and resume

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/davepoon/buildwithclaude/blob/HEAD/plugins/gsd/skills/workstreams/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/gsd-workstreams, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

/gsd:workstreams

Manage parallel workstreams for concurrent milestone work.

Usage

/gsd:workstreams [subcommand] [args]

Subcommands

CommandDescription
listList all workstreams with status
create <name>Create a new workstream
status <name>Detailed status for one workstream
switch <name>Set active workstream
progressProgress summary across all workstreams
complete <name>Archive a completed workstream
resume <name>Resume work in a workstream

Step 1: Parse Subcommand

Parse the user's input to determine which workstream operation to perform. If no subcommand given, default to list.

Step 2: Execute Operation

list

Run: gsd-sdk query workstream.list --raw --cwd "$CWD" Display the workstreams in a table format showing name, status, current phase, and progress.

create

Run: gsd-sdk query workstream.create <name> --raw --cwd "$CWD" After creation, display the new workstream path and suggest next steps:

  • /gsd:new-milestone --ws <name> to set up the milestone

status

Run: gsd-sdk query workstream.status <name> --raw --cwd "$CWD" Display detailed phase breakdown and state information.

switch

Run: gsd-sdk query workstream.set <name> --raw --cwd "$CWD" Also set GSD_WORKSTREAM for the current session when the runtime supports it. If the runtime exposes a session identifier, GSD also stores the active workstream session-locally so concurrent sessions do not overwrite each other.

progress

Run: gsd-sdk query workstream.progress --raw --cwd "$CWD" Display a progress overview across all workstreams.

complete

Run: gsd-sdk query workstream.complete <name> --raw --cwd "$CWD" Archive the workstream to milestones/.

resume

Set the workstream as active and suggest /gsd:resume-work --ws <name>.

Step 3: Display Results

Format the JSON output from gsd-sdk query into a human-readable display. Include the ${GSD_WS} flag in any routing suggestions.