gpd-discuss-phase

Gathers phase research decisions through adaptive Socratic questioning before planning.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-discuss-phase-michaelsengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpd-discuss-phase
Source: https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics/tree/main/.agents/skills/gpd-discuss-phase
Command: npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-discuss-phase-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Research phases often start planning without clear methodological decisions, forcing downstream agents to guess or re-ask the user. This Skill captures physics and methodology decisions upfront in a CONTEXT.md file so researchers and planners can act without further clarification. ## Core Features & Use Cases - Gray Area Identification: Analyzes the phase from ROADMAP.md to surface phase-specific methodological ambiguities (formalism, approximations, boundary conditions, observables) rather than generic questions. - Socratic Dialogue: Conducts focused discussion loops that probe assumptions, question approximations, identify limiting cases, and surface anchors, with hard bounds on question rounds. - Structured CONTEXT.md Output: Writes decisions, physical assumptions, limiting behaviors, anchor registries, skeptical review items, and deferred ideas into a versioned phase file committed to git. - Use Case: Before planning a phase like "Compute Mott transition in Hubbard model", run this Skill to decide on impurity solver, cluster geometry, and transition identification criteria, producing a CONTEXT.md the planner consumes directly. ## Quick Start Ask the AI to run the gpd-discuss-phase skill for phase 2 to discuss methodological gray areas and generate the phase CONTEXT.md before planning.

Frequently Asked Questions about gpd-discuss-phase

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

FAQPage Schema
How do I capture research decisions before planning a phase?▼

Run the discuss-phase workflow with the phase number as an argument. It analyzes the phase from ROADMAP.md, presents methodological gray areas, discusses your selections through Socratic dialogue, and writes the decisions to a CONTEXT.md file.

What is a CONTEXT.md file in phase-based research planning?▼

CONTEXT.md documents methodological decisions, physical assumptions, limiting cases, anchor references, and deferred ideas for a phase. Downstream researcher and planner agents read it to know what to investigate and which choices are locked.

Does the discuss-phase skill require ROADMAP.md?▼

Yes. The phase boundary comes from ROADMAP.md and is treated as fixed. If the phase is not found in ROADMAP.md, the workflow exits and suggests checking available phases first.

How does the skill prevent scope creep during discussion?▼

It distinguishes clarifying methodology within the scoped phase from adding new research questions. Out-of-scope ideas are redirected and captured in a Deferred Ideas section of CONTEXT.md rather than acted on.

What happens if CONTEXT.md already exists for a phase?▼

The skill detects the existing file and asks once whether to update it, view it, or skip. Choosing update loads the existing context and continues the analysis; skip exits the workflow.

When should I not use a discussion phase before planning?▼

Skip discussion when the phase has no meaningful gray areas, such as pure data processing or straightforward textbook calculations. The analysis step includes a skip assessment for these cases.