fix: address Copilot review feedback on PR #1205

- Move step 6 before WORKFLOW COMPLETE marker (fixes workflow structure)
- Change PRD shortcut from PR to PD (avoids conflict with parallel-research)
- Clarify instructions for reading/updating VS Code settings
- Update phase 4 comment to match actual handoff flow

src/modules/bmm/workflows/3-solutioning/check-implementation-readiness/steps/step-06-final-assessment.md

@@ -110,22 +110,20 @@ Report generated: {outputFile}
 
 The assessment found [number] issues requiring attention. Review the detailed report for specific findings and recommendations."
 
-## WORKFLOW COMPLETE
-
-The implementation readiness workflow is now complete. The report contains all findings and recommendations for the user to consider.
-
 ### 6. Update IDE Prompt Recommendations
 
-If the readiness status is **READY**, update `.vscode/settings.json` to prioritize the implementation cycle prompts:
+If the readiness status is **READY**, update `.vscode/settings.json` to prioritize the implementation cycle prompts.
 
-**Set these prompts to `true` (implementation cycle - "keep going" loop):**
+Read the existing `chat.promptFilesRecommendations` object and modify these keys:
+
+**Set to `true` (implementation cycle - "keep going" loop):**
 - `bmd-create-story`
 - `bmd-dev-story`
 - `bmd-code-review`
 - `bmd-retrospective`
 - `bmd-correct-course`
 
-**Set these prompts to `false` (setup phase - already completed):**
+**Set to `false` (setup phase - already completed):**
 - `bmd-workflow-init`
 - `bmd-brainstorm`
 - `bmd-prd`
@@ -135,7 +133,9 @@ If the readiness status is **READY**, update `.vscode/settings.json` to prioriti
 - `bmd-implementation-readiness`
 - `bmd-sprint-planning`
 
-Update the `chat.promptFilesRecommendations` object in `.vscode/settings.json` with these values.
+## WORKFLOW COMPLETE
+
+The implementation readiness workflow is now complete. The report contains all findings and recommendations for the user to consider.
 
 ---
 

src/modules/bmm/workflows/4-implementation/sprint-planning/instructions.md

@@ -180,16 +180,16 @@ development_status:
 </step>
 
 <step n="6" goal="Update IDE prompt recommendations for implementation phase">
-<action>Update `.vscode/settings.json` to prioritize the implementation cycle prompts.</action>
+<action>Read the existing `.vscode/settings.json` and update the `chat.promptFilesRecommendations` object.</action>
 
-**Set these prompts to `true` (implementation cycle - "keep going" loop):**
+**Set to `true` (implementation cycle - "keep going" loop):**
 - `bmd-create-story`
 - `bmd-dev-story`
 - `bmd-code-review`
 - `bmd-retrospective`
 - `bmd-correct-course`
 
-**Set these prompts to `false` (setup phase - already completed):**
+**Set to `false` (setup phase - already completed):**
 - `bmd-workflow-init`
 - `bmd-brainstorm`
 - `bmd-prd`
@@ -199,15 +199,13 @@ development_status:
 - `bmd-implementation-readiness`
 - `bmd-sprint-planning`
 
-<action>Update the `chat.promptFilesRecommendations` object in `.vscode/settings.json` with these values.</action>
-
 <action>Inform {user_name}:</action>
 
 **IDE Updated for Implementation Phase**
 
 The "keep going" cycle prompts are now prioritized in VS Code:
-- **New chat → @bmd-custom-bmm-sm → *create-story** (prepare a story)
-- **New chat → @bmd-custom-bmm-dev → *dev-story** (implement it)
+- **@bmd-custom-bmm-sm → *create-story** (prepare a story)
+- **@bmd-custom-bmm-dev → *dev-story** (implement it)
 - **Same chat → *code-review** (review the code)
 - **Repeat!**
 

tools/cli/installers/lib/ide/shared/workflow-prompts-config.js

@@ -44,8 +44,8 @@ const workflowPromptsConfig = {
     {
       name: 'prd',
       agent: 'bmd-custom-bmm-pm',
-      shortcut: 'PR',
-      description: '[PR] Create Product Requirements Document (PRD)',
+      shortcut: 'PD',
+      description: '[PD] Create Product Requirements Document (PRD)',
       prompt: '*prd',
     },
     {
@@ -90,7 +90,7 @@ const workflowPromptsConfig = {
 
     // ═══════════════════════════════════════════════════════════════════════
     // Phase 4 - Implementation: The "Keep Going" Cycle
-    // New chat → SM → create-story → New chat → DEV → dev-story → code-review
+    // SM → create-story → DEV → dev-story → code-review → (create-story | retrospective)
     // ═══════════════════════════════════════════════════════════════════════
     {
       name: 'create-story',