gpd-plan-phase

Creates verified execution plans for research phases with integrated literature research and revision loops.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a research phase goal into a rigorous, executable plan requires coordinating literature research, experiment design, and verification — a process that is error-prone and inconsistent when done ad hoc. This Skill orchestrates that entire planning workflow for Get Physics Done (GPD) research projects. ## Core Features & Use Cases - Orchestrated planning pipeline: Runs Research -> Plan -> Verify with a revision loop (max 3 iterations) using gpd-phase-researcher, gpd-planner, and gpd-plan-checker agents. - Research mode awareness: Supports explore, balanced, exploit, and adaptive research modes that control literature depth and reuse of existing RESEARCH.md artifacts. - Physics planning rigor: Enforces mathematical rigor checkpoints, limiting-case validation, error budgets, anchor discipline, and contract completeness in every PLAN.md. - Use Case: Given an approved project contract and roadmap, run the planner for Phase 2 of a fusion turbulence study to produce a verified PLAN.md with tasks, acceptance tests, and references. ## Quick Start Ask the agent to plan phase 2 of the current GPD project, for example by requesting: create the execution plan for phase 2 with research enabled.

Frequently Asked Questions about gpd-plan-phase

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

FAQPage Schema
How do I create a phase plan in a GPD research project?▼

Invoke the gpd-plan-phase skill with a phase number, for example with arguments like "2 --research". It initializes context from .gpd state, optionally runs research, spawns the planner agent, and verifies the result with a plan-checker loop.

What research modes does GPD phase planning support?▼

Four modes: explore (comprehensive re-research), balanced (default, reuses fresh research), exploit (minimal method-specific research), and adaptive (broad until an approach is locked by prior decisive evidence). Modes control literature depth and experiment design behavior.

What files are required before running gpd-plan-phase?▼

The skill requires .gpd/ROADMAP.md and .gpd/STATE.md, plus an approved project contract in .gpd/state.json. If the contract is missing or underspecified, planning stops and checkpoints with the user instead of inferring scope.

Can I skip the research step when planning a phase?▼

Yes. Use the --skip-research flag or --gaps flag to bypass research, or --light to skip experiment design. The planner then works from existing CONTEXT.md and state files without new literature review.

What happens if the plan checker rejects the generated plan?▼

The skill enters a revision loop with the gpd-plan-checker, iterating up to 3 times until the plan passes verification. If it still fails, the issues are presented to the user rather than silently proceeding.