Files
msd-core/docs/features/phase-execution.md
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

2.1 KiB

id, title, group
id title group
5 Phase Execution Core Features

Command: /msd-execute-phase <N>

Purpose: Execute all plans in a phase using wave-based parallelization with fresh context windows per executor.

Requirements:

  • REQ-EXEC-01: System MUST analyze plan dependencies and group into execution waves
  • REQ-EXEC-02: System MUST spawn independent plans in parallel within each wave
  • REQ-EXEC-03: System MUST give each executor a fresh context window (200K tokens)
  • REQ-EXEC-04: System MUST produce atomic git commits per task
  • REQ-EXEC-05: System MUST produce a SUMMARY.md for each completed plan
  • REQ-EXEC-06: System MUST run post-execution verifier to check phase goals were met
  • REQ-EXEC-07: System MUST support git branching strategies (none, phase, milestone)
  • REQ-EXEC-08: System MUST invoke node repair operator on task verification failure (when enabled)
  • REQ-EXEC-09: System MUST run prior phases' test suites before verification to catch cross-phase regressions

Produces:

Artifact Description
{phase}-{N}-SUMMARY.md Execution outcomes per plan
{phase}-VERIFICATION.md Post-execution verification report
Git commits Atomic commits per task

Wave Execution:

  • Plans with no dependencies → Wave 1 (parallel)
  • Plans depending on Wave 1 → Wave 2 (parallel, waits for Wave 1)
  • Continues until all plans complete
  • File conflicts force sequential execution within same wave

Executor Capabilities:

  • Reads PLAN.md with full task instructions
  • Has access to PROJECT.md, STATE.md, CONTEXT.md, RESEARCH.md
  • Commits each task atomically with structured commit messages
  • Uses --no-verify on commits during parallel execution to avoid build lock contention
  • Handles checkpoint types: auto, checkpoint:human-verify, checkpoint:decision, checkpoint:human-action
  • Reports deviations from plan in SUMMARY.md

Parallel Safety:

  • Pre-commit hooks: Skipped by parallel agents (--no-verify), run once by orchestrator after each wave
  • STATE.md locking: File-level lockfile prevents concurrent write corruption across agents