gpd-graph

Analyze phase dependency graphs from ROADMAP.md and SUMMARY.md frontmatter.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Visualizes and validates dependency graphs across research phases to reveal how results flow, where needs are unmet, and where assumptions may block progress.

Core Features & Use Cases

  • Build a phase-level dependency graph from ROADMAP.md and SUMMARY.md frontmatter.
  • Detect provides/requires gaps, missing phases, and circular dependencies.
  • Generate Mermaid diagrams to communicate roadmap status and critical paths in research projects.

Quick Start

Run the gpd-graph skill to generate and review the dependency graph for your project.

Frequently Asked Questions about gpd-graph

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

FAQPage Schema
How do I visualize phase dependencies in a research roadmap using Mermaid?

Visualize phase dependencies by parsing ROADMAP.md and SUMMARY.md frontmatter to build a dependency graph and generate Mermaid diagrams. This reveals research flow, detects unmet requirements, and identifies critical paths across project phases.

How do I detect circular dependencies and missing phases in a project roadmap?

Detect circular dependencies and missing phases by analyzing the dependency graph built from ROADMAP.md frontmatter. The analysis validates roadmap consistency by mapping provides, requires, and affects relationships across all defined research phases.

Can I generate a Mermaid diagram directly from SUMMARY.md and ROADMAP.md frontmatter?

Yes, generate Mermaid diagrams directly from SUMMARY.md and ROADMAP.md frontmatter. The system parses provides, requires, and affects fields to construct the graph and output visual diagrams showing roadmap status and critical paths.

What is the best way to identify unmet requirements in a research workflow dependency graph?

The best way to identify unmet requirements is through gap detection on the phase dependency graph. By cross-referencing provides and requires fields in frontmatter, the analysis pinpoints where needs are unmet and where assumptions may block progress.

Does this dependency graph visualization work without specific frontmatter fields in my markdown files?

No, this dependency graph visualization requires phase-based ROADMAP.md and SUMMARY.md files with structured frontmatter. Without provides, requires, and affects fields, the tool cannot construct the graph or perform gap detection.