gsd-workstreams

Manage parallel workstreams via command-line tooling and JSON output.

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-workstreams-gesmith0606
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-workstreams
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/.claude/skills/gsd-workstreams
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill gsd-workstreams-gesmith0606

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manage multiple concurrent workstreams and their lifecycle without losing visibility or context, so teams can coordinate milestones, track progress, and switch focus quickly.

Core Features & Use Cases

  • List all workstreams with status, current phase, and progress for quick status checks across projects.
  • Create, switch, resume, complete, and archive named workstreams while setting the active workstream in the session environment.
  • Format JSON output from CLI tools into a human-readable table and suggest next routing steps; useful for product managers and engineering leads organizing parallel milestones.

Quick Start

Run /gsd:workstreams list to view all workstreams and their current phase and progress.

Frequently Asked Questions about gsd-workstreams

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

FAQPage Schema
How do I manage parallel workstreams for concurrent milestones?

Managing parallel workstreams involves listing, creating, and switching named workstreams via command-line tooling to track status and coordinate milestone tasks. It parses JSON output into readable tables and sets the active workstream in the session environment for quick focus switching.

Can I track project management status and progress across multiple workstreams?

Tracking project management status across workstreams is done by running a list command that displays all active workstreams with their current phase and progress. This provides quick visibility into concurrent milestones without losing context.

How do I create and switch between named workstreams using a CLI?

Creating and switching named workstreams uses CLI commands that set the GSD_WORKSTREAM environment variable for the active session. This ensures the correct workstream context is maintained when moving focus between different concurrent tasks.

What is the best way to archive completed workstreams in project management?

Archiving completed workstreams is handled automatically by moving them to a milestones directory upon completion. This keeps the active workstream list clean while preserving the history and context of finished project tasks.

Do I need specific command-line tools to coordinate workstream tasks?

You need command-line tools that invoke gsd-tools node commands to coordinate workstream tasks effectively. The Skill executes these invocations, parses the JSON output into human-readable tables, and suggests next routing steps for product managers and engineering leads.

Why does workstream management require parsing JSON output into tables?

Parsing JSON output into tables is required because CLI tools return raw structured data that is difficult to read quickly. Converting this output into human-readable tables provides immediate visibility into workstream status, phase, and progress for team coordination.