gsd-next

Advance to the next GSD workflow step by reading STATE.md, ROADMAP.md, and phase directories.

Updated Jan 28, 2025
One-click install
npx skills add https://github.com/aslaii/dotfiles --skill gsd-next-aslaii
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-next
Source: https://github.com/aslaii/dotfiles/tree/main/claude/skills/gsd-next
Command: npx skills add https://github.com/aslaii/dotfiles --skill gsd-next-aslaii

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects the current project state and automatically moves to the next logical GSD workflow step, reducing manual tracking overhead.

Core Features & Use Cases

  • Reads STATE.md, ROADMAP.md, and phase directories to determine the next step.
  • Supports the --force flag to bypass safety gates when necessary.
  • Provides a structured report of incomplete work across prior phases and offers options to defer, resolve, or force-advance.

Quick Start

Execute the gsd-next skill to automatically advance to the next workflow step by inspecting STATE.md, ROADMAP.md, and phase directories.

Frequently Asked Questions about gsd-next

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

FAQPage Schema
How do I automatically advance to the next workflow step in a multi-project setup?

To automatically advance the workflow step, this skill reads STATE.md, ROADMAP.md, and phase directories to determine the next logical phase. It detects the current project state and moves to the next step, reducing manual tracking overhead across multiple projects.

What is the best way to track incomplete work across prior phases before advancing?

The best way to track incomplete work before advancing is to run the skill, which provides a structured report of incomplete work across prior phases. You can then choose to defer, resolve, or force-advance based on the report.

Do I need STATE.md and ROADMAP.md files to use automated phase management?

Yes, STATE.md and ROADMAP.md are required files for automated phase management. The skill needs access to these files and awareness of phase directories to determine the current project state and orchestrate cross-project advancement.

Can I bypass safety gates when moving to the next project state?

Yes, you can bypass safety gates when moving to the next project state by using the --force flag. This allows you to force-advance the workflow while still receiving a structured report of any incomplete work.

Why does automated workflow advancement stop and report incomplete work?

Automated workflow advancement stops and reports incomplete work because it operates with safety gates to prevent losing track of unfinished tasks. It detects incomplete work across prior phases and halts to offer options to defer, resolve, or force-advance.