gsd-headless

Orchestrate GSD project workflows via headless CLI commands with JSON events.

12|1|Updated May 29, 2026
One-click install
npx skills add https://github.com/qdzsh/gsd-revamp --skill gsd-headless-qdzsh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-headless
Source: https://github.com/qdzsh/gsd-revamp/tree/main/src/resources/extensions/gsd/skills/gsd-headless
Command: npx skills add https://github.com/qdzsh/gsd-revamp --skill gsd-headless-qdzsh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Orchestrate GSD projects programmatically from the command line, enabling agents to create milestones, execute workflows, monitor progress, and control execution without a graphical UI.

Core Features & Use Cases

  • Headless command execution: run milestones and tasks from scripts or orchestrator services.
  • Milestone lifecycle: create milestones from specs, auto-run phases (discuss → plan → execute → verify → summarize).
  • Status and telemetry: query state, stream JSON events, and inspect progress for external dashboards or automation.
  • Integration-friendly: supports flags like --json, --context, --auto, and batch/parallel workflows via references on orchestration patterns.
  • Use Case: automate end-to-end project coordination in CI/CD pipelines or multi-agent AI orchestration.

Quick Start

Run gsd headless to manage milestones and execute workflows from the command line.

Frequently Asked Questions about gsd-headless

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

FAQPage Schema
How do I automate project workflows and milestones from the command line without a GUI?

You can orchestrate project workflows and manage milestones headlessly via CLI to automate execution, monitor progress, and control development phases without a graphical UI. It enables agents and scripts to run end-to-end coordination deterministically.

How do I run planned development phases end-to-end in CI/CD pipelines?

Running planned development phases end-to-end in CI/CD pipelines is achieved by executing headless CLI commands with flags like --auto to drive the discuss, plan, execute, verify, and summarize lifecycle automatically.

Can I stream JSON events from CLI orchestration to external dashboards?

Yes, you can stream JSON events and query state from CLI orchestration to external dashboards. Using the --json and --events flags provides telemetry and instant status inspections for automation monitoring.

What is the best way to coordinate multiple workers in headless workflow orchestration?

The best way to coordinate multiple workers in headless workflow orchestration is using CLI references for batch and parallel patterns. It supports deterministic, reproducible automation by managing execution state and concurrent tasks without a GUI.

Does headless CLI orchestration support creating milestones from specs?

Headless CLI orchestration supports creating milestones directly from specs. It manages the entire milestone lifecycle, allowing agents to generate project phases from specification inputs and execute them programmatically.

What are the limitations of using CLI flags for deterministic workflow automation?

CLI flags like --context and --auto drive deterministic workflow automation, but require precise spec inputs and configuration. Limitations include dependency on correct command sequencing and managing state externally when coordinating parallel workers without GUI feedback.