sg-phase

Synchronize GSD phase planning metadata across ROADMAP, STATE, and HANDOFF.

2|Updated May 15, 2026
One-click install
npx skills add https://github.com/gyuha/super-gsd --skill sg-phase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sg-phase
Source: https://github.com/gyuha/super-gsd/tree/main/skills/sg-phase
Command: npx skills add https://github.com/gyuha/super-gsd --skill sg-phase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents planning and state drift by letting you correct or finalize a specific phase so ROADMAP/STATE/HANDOFF stay consistent with what actually happened.

Core Features & Use Cases

  • Edit a phase (delegate to GSD): Modify an existing phase’s fields without breaking the established GSD CRUD flow.
  • Remove a future phase (delegate to GSD): Delete a future phase and let GSD handle renumbering safely.
  • Complete a phase (inline reconcile): Recompute Plans-complete from phase SUMMARY/PLAN files, mark Progress as Complete with today’s date, flip the Phases checkbox to done, and update STATE.md; optionally append a HANDOFF entry.

Quick Start

Use /super-gsd:sg-phase complete 36 to mark phase 36 as Complete and reconcile the planning metadata.

Frequently Asked Questions about sg-phase

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

FAQPage Schema
How do I keep project tracking metadata consistent when a planning phase drifts from finished work?

Phase management reconciliation corrects metadata drift by recomputing Plans-complete from phase SUMMARY/PLAN files, marking Progress as Complete with today's date, flipping the Phases checkbox, and updating STATE.md and ROADMAP consistently.

How do I edit an existing planning phase without breaking the workflow orchestration flow?

Editing an existing planning phase delegates field modifications to the established GSD CRUD flow, ensuring the phase fields update without breaking the underlying project tracking structure.

Can I safely remove a future phase and renumber the remaining phases in my roadmap?

Yes, removing a future phase delegates the deletion to GSD, which handles safe renumbering so your ROADMAP and STATE files remain consistent for project tracking.

What happens to HANDOFF files when completing a planning phase?

When completing a planning phase, inline reconciliation updates ROADMAP and STATE files, and optionally appends a HANDOFF entry to ensure workflow orchestration continuity across phase lifecycle corrections.

Do I need to manually update STATE.md after marking a GSD phase as complete?

No, inline reconciliation automatically updates STATE.md by flipping the Phases checkbox to done and recomputing Plans-complete, ensuring project tracking metadata stays consistent without manual edits.