Files
msd-core/docs/features/post-execute-codebase-drift-detection.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

1.4 KiB

id, title, group, order
id title group order
27a Post-Execute Codebase Drift Detection Brownfield Features 27.2

Introduced by: #2003 Trigger: Runs automatically at the end of every /msd-execute-phase Configuration:

  • workflow.drift_threshold (integer, default 3) — minimum new structural elements before the gate acts.
  • workflow.drift_action (warn | auto-remap, default warn) — warn-only or spawn msd-codebase-mapper with --paths scoped to affected subtrees.

What counts as drift:

  • New directory outside mapped paths
  • New barrel export at (packages|apps)/*/src/index.*
  • New migration file (supabase/prisma/drizzle/src/migrations/…)
  • New route module under routes/ or api/

Non-blocking guarantee: any internal failure (missing STRUCTURE.md, git errors, mapper spawn failure) logs a single line and the phase continues. Drift detection cannot fail verification.

Requirements:

  • REQ-DRIFT-01: System MUST detect the four drift categories from git diff --name-status last_mapped_commit..HEAD
  • REQ-DRIFT-02: Action fires only when element count ≥ workflow.drift_threshold
  • REQ-DRIFT-03: warn action MUST NOT spawn any agent
  • REQ-DRIFT-04: auto-remap action MUST pass sanitized --paths to the mapper
  • REQ-DRIFT-05: Detection/remap failure MUST be non-blocking for /msd-execute-phase
  • REQ-DRIFT-06: last_mapped_commit round-trip through YAML frontmatter on each .planning/codebase/*.md file