gpd-compare-branches

Compare hypothesis branches in a GPD workflow using STATE.md, SUMMARY.md, and VERIFICATION.md.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps researchers and engineers quickly identify how different hypothesis branches compare by automatically aggregating results from branch data (STATE.md, SUMMARY.md, VERIFICATION.md) into a unified cross-branch view, highlighting gaps and tensions to accelerate decision-making.

Core Features & Use Cases

  • Builds a structured branch comparison from STATE.md, SUMMARY.md, and VERIFICATION.md across all hypothesis branches.
  • Extracts key results, verification status, and context usage to provide a holistic view of progress and alignment.
  • Flags potential disagreements with computed tensions and exports a formal BRANCH-COMPARISON report to guide merging or pruning.

Quick Start

Run the compare-branches workflow to generate a branch-by-branch report that highlights key results, verification status, and potential tensions across hypothesis branches.

Frequently Asked Questions about gpd-compare-branches

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

FAQPage Schema
How do I compare results across hypothesis branches in a GPD workflow?

To compare results across hypothesis branches in a GPD workflow, this Skill extracts and synthesizes data from STATE.md, SUMMARY.md, and VERIFICATION.md to build a structured side-by-side comparison. It highlights gaps and flags potential tensions to accelerate your decision-making.

What is the best way to decide which hypothesis branch to merge or prune?

The best way to decide which hypothesis branch to merge or prune is to generate a formal BRANCH-COMPARISON report. This report aggregates verification status and context usage across branches, computing numerical differences to guide your pruning or merging decisions.

Can I automatically extract verification status and context usage from markdown files?

Yes, you can automatically extract verification status and context usage from markdown files. The Skill aggregates key results from STATE.md, SUMMARY.md, and VERIFICATION.md across all branches to provide a holistic view of progress and alignment.

How do I identify tensions or disagreements across multiple research branches?

To identify tensions or disagreements across multiple research branches, the Skill computes numerical differences and flags potential conflicts during the cross-branch comparison. It extracts data from your verification files to highlight misalignments automatically.

Do I need specific markdown files to perform a branch comparison?

Yes, you need specific markdown files to perform a branch comparison. The Skill requires STATE.md, SUMMARY.md, and VERIFICATION.md files to exist within your hypothesis branches to extract the necessary data for its structured cross-branch analysis.

When should I export a formal branch comparison report?

You should export a formal branch comparison report when you need to document the decision to merge or prune hypothesis branches. The exported report captures the structured comparison, key results, and computed tensions for future reference.