skills.rest
gyuha
gyuhaCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

sg-start

Detect super-gsd workflow sessions and route to the next action.

2|Updated May 15, 2026
Search Tags:#project setup#workflow orchestration#slash commands#session resume#planning phase#handoff parsing#GSD loop
One-click install
npx skills add https://github.com/gyuha/super-gsd --skill sg-start
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sg-start
Source: https://github.com/gyuha/super-gsd/tree/main/.agents/skills/sg-start
Command: npx skills add https://github.com/gyuha/super-gsd --skill sg-start

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents fragile, manual handoffs between planning, implementation, and retrospection by detecting where your workflow currently is and routing you to the correct next action.

Core Features & Use Cases

  • Session detection and stage awareness: Reads .planning/STATE.md and parses the current Phase and Stage, plus the latest activity from .planning/HANDOFF.md to summarize progress.
  • Guided recovery options: When a session exists, presents a text-based choice to Resume, Start new milestone, or Cancel so users don’t lose context.
  • Delegation to the right next Skill: Starts new projects via gsd-new-project (when no session exists) or continues the cycle by handing off to the appropriate next milestone Skill.

Quick Start

Ask for workflow restart or continuation by saying: "Resume my current super-gsd session if it exists; otherwise start a new one."

Frequently Asked Questions about sg-start

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

FAQPage Schema
How do I resume a workflow session after stopping mid-project?▼

To resume a workflow session, this Skill detects an existing session by parsing STATE.md and HANDOFF.md, summarizes your last activity, and presents a 3-option choice to resume, start a new milestone, or cancel.

What is a GSD loop for project planning and implementation?▼

A GSD loop is a workflow cycle connecting planning, implementation, and retrospection. This Skill routes you to the correct next action within the Superpowers learning loop by detecting your current phase and stage.

How do I start a new project milestone when STATE.md is missing?▼

When STATE.md is missing or incomplete, this Skill delegates to gsd-new-project to initialize a new workflow, or to gsd-new-milestone to continue the cycle if a session is found.

Can I use slash commands for workflow orchestration without losing planning context?▼

Yes, workflow orchestration via slash commands preserves context by parsing HANDOFF.md read-only to summarize progress, ensuring manual handoffs between planning and implementation phases do not lose prior activity details.

What happens if my planning phase handoff file is incomplete?▼

If your planning handoff file is incomplete, the Skill still parses available data from STATE.md and HANDOFF.md to determine the current stage, presenting a guided text selection flow to recover or restart the milestone safely.

Does this session resume tool require any specific dependencies or APIs?▼

No dependencies are required for session resumption. The Skill uses a text-based 3-option selection flow and parses files read-only, deliberately avoiding tool-specific choice APIs to maintain a zero-dependency setup.

Related Skills

Explore More Software Engineering Skills→
deerawandeerawan
1

gsd-manager

Coordinate milestone phase planning and execution from a terminal dashboard.

Community
Advanced
abdullah1854abdullah1854
1

sub-agent-invocation

Route tasks to specialized sub-agents with context isolation for parallel work.

Community
Advanced
gyuhagyuha
2

sg-update

Install or update GSD and Claude Code plugins for the super-gsd workflow.

Community
Intermediate
gyuhagyuha
2

sg-status

Read planning files and output the next super-gsd command.

Community
Intermediate