gsd-next

Advance multi-phase GSD workflows by detecting state and invoking the next step.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Poom5741/eggo-world-pb --skill gsd-next-poom5741
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-next
Source: https://github.com/Poom5741/eggo-world-pb/tree/main/.qwen/skills/gsd-next
Command: npx skills add https://github.com/Poom5741/eggo-world-pb --skill gsd-next-poom5741

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically detect the current state of a multi-phase GSD workflow and advance to the next logical step, reducing manual tracking overhead and ensuring consistent sequencing.

Core Features & Use Cases

  • Automated next-step routing: reads STATE.md, ROADMAP.md, and phase directories to determine the upcoming step.
  • Safety gates and force option: supports --force to bypass checks when explicit override is needed, with structured reporting of gaps.
  • Gap analysis and decision points: surfaces incomplete work from prior phases and offers defer, stop, or force-advance choices.

Quick Start

Run the gsd-next tool to automatically advance to the next logical GSD workflow step.

Frequently Asked Questions about gsd-next

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

FAQPage Schema
How do I automate advancing a multi-phase project workflow to the next step?

To automate workflow advancement, use gsd-next to detect the current project state by analyzing STATE.md, ROADMAP.md, and phase folders, then invoke the next logical step. It enforces deterministic routing and structured reporting to reduce manual tracking overhead.

What happens if prior workflow phases have incomplete work or gaps?

When prior phases have incomplete work, the workflow automation performs gap analysis and surfaces those gaps. It presents structured options to defer, stop, or force-advance, ensuring you make an informed decision before moving to the next phase.

Can I force a multi-phase workflow to advance even when safety checks fail?

Yes, you can force a workflow to advance by using the --force option. This bypasses safety gates when an explicit override is needed, provided it is safe, while still reporting any existing gaps in the structured output.

Do I need specific files to automate project management state routing?

Yes, automated state routing requires projects to maintain a STATE.md file, a ROADMAP.md file, and organized phase directories. The tool reads these specific files to determine the current state and identify the upcoming logical step.

Why use deterministic routing for multi-phase project orchestration?

Deterministic routing ensures consistent sequencing across multi-phase workflows by preventing out-of-order execution. It enforces safety gates and analyzes prior phases, reducing manual tracking errors and guaranteeing the project advances logically.