projecta-rrr 1.16.8 → 1.16.9

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to RRR will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [1.16.9] - 2026-01-28
+
+### Fixed
+
+- **SUMMARY Path Derivation Bug** - During parallel wave execution, SUMMARY files were incorrectly written to the wrong phase directory because `PHASE_DIR` was derived from where the PLAN file physically existed rather than from the PLAN's `phase:` frontmatter value. Now uses `find_phase_dir()` with phase frontmatter to ensure SUMMARYs always go to the correct phase folder.
+
 ## [1.16.8] - 2026-01-28
 
 ### Added

package/agents/rrr-executor.md

@@ -601,10 +601,25 @@ Track for SUMMARY.md generation.
 <summary_creation>
 After all tasks complete, create `{phase}-{plan}-SUMMARY.md`.
 
-**Location:** `{phase-dir}/{phase}-{plan}-SUMMARY.md`
+**Location calculation (milestone-aware):**
+
+```bash
+# Extract phase from PLAN frontmatter (NOT from file location)
+PLAN_PATH="$phase_dir/$phase-$plan-PLAN.md"
+PHASE_VALUE=$(grep -E "^phase:" "$PLAN_PATH" | sed 's/phase: *"\?//' | tr -d '"')
+
+# Use find_phase_dir to get the correct phase directory
+# Searches .planning/milestones/vX.X/phases/ first, then falls back to .planning/phases/
+PHASE_DIR=$(find_phase_dir "$PHASE_VALUE")
+
+# Build SUMMARY path
+SUMMARY_FILE="${PHASE_DIR}/${phase}-${plan}-SUMMARY.md"
+```
 
 **Phase directory:** `.planning/milestones/v{X.Y}/phases/{phase-number}-{name}/` (milestone-aware structure since v1.11)
 
+The SUMMARY goes to the phase directory matching the PLAN's `phase:` frontmatter value, not where the PLAN file physically exists. This ensures consistent behavior during parallel execution.
+
 **Use template from:** @~/.claude/rrr/templates/summary.md
 
 **Frontmatter population:**
@@ -717,7 +732,7 @@ After SUMMARY.md and STATE.md updates:
 **1. Stage execution artifacts:**
 
 ```bash
-git add "{phase-dir}/{phase}-{plan}-SUMMARY.md"
+git add "${PHASE_DIR}/${phase}-${plan}-SUMMARY.md"
 git add .planning/STATE.md
 ```
 
@@ -730,7 +745,7 @@ Tasks completed: [N]/[N]
 - [Task 1 name]
 - [Task 2 name]
 
-SUMMARY: {phase-dir}/{phase}-{plan}-SUMMARY.md
+SUMMARY: ${PHASE_DIR}/${phase}-${plan}-SUMMARY.md
 "
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projecta-rrr",
-  "version": "1.16.8",
+  "version": "1.16.9",
   "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code by Projecta.ai",
   "bin": {
     "projecta-rrr": "bin/install.js"

package/rrr/workflows/execute-plan.md

@@ -1498,9 +1498,17 @@ Set `USER_SETUP_CREATED=true` if file was generated, for use in completion messa
 **1. Calculate expected SUMMARY path:**
 
 ```bash
-# Calculate expected SUMMARY path
+# Calculate expected SUMMARY path using phase frontmatter (not file location)
+# This ensures SUMMARY goes to correct phase directory during parallel execution
 PLAN_FILE="${PLAN_PATH}"  # e.g., .planning/milestones/v1.16/phases/17-e2e-scaffold-detection/17-03-PLAN.md
-PHASE_DIR=$(dirname "$PLAN_FILE")
+
+# Extract phase from PLAN frontmatter - NOT from file location
+PHASE_VALUE=$(grep -E "^phase:" "$PLAN_FILE" | sed 's/phase: *"\?//' | tr -d '"')
+
+# Use find_phase_dir to get correct phase directory (milestone-aware)
+# Searches .planning/milestones/vX.X/phases/ first, then falls back to .planning/phases/
+PHASE_DIR=$(find_phase_dir "$PHASE_VALUE")
+
 PLAN_ID=$(basename "$PLAN_FILE" | sed 's/-PLAN\.md$//')
 SUMMARY_FILE="${PHASE_DIR}/${PLAN_ID}-SUMMARY.md"
 ```
@@ -1554,7 +1562,7 @@ If user chooses "Cancel completion":
 Create `{phase}-{plan}-SUMMARY.md` as specified in the prompt's `<output>` section.
 Use ~/.claude/rrr/templates/summary.md for structure.
 
-**File location:** `{phase_dir}/{phase}-{plan}-SUMMARY.md`
+**File location:** `${PHASE_DIR}/${phase}-${plan}-SUMMARY.md` (derived from PLAN frontmatter via `find_phase_dir`)
 
 **Frontmatter population:**
 
@@ -1770,7 +1778,7 @@ PLAN.md was already committed during plan-phase. This final commit captures exec
 **1. Stage execution artifacts:**
 
 ```bash
-git add {phase_dir}/{phase}-{plan}-SUMMARY.md
+git add "${PHASE_DIR}/${phase}-${plan}-SUMMARY.md"
 git add .planning/STATE.md
 ```
 
@@ -1798,7 +1806,7 @@ Tasks completed: [N]/[N]
 - [Task 2 name]
 - [Task 3 name]
 
-SUMMARY: {phase_dir}/{phase}-{plan}-SUMMARY.md
+SUMMARY: ${PHASE_DIR}/${phase}-${plan}-SUMMARY.md
 EOF
 )"
 ```