gpd-audit-milestone

Aggregate ROADMAP, REQUIREMENTS, STATE, and VERIFICATION files to audit milestone completion.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit milestone completion against original research goals by validating phase verifications, ROADMAP, REQUIREMENTS, STATE, and SUMMARY artifacts to ensure alignment.

Core Features & Use Cases

  • Aggregates ROADMAP.md, REQUIREMENTS.md, STATE.md, and VERIFICATION.md across completed phases to determine milestone scope and status.
  • Detects gaps, open questions, and deferred analyses; coordinates cross-phase consistency checks with a consistency checker.
  • Produces .gpd/v{version}-MILESTONE-AUDIT.md with a structured YAML header and a full markdown report for publication readiness.

Quick Start

Initiate the audit for the current milestone to generate a comprehensive .gpd/v{version}-MILESTONE-AUDIT.md report.

Frequently Asked Questions about gpd-audit-milestone

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

FAQPage Schema
How do I audit milestone completion against original research goals?

To audit milestone completion, you need to validate phase verifications against ROADMAP, REQUIREMENTS, STATE, and SUMMARY artifacts. This process detects gaps, open questions, and deferred analyses to ensure research alignment and readiness.

What is cross-phase consistency checking in research verification?

Cross-phase consistency checking assesses research coherence by evaluating notation stability, parameter usage, and narrative integrity across completed phases. It coordinates checks against ROADMAP and REQUIREMENTS to collect phase-level gaps.

How do I generate a milestone audit report with a YAML header?

Generating a milestone audit report involves aggregating VERIFICATION.md and STATE.md files across phases to produce a structured .gpd/v{version}-MILESTONE-AUDIT.md file. This report contains a YAML header and full markdown findings for publication readiness.

Can I use a consistency checker to assess cross-phase narrative integrity?

Yes, you can spawn a consistency-checking subagent to evaluate cross-phase coherence, notation stability, and parameter usage. This subagent works by aggregating ROADMAP.md and REQUIREMENTS.md to verify scope and readiness.

When do I need to verify milestone scope and readiness using ROADMAP and REQUIREMENTS files?

You need to verify milestone scope and readiness when completing research phases to ensure alignment with original goals. This involves aggregating ROADMAP.md, REQUIREMENTS.md, STATE.md, and VERIFICATION.md to detect deferred analyses and open questions.

What are the limitations of aggregating STATE.md and VERIFICATION.md for milestone audits?

The limitation of aggregating STATE.md and VERIFICATION.md is that it relies on the completeness of these artifacts to detect gaps and open questions. Without accurate phase-level documentation, the consistency checker cannot fully assess cross-phase coherence and narrative integrity.