skills.rest
MichaelsEngineering
MichaelsEngineeringCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gpd-add-phase

Adds a sequential research phase to the current milestone in a GPD roadmap.

Updated Mar 18, 2026
Search Tags:#project management#cli#roadmap#milestone#research phase#gpd#physics research
One-click install
npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-add-phase-michaelsengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpd-add-phase
Source: https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics/tree/main/.agents/skills/gpd-add-phase
Command: npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-add-phase-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually extending a physics research roadmap requires calculating the next phase number, creating directories, and editing ROADMAP.md and STATE.md by hand, which is error-prone and breaks state synchronization. ## Core Features & Use Cases - Automatic Phase Numbering: Finds the highest existing integer phase and assigns the next sequential number, ignoring decimal phases. - Directory and Slug Generation: Creates .gpd/phases/{NN}-{slug}/ directories with slugs derived from the phase description. - Roadmap and State Sync: Inserts the phase entry into ROADMAP.md and records the decision in STATE.md and state.json via the GPD CLI. - Use Case: A physics researcher finishing a literature review phase wants to add a "Numerical implementation" phase to the current milestone without manually editing roadmap files. ## Quick Start Ask the AI to add a new research phase to the current milestone by providing a description such as "Derive renormalization group equations".

Frequently Asked Questions about gpd-add-phase

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

FAQPage Schema
How do I add a new phase to a GPD research roadmap?▼

Invoke the add-phase workflow with a phase description as the argument. The GPD CLI calculates the next integer phase number, creates the phase directory under .gpd/phases/, and inserts the entry into ROADMAP.md automatically.

How is the next phase number calculated in a roadmap?▼

The GPD CLI finds the highest existing integer phase number in the current milestone and assigns max plus one. Decimal phases are ignored during this calculation, so only whole-number phases are extended.

What happens if no roadmap exists when adding a phase?▼

The workflow checks the roadmap_exists flag during initialization. If .gpd/ROADMAP.md is missing, it stops with an error instructing you to run the new-project initialization command first.

Can I edit STATE.md directly after adding a phase?▼

No, STATE.md must not be edited directly. The workflow uses gpd state add-decision and state update commands so that STATE.md and state.json remain synchronized.

What are typical phases in a physics research project?▼

Typical phases include literature review, formalism development, analytical calculation, numerical implementation, validation, interpretation, and paper writing. Each phase represents a major stage tracked in the roadmap.

Related Skills

Explore More Education & Research Skills→
CharGrnmnCharGrnmn
1

gpd-add-phase

Add a new research phase to a GPD project roadmap.

Community
Intermediate
NikiforovAllNikiforovAll
137

structured-plan-mode

Decompose complex feature work into structured task-based plans.

Community
Basic
BeiBei-ClicBeiBei-Clic

gsd-milestone-summary

Generate a structured milestone summary report from planning artifacts.

Community
Intermediate
optiventoptivent

gsd-add-phase

Add a sequential phase to a project roadmap and update ROADMAP.md.

Community
Intermediate