skills.rest
MichaelsEngineering
MichaelsEngineeringCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

gpd-new-project

Initialize physics research projects with scoping contracts, requirements, and roadmaps.

Updated Mar 18, 2026
Search Tags:#research#requirements#roadmap#physics#project initialization#gpd#scoping contract
One-click install
npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-new-project-michaelsengineering
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gpd-new-project
Source: https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics/tree/main/.agents/skills/gpd-new-project
Command: npx skills add https://github.com/MichaelsEngineering/sentinel-multiscale-field-dynamics --skill gpd-new-project-michaelsengineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a physics research project without clear scope, anchors, or decomposition leads to drift and false progress. This Skill turns a research idea or proposal document into a structured, version-controlled project with an approved scoping contract, requirements, roadmap, and state tracking. ## Core Features & Use Cases - Unified Initialization Flow: Runs questioning or structured intake, scoping contract approval, optional literature survey, requirements generation, and roadmap creation in one workflow. - Multiple Modes: Supports --auto mode driven by a proposal document, --minimal mode for fast bootstrapping from a file or a single answer, and a full deep-questioning path. - Machine-Readable Contract: Validates and persists a JSON project_contract in .gpd/state.json with observables, deliverables, acceptance tests, and references linked by stable IDs. - Use Case: A researcher with a proposal on 2D turbulence runs the Skill in auto mode, approves the synthesized scoping contract, and receives PROJECT.md, REQUIREMENTS.md, ROADMAP.md, and STATE.md committed to git, ready for phase planning. ## Quick Start Ask the AI to initialize a new physics research project from your proposal document using the gpd-new-project skill in auto mode.

Frequently Asked Questions about gpd-new-project

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

FAQPage Schema
How do I initialize a new physics research project from a proposal document?▼

Run the Skill with --auto and reference your proposal file, for example $gpd-new-project --auto @proposal.md. It synthesizes a scoping contract from the document, asks for one explicit approval, then generates requirements and a roadmap automatically.

What files does the GPD project initialization create?▼

It creates .gpd/PROJECT.md for research context, .gpd/config.json for workflow preferences, .gpd/REQUIREMENTS.md, .gpd/ROADMAP.md, .gpd/STATE.md, and a machine-readable project_contract in .gpd/state.json, all committed to git.

What is the difference between --auto and --minimal modes?▼

Auto mode requires a research document and runs research, requirements, and roadmap steps with smart defaults after one scope approval. Minimal mode uses one structured intake or a parsed file, skips the literature survey, and creates the same artifacts with lean content.

Can I resume an interrupted project initialization?▼

Yes. The workflow writes .gpd/init-progress.json after each step. On the next run it detects the previous attempt and offers to resume from the next step or start fresh, including handling corrupted progress files.

What happens if my scoping contract fails validation?▼

The contract is validated through the GPD CLI before being persisted. If validation fails, the errors are shown, the contract must be revised, and downstream artifact generation does not continue until validation passes.

Related Skills

Explore More Education & Research Skills→
jlawsjlaws
2

cmd-research-research

Identify research context and detect project artifacts and statistical tools.

Community
Advanced
ConsiliencyConsiliency
2

claude-phase-roadmap-builder

Generates multi-phase roadmap specs with dependency DAGs and interface-freeze gates for Claude Code.

Official
Advanced
methodic-researchmethodic-research
1

literature-review

Synthesizes internal experiment records and external publications into a cited literature review.

Official
Advanced
deerawandeerawan
1

gsd-new-milestone

Plan and initialize a new milestone cycle from PROJECT.md history.

Community
Intermediate