gpd-merge-phases

Merge research phase results and update ROADMAP.md and STATE.md.

Updated Mar 15, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-merge-phases-michaelsengineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gpd-merge-phases
Source: https://github.com/MichaelsEngineering/get-physics-done-test/tree/main/.agents/skills/gpd-merge-phases
Command: npx skills add https://github.com/MichaelsEngineering/get-physics-done-test --skill gpd-merge-phases-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Merge results from one research phase into another to consolidate research artifacts and decisions, keeping the project state coherent as phases evolve.

Core Features & Use Cases

  • Validate that both phases exist and are compatible.
  • Copy and renumber plans and summaries into the target phase.
  • Merge intermediate results and decisions, preserving provenance.
  • Update ROADMAP.md and STATE.md to reflect the merged phase.
  • Redirect dependencies so downstream work remains accurate.

Quick Start

Provide the source phase and the target phase numbers to merge and run the merge-phases workflow to absorb the source into the target.

Frequently Asked Questions about gpd-merge-phases

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

FAQPage Schema
How do I merge research phases without losing intermediate results?

You can merge research phases by validating phase compatibility, copying and renumbering plans into the target, and preserving intermediate results and decisions to keep project state coherent.

What is the best way to fold decimal research phases into their parent phase?

The best way to fold decimal phases is by merging the decimal source into its parent target, which updates ROADMAP.md and STATE.md while redirecting dependencies to keep downstream work accurate.

How does updating ROADMAP.md work when parallel investigations converge?

When parallel investigations converge, merging phases updates ROADMAP.md and STATE.md by validating the converging phases, absorbing the source into the target, and recording decisions via the GPD runtime CLI.

Do I need to validate phase compatibility before consolidating research artifacts?

Yes, validating that both phases exist and are compatible is required before consolidating research artifacts, ensuring the source phase can be safely absorbed into the target phase without breaking dependencies.

Why does merging research phases require redirecting dependencies in STATE.md?

Merging phases requires redirecting dependencies in STATE.md so downstream work remains accurate and references the newly consolidated target phase instead of the absorbed source phase.

Can I reorganize project phases by merging one phase into another?

Yes, you can reorganize project phases by merging a source phase into a target phase, which automatically renumbers plans, consolidates artifacts, and records the merge decisions via the GPD runtime CLI.