Files

Jakub Zych a9a7a328e6 refactor: hard-fork GSD -> MSD (Make Software Done)

Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD
across contents and paths, upstream package/repo coordinates -> @golem15/msd-core
and golem15com/msd-core. Deep links into upstream history, sibling upstream
packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is.

Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line,
package/plugin identity, regenerated lockfile, install-tree fixtures, derived
registries and benchmark baseline; migration checksum baseline re-locked
(MSD keeps its own install state, so no install had applied the old sums);
sort-order and regex-escaped expectations in tests adjusted.

2026-10-06 01:47:40 +02:00

4.8 KiB

Raw Blame History

MSD Beta Features

Beta features are opt-in and may change or be removed without notice. They are not covered by the stable API guarantees that apply to the rest of MSD. If a beta feature ships to stable, it will be documented in COMMANDS.md and FEATURES.md with a changelog entry.

`/msd-ultraplan-phase` — Ultraplan Integration [BETA]

Claude Code only · Requires Claude Code v2.1.91+ Ultraplan is itself a Claude Code research preview — both this command and the underlying feature may change.

What it does

/msd-ultraplan-phase offloads MSD's plan-phase drafting to Claude Code's ultraplan cloud infrastructure. Instead of planning locally in the terminal, the plan is drafted in a browser-based session with:

An outline sidebar for navigating the plan structure
Inline comments for annotating and refining tasks
A persistent browser tab so your terminal stays free while the plan is being drafted

When you're satisfied with the draft, you save it and import it back into MSD — conflict detection, format validation, and plan-checker verification all run automatically.

Why use it

Situation	Recommendation
Long, complex phases where you want to read and comment on the plan before it executes	Use `/msd-ultraplan-phase`
Quick phases, familiar domain, or non-Claude Code runtimes	Use `/msd-plan-phase` (stable)
You have a plan from another source (teammate, external AI)	Use `/msd-import`

Requirements

Runtime: Claude Code only. The command exits with an error on Antigravity CLI, Copilot CLI, and other runtimes.
Version: Claude Code v2.1.91 or later (the $CLAUDE_CODE_VERSION env var must be set).
Cost: No extra charge for Pro and Max subscribers. Ultraplan is included at no additional cost.

Usage

/msd-ultraplan-phase         # Ultraplan the next unplanned phase
/msd-ultraplan-phase 2       # Ultraplan a specific phase number

Argument	Required	Description
`N`	No	Phase number (defaults to next unplanned phase)

How it works

Initialization — MSD runs the standard plan-phase init, resolving which phase to plan and confirming prerequisites.
Context assembly — MSD reads ROADMAP.md, REQUIREMENTS.md, and any existing RESEARCH.md for the phase. This context is bundled into a structured prompt so ultraplan has everything it needs without you copying anything manually.
Return-path instructions — Before launching ultraplan, MSD prints the import command to your terminal so it's visible in your scroll-back buffer after the browser session ends:
```
When done: /msd-import --from <path-to-saved-plan>
```
Ultraplan launches — The /ultraplan command hands off to the browser. Use the outline sidebar and inline comments to review and refine the draft.
Save the plan — When satisfied, click Cancel in Claude Code. Claude Code saves the plan to a local file and returns you to the terminal.
Import back into MSD — Run the import command that was printed in step 3:
```
/msd-import --from /path/to/saved-plan.md
```
This runs conflict detection against PROJECT.md, converts the plan to MSD format, validates it with msd-plan-checker, updates ROADMAP.md, and commits — the same path as any external plan import.

What gets produced

Step	Output
After ultraplan	External plan file (saved by Claude Code)
After `/msd-import`	`{phase}-{N}-PLAN.md` in `.planning/phases/`

What this command does NOT do

Write PLAN.md files directly — all writes go through /msd-import
Replace /msd-plan-phase — local planning is unaffected and remains the default
Run research agents — if you need RESEARCH.md first, run /msd-plan-phase --skip-verify or a research-only pass before using this command

Troubleshooting

"ultraplan is not available in this runtime" You're running MSD outside of Claude Code. Switch to a Claude Code terminal session, or use /msd-plan-phase instead.

Ultraplan browser session never opened Check your Claude Code version: claude --version. Requires v2.1.91+. Update with claude update.

/msd-import reports conflicts Ultraplan may have proposed something that contradicts a decision in PROJECT.md. The import step will prompt you to resolve each conflict before writing anything.

Plan checker fails after import The imported plan has structural issues. Review the checker output, edit the saved file to fix them, and re-run /msd-import --from <same-file>.

/msd-plan-phase — standard local planning (stable, all runtimes)
/msd-import — import any external plan file into MSD

4.8 KiB Raw Blame History