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.