create-sdd-project 0.18.4 → 0.20.0

package/template/.gemini/skills/pm-orchestrator/SKILL.md

@@ -87,8 +87,27 @@ For each feature in the batch:
 - **Lock**: If `docs/project_notes/pm-session.lock` is missing → stop (session was terminated externally).
 - **Circuit breaker**: If 3 consecutive features are `blocked` → stop and report to user.
 - **Context check**: If **2+ features have been completed** in this session, STOP and tell the user to run `/compact` followed by `continue pm`. Do NOT continue to the next feature — context degradation causes skipped steps, lost constraints, and poor quality. This is mandatory, not a suggestion.
+- **Session-coherence check (added v0.20.0)**: Read `.sdd-version` from the repo root and the `**SDD version at start:** X.Y.Z` field from `docs/project_notes/pm-session.md`. If they differ → emit ADVISORY (non-blocking) once per Step transition:
+  ```
+  ⚠ Session-coherence drift: SDD upgraded mid-session (X.Y.Z → CURRENT).
+  Cached workflow references and rules in this session may be stale.
+  Recommendation: complete current Step's atomic work, then run `/compact`
+  followed by `continue pm` to reload templates before next Step.
+  (Non-blocking — proceed if you've reviewed the upgrade CHANGELOG and
+  confirmed no workflow-affecting changes.)
+  ```
+  Do NOT auto-update the pm-session.md value here — capture the current cached-context coherence state. The field is auto-updated only by `continue pm` after `/compact` (see "Auto-update on /compact" below).
 - **Clean workspace**: Run `git status`. If dirty, commit or stash before proceeding.
 
+##### Auto-update on `/compact` (added v0.20.0)
+
+When `continue pm` resumes the orchestrator after a `/compact`:
+1. Re-read current `.sdd-version`.
+2. Update `**SDD version at start:** X.Y.Z` in `pm-session.md` to the current value.
+3. Reset the per-Step advisory-emitted flag.
+
+Rationale: `/compact` reloads the cached context from the filesystem. After /compact, the agent is operating on current SDD templates, so the `SDD version at start` field should reflect that. The drift advisory above targets the WINDOW between an SDD upgrade and the next /compact — that window is the risk zone.
+
 #### b. Start Feature
 
 1. Update `pm-session.md`:

package/template/.gemini/skills/pm-orchestrator/references/pm-session-template.md

@@ -5,6 +5,8 @@
 **Autonomy Level:** L5 (PM Autonomous)
 **Status:** in-progress
 **Target Branch:** {main|develop}
+**SDD version at start:** {sdd-version}  <!-- v0.20.0: session-coherence guard. Auto-updated by `/compact`. Do not edit manually. -->
+
 
 ## Current Batch