transition

Validate phase completion and update ROADMAP.md, STATE.md, and PROJECT.md.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/NAinfini/Guild_Management --skill transition
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: transition
Source: https://github.com/NAinfini/Guild_Management/tree/main/.kilocode/skills/transition
Command: npx skills add https://github.com/NAinfini/Guild_Management --skill transition

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates marking the current project phase complete and advancing to the next, ensuring progress is tracked and artifacts are updated consistently.

Core Features & Use Cases

  • Phase completion validation: checks that all current-phase plans are finished and ready to advance.
  • Roadmap and state synchronization: updates ROADMAP.md, STATE.md, and PROJECT.md to reflect progress and learnings.
  • Project evolution: records decisions and context to inform the next phase's planning and focus.

Quick Start

Run the transition workflow to mark the current phase complete, verify outcomes, and advance to the next phase. The workflow will update STATE.md, PROJECT.md, and ROADMAP.md as part of the operation.

Frequently Asked Questions about transition

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

FAQPage Schema
How do I automate project phase transitions and update PROJECT.md?

To automate phase transitions, this Skill validates current plan completion and advances to the next phase while updating PROJECT.md, ROADMAP.md, and STATE.md automatically. It ensures progress is tracked consistently without manual file edits.

What happens if I try to advance project phases with incomplete work?

When advancing project phases with incomplete work, the Skill triggers safety prompts to warn you about unresolved tasks. It validates plan completion before marking the current phase complete, preventing inconsistent state updates to PROJECT.md and ROADMAP.md.

Do I need phase files under .gsd to run the transition workflow?

Yes, the transition workflow requires access to the repository's phase files under the .gsd directory and a SKILL.md frontmatter with a name and description. These prerequisites ensure the Skill can validate plans and synchronize state correctly.

How does phase completion validation work for project management?

Phase completion validation checks that all current-phase plans are finished and ready to advance before updating project artifacts. The mechanism verifies outcomes and records decisions to inform the next phase's planning and focus.

Can I synchronize ROADMAP.md and STATE.md when advancing to the next phase?

Yes, you can synchronize ROADMAP.md and STATE.md automatically when advancing to the next phase. The transition workflow updates both files along with PROJECT.md to reflect progress, learnings, and evolving project context.