ma-agents 3.4.7 → 3.4.9

package/lib/bmad-extension/workflows/add-sprint/workflow.md

@@ -1,38 +1,16 @@
-<!-- IMPORTANT: This file must be kept in sync with lib/bmad-extension/skills/add-sprint/SKILL.md
-     SKILL.md is the authoritative source (resolved via skill:add-sprint in module-help.csv).
-     This workflow.md is a legacy copy. Any changes should be made to SKILL.md first, then synced here. -->
-
 # Add Sprint Workflow
 
-Guided workflow to create a new sprint entity with capacity limits, optional ISO dates, and structured YAML schema.
+Guided workflow to create a new sprint with capacity limits for realistic sprint planning.
 
 <workflow>
 
-<step n="1" goal="Gather and validate sprint number and name">
-  <action>Ask the user for the sprint number</action>
-  <ask>What is the sprint number? (positive integer, e.g., 1, 2, 3)</ask>
-  <action>Store input as {{sprint_number_input}}</action>
-  <action>Validate {{sprint_number_input}} matches `^[1-9]\d*$` (positive integer, no leading zeros, no non-numeric characters)</action>
-  <action>Validate {{sprint_number_input}} is <= 9999</action>
-  <check if="{{sprint_number_input}} fails validation (zero, negative, non-numeric, leading zeros like '03', or > 9999)">
-    <output>❌ Invalid sprint number: "{{sprint_number_input}}". Must be a positive integer (1-9999), no leading zeros.</output>
-    <goto step="1" />
-  </check>
-  <action>Store as {{sprint_number}} (integer)</action>
-  <action>Construct {{sprint_id}} = "sprint-{{sprint_number}}"</action>
-
-  <!-- Smart default name: detect naming patterns from existing sprints -->
-  <action>Glob `_bmad-output/implementation-artifacts/sprints/sprint-*.yaml` to discover existing sprint files</action>
-  <action>If existing sprints found, read the `name` field from the most recent one (highest sprint number)</action>
-  <action>Infer a smart default name:
-    - If previous name follows a sequential pattern with a numeric suffix (e.g., "app04"), suggest the next increment (e.g., "app05")
-    - If previous name follows a date pattern (e.g., "2026-W14"), suggest the next date interval
-    - If previous name is "Sprint {n}", suggest "Sprint {{sprint_number}}"
-    - If no pattern detected or no existing sprints, default to "Sprint {{sprint_number}}"
-  </action>
-  <ask>Sprint name? (press Enter for "{{default_name}}", or type a custom name):</ask>
-  <action>If user presses Enter or leaves blank, set {{sprint_name}} = "{{default_name}}"</action>
-  <action>If user provides input, store as {{sprint_name}}</action>
+<step n="1" goal="Gather sprint number and name">
+  <action>Ask the user for the sprint number (e.g., 1, 2, 3)</action>
+  <ask>What is the sprint number? (e.g., 1)</ask>
+  <action>Store as {{sprint_number}}</action>
+  <ask>What is the sprint name? (e.g., "Sprint 1 — Foundation") — press Enter to use "Sprint {{sprint_number}}"</ask>
+  <action>If user presses Enter or leaves blank, default to "Sprint {{sprint_number}}"</action>
+  <action>Store as {{sprint_name}}</action>
 </step>
 
 <step n="2" goal="Gather capacity as positive integer">
@@ -47,71 +25,32 @@ Guided workflow to create a new sprint entity with capacity limits, optional ISO
   <action>Store as {{capacity}} (integer)</action>
 </step>
 
-<step n="3a" goal="Gather optional start date (ISO format)">
-  <action>Explain: start and end dates are optional ISO dates (YYYY-MM-DD format). Press Enter to skip.</action>
-  <ask>Optional — Sprint start date (YYYY-MM-DD, press Enter to skip):</ask>
-  <action>Store input as {{start_input}}</action>
-  <check if="{{start_input}} is not empty">
-    <action>Validate {{start_input}} matches regex `^\d{4}-\d{2}-\d{2}$`</action>
-    <action>Verify {{start_input}} resolves to a real calendar date (reject impossible dates like 2026-02-30, 2026-13-45, etc.)</action>
-    <check if="{{start_input}} fails date validation">
-      <output>❌ Invalid date: "{{start_input}}". Must be a valid date in YYYY-MM-DD format (e.g., 2026-04-01).</output>
-      <goto step="3a" />
-    </check>
-  </check>
-  <action>Store as {{start_date}} (valid ISO date string, or empty string "" if skipped)</action>
-</step>
-
-<step n="3b" goal="Gather optional end date (ISO format)">
-  <ask>Optional — Sprint end date (YYYY-MM-DD, press Enter to skip):</ask>
-  <action>Store input as {{end_input}}</action>
-  <check if="{{end_input}} is not empty">
-    <action>Validate {{end_input}} matches regex `^\d{4}-\d{2}-\d{2}$`</action>
-    <action>Verify {{end_input}} resolves to a real calendar date</action>
-    <check if="{{end_input}} fails date validation">
-      <output>❌ Invalid date: "{{end_input}}". Must be a valid date in YYYY-MM-DD format (e.g., 2026-04-14).</output>
-      <goto step="3b" />
-    </check>
-  </check>
-  <action>Store as {{end_date}} (valid ISO date string, or empty string "" if skipped)</action>
-
-  <check if="both {{start_date}} and {{end_date}} are non-empty AND {{start_date}} > {{end_date}}">
-    <output>❌ Invalid date range: start date ({{start_date}}) is after end date ({{end_date}}). Start must be on or before end.</output>
-    <goto step="3a" />
-  </check>
+<step n="3" goal="Gather optional start and end context">
+  <action>Explain: start/end context can be dates (e.g., "2026-03-18") or milestone descriptions (e.g., "Q1 Planning Complete")</action>
+  <ask>Optional — Sprint start context (date or milestone, press Enter to skip):</ask>
+  <action>Store as {{start_context}} (empty string if skipped)</action>
+  <ask>Optional — Sprint end context (date or milestone, press Enter to skip):</ask>
+  <action>Store as {{end_context}} (empty string if skipped)</action>
 </step>
 
 <step n="4" goal="Confirm and validate all inputs">
   <output>
 ## Sprint Summary — Please Confirm
 
-- **Sprint ID:** {{sprint_id}}
-- **Sprint Name:** "{{sprint_name}}"
-- **Status:** planning
+- **Sprint Number:** {{sprint_number}}
+- **Sprint Name:** {{sprint_name}}
 - **Capacity (max items):** {{capacity}}
-- **Start Date:** {{start_date}} *(empty if skipped)*
-- **End Date:** {{end_date}} *(empty if skipped)*
-- **Items:** [] *(empty — items assigned via /add-to-sprint)*
-- **Output File:** `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`
+- **Start Context:** {{start_context}} *(empty if skipped)*
+- **End Context:** {{end_context}} *(empty if skipped)*
+- **Output File:** `_bmad-output/implementation-artifacts/sprint-plan-{{sprint_number}}.yaml`
   </output>
   <ask>Confirm creation? [y] Yes / [n] Cancel / [e] Edit a field:</ask>
   <check if="user selects 'e'">
     <ask>Which field to edit? (number / name / capacity / start / end)</ask>
     <check if="field == 'number'">
-      <ask>New sprint number? (positive integer, 1-9999)</ask>
-      <action>Store input as {{sprint_number_input}}</action>
-      <action>Validate {{sprint_number_input}} matches `^[1-9]\d*$` and is <= 9999</action>
-      <check if="{{sprint_number_input}} fails validation">
-        <output>❌ Invalid sprint number: "{{sprint_number_input}}". Must be a positive integer (1-9999), no leading zeros.</output>
-        <goto step="4" />
-      </check>
-      <action>Store as {{sprint_number}} (integer)</action>
-      <action>Construct {{sprint_id}} = "sprint-{{sprint_number}}"</action>
-      <action>If sprint name was using previous default "Sprint {old_n}", update to "Sprint {{sprint_number}}"</action>
-      <action>Check if file exists at `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`</action>
-      <check if="file already exists at new path">
-        <output>⚠️ A sprint entity already exists at `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`. You will be prompted to overwrite at creation.</output>
-      </check>
+      <ask>New sprint number:</ask>
+      <action>Store as {{sprint_number}}</action>
+      <action>If sprint name was auto-defaulted to the old "Sprint {n}", update it to "Sprint {{sprint_number}}"</action>
       <goto step="4" />
     </check>
     <check if="field == 'name'">
@@ -120,74 +59,45 @@ Guided workflow to create a new sprint entity with capacity limits, optional ISO
       <goto step="4" />
     </check>
     <check if="field == 'capacity'"><goto step="2" /></check>
-    <check if="field == 'start'"><goto step="3a" /></check>
-    <check if="field == 'end'"><goto step="3b" /></check>
-    <check if="field is not recognized">
-      <output>❌ Unrecognized field: "{{field}}". Valid options: number, name, capacity, start, end.</output>
-      <goto step="4" />
-    </check>
+    <check if="field == 'start'"><goto step="3" /></check>
+    <check if="field == 'end'"><goto step="3" /></check>
   </check>
   <check if="user selects 'n'">
     <output>❌ Sprint creation cancelled.</output>
     <action>Exit workflow</action>
   </check>
-  <check if="user input is not 'y', 'n', or 'e'">
-    <output>❌ Unrecognized option: "{{user_input}}". Please enter [y] Yes, [n] Cancel, or [e] Edit a field.</output>
-    <goto step="4" />
-  </check>
 </step>
 
-<step n="5" goal="Generate sprint entity YAML file">
-  <action>Determine output path: `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`</action>
-  <action>Ensure directory `_bmad-output/implementation-artifacts/sprints/` exists (create if needed)</action>
-
-  <!-- Overwrite protection for new path -->
-  <action>Check if file already exists at `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`</action>
-  <check if="file already exists at new path">
-    <anchor id="overwrite_prompt" />
-    <output>⚠️ A sprint entity already exists at `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`.</output>
-    <ask>Overwrite existing sprint? [y] Yes / [n] Cancel:</ask>
+<step n="5" goal="Generate sprint artifact file">
+  <action>Determine output path: `_bmad-output/implementation-artifacts/sprint-plan-{{sprint_number}}.yaml`</action>
+  <action>Check if file already exists at output path</action>
+  <check if="file already exists">
+    <output>⚠️ A sprint plan already exists at `_bmad-output/implementation-artifacts/sprint-plan-{{sprint_number}}.yaml`.</output>
+    <ask>Overwrite existing sprint plan? [y] Yes / [n] Cancel:</ask>
     <check if="user selects 'n'">
-      <output>❌ Sprint creation cancelled to preserve existing sprint.</output>
+      <output>❌ Sprint creation cancelled to preserve existing sprint plan.</output>
       <action>Exit workflow</action>
     </check>
-    <check if="user input is not 'y' or 'n'">
-      <output>❌ Unrecognized option: "{{user_input}}". Please enter [y] Yes or [n] Cancel.</output>
-      <goto anchor="overwrite_prompt" />
-    </check>
   </check>
-
-  <!-- Advisory check for old-format file -->
-  <action>Check if file exists at old path: `_bmad-output/implementation-artifacts/sprint-plan-{{sprint_number}}.yaml`</action>
-  <check if="old-format file exists">
-    <output>ℹ️ **Note:** An old-format sprint file exists at `_bmad-output/implementation-artifacts/sprint-plan-{{sprint_number}}.yaml`. The new sprint will be created at the new path. The old file is NOT auto-migrated — review or remove it manually if no longer needed.</output>
-  </check>
-
   <action>Get current ISO timestamp for created_date and last_modified</action>
-  <action>Write sprint entity YAML to `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml` with this structure:
+  <action>Write sprint artifact YAML to `_bmad-output/implementation-artifacts/sprint-plan-{{sprint_number}}.yaml` with this structure:
 
 ```yaml
-id: {{sprint_id}}
-name: "{{sprint_name}}"
-status: planning
+sprint_number: {{sprint_number}}
+sprint_name: "{{sprint_name}}"
 capacity: {{capacity}}
-start: "{{start_date}}"
-end: "{{end_date}}"
-items: []
+assigned_items: []
+status: planning
+start_context: "{{start_context}}"
+end_context: "{{end_context}}"
 created_date: "{{current_iso_timestamp}}"
 last_modified: "{{current_iso_timestamp}}"
 ```
-
-  **YAML output rules:**
-  - Always quote the `name` field to handle special characters
-  - `start` and `end` are empty string `""` if skipped
-  - `items` is always empty array `[]` at creation
-  - `status` is always `planning` at creation (never `active` or `closed`)
   </action>
   <output>
 ✅ **Sprint created successfully!**
 
-- **File:** `_bmad-output/implementation-artifacts/sprints/{{sprint_id}}.yaml`
+- **File:** `_bmad-output/implementation-artifacts/sprint-plan-{{sprint_number}}.yaml`
 - **Sprint:** {{sprint_name}}
 - **Capacity:** {{capacity}} items
 - **Status:** planning

package/lib/bmad-extension/workflows/add-to-sprint/workflow.md

@@ -1,4 +1,206 @@
-<!-- This workflow has been superseded by lib/bmad-extension/skills/add-to-sprint/SKILL.md -->
-<!-- Resolved via skill:add-to-sprint in module-help.csv -->
+# Add-to-Sprint Workflow
 
-See `lib/bmad-extension/skills/add-to-sprint/SKILL.md` for the current workflow.
+Guided workflow to assign backlog items (stories + bugs) to a sprint using multi-criteria prioritization.
+
+<workflow>
+
+<step n="1a" goal="Discover user story backlog items from sprint-status.yaml">
+  <action>Read `_bmad-output/implementation-artifacts/sprint-status.yaml` — authoritative source for user story execution status</action>
+  <action>Parse the development_status section. For each entry:
+    - Skip epic keys (keys matching `epic-*`)
+    - Skip retrospective keys (keys ending with `-retrospective`)
+    - Collect story keys and their current status (backlog, ready-for-dev, in-progress, review, done)
+  </action>
+  <action>Store as {{user_stories}} — list of objects with: key, status</action>
+  <action>Infer story title from key (e.g., `12-1-add-sprint-workflow` → "Add Sprint Workflow")</action>
+</step>
+
+<step n="1b" goal="Discover bug story backlog items">
+  <action>Glob `_bmad-output/implementation-artifacts/bug-*.md` to discover all bug story files</action>
+  <check if="no bug files found">
+    <action>Set {{bug_stories}} = [] (empty list)</action>
+  </check>
+  <check if="bug files found">
+    <action>For each bug file, parse YAML frontmatter to extract: `type`, `severity`, `title`</action>
+    <action>Store as {{bug_stories}} — list of objects with: file, type (bug), severity, title</action>
+  </check>
+</step>
+
+<step n="1c" goal="Filter out items already assigned to any sprint">
+  <action>Glob `_bmad-output/implementation-artifacts/sprint-plan-*.yaml` to discover all existing sprint artifact files</action>
+  <action>For each sprint file found, read its assigned_items list</action>
+  <action>Build {{all_assigned_items}} = flat set of every item identifier (story keys and bug basenames) across ALL sprint plans</action>
+  <action>Filter {{user_stories}}: remove any story whose key is present in {{all_assigned_items}}</action>
+  <action>Filter {{bug_stories}}: remove any bug whose file basename is present in {{all_assigned_items}}</action>
+  <action>Items already assigned to any sprint will NOT appear in the backlog — this prevents duplicate assignment</action>
+  <check if="no sprint files found">
+    <action>Set {{all_assigned_items}} = [] — no filtering needed when no sprints exist yet</action>
+  </check>
+</step>
+
+<step n="2" goal="Present flat backlog combining stories and bugs">
+  <action>Combine {{user_stories}} and {{bug_stories}} into a flat backlog list</action>
+  <action>Stories and bugs are peers — no epic grouping (FR65)</action>
+  <output>
+## 📋 Backlog Items
+
+| # | ID / File | Title | Type | Status/Severity |
+|---|---|---|---|---|
+{{#each backlog_items}}
+| {{@index+1}} | {{id}} | {{title}} | {{type}} | {{status_or_severity}} |
+{{/each}}
+
+*Total: {{story_count}} stories, {{bug_count}} bugs*
+  </output>
+</step>
+
+<step n="3" goal="List available sprints and select target sprint">
+  <action>Glob `_bmad-output/implementation-artifacts/sprint-plan-*.yaml` to discover all sprint artifact files</action>
+  <check if="no sprint files found">
+    <output>❌ No sprint plans found. Run `/add-sprint` first to create a sprint before assigning items.</output>
+    <action>Exit workflow</action>
+  </check>
+  <action>For each sprint file found, read and extract: sprint_number, sprint_name, capacity, assigned_items count, status</action>
+  <output>
+## 🏃 Available Sprints
+
+| # | Sprint | Status | Capacity | Assigned | Remaining |
+|---|---|---|---|---|---|
+{{#each sprints}}
+| {{@index+1}} | {{sprint_name}} | {{status}} | {{capacity}} | {{assigned_count}} | {{remaining}} |
+{{/each}}
+  </output>
+  <ask>Select target sprint (enter number):</ask>
+  <action>Store selected sprint data as {{target_sprint}}</action>
+</step>
+
+<step n="4" goal="Display current sprint capacity usage">
+  <action>Calculate: {{assigned_count}} = length of {{target_sprint.assigned_items}}</action>
+  <action>Calculate: {{remaining_capacity}} = {{target_sprint.capacity}} - {{assigned_count}}</action>
+  <output>
+## Sprint Capacity: {{target_sprint.sprint_name}}
+
+- **Capacity:** {{target_sprint.capacity}} items
+- **Assigned:** {{assigned_count}} items
+- **Remaining:** {{remaining_capacity}} slots
+
+{{#if remaining_capacity <= 0}}
+⚠️ This sprint is **at or over capacity**. Adding items will exceed the limit.
+{{/if}}
+  </output>
+</step>
+
+<step n="5" goal="Select candidate items for this sprint">
+  <ask>Which backlog items do you want to consider for this sprint? Enter item numbers (comma-separated), or "all" to evaluate the full backlog:</ask>
+  <check if="user enters 'all'">
+    <action>Set {{candidate_items}} = all items in {{backlog_items}} (the full filtered backlog list from step 2)</action>
+  </check>
+  <check if="user enters item numbers">
+    <action>Resolve the entered numbers against the backlog table from step 2 and set {{candidate_items}} = those specific items</action>
+  </check>
+</step>
+
+<step n="6" goal="Multi-criteria prioritization guidance">
+  <action>For each item in {{candidate_items}}, evaluate and score across criteria:
+    - **Business value:** High (H) / Medium (M) / Low (L) — impact on users or project goals
+    - **Dependency status:** Blocked (blocked by another item) / Blocking (blocks other items) / Independent
+    - **Severity** (bugs only): Critical / High / Medium / Low — N/A for stories
+    - **Effort estimation:** Small (S ≤ 1 day) / Medium (M 2–3 days) / Large (L 4+ days)
+  </action>
+  <action>Generate a ranked ordering recommendation, factoring in:
+    1. Blocking dependencies first (items that unlock others)
+    2. High business value + low/medium effort (quick wins)
+    3. Critical/High bugs ahead of Medium/Low bugs
+    4. Avoid blocked items unless capacity allows waiting
+  </action>
+  <output>
+## 🎯 Prioritization Analysis
+
+| Rank | ID / File | Title | Type | Business Value | Dependencies | Severity | Effort | Rationale |
+|---|---|---|---|---|---|---|---|---|
+{{#each ranked_items}}
+| {{rank}} | {{id}} | {{title}} | {{type}} | {{business_value}} | {{dependency_status}} | {{severity}} | {{effort}} | {{rationale}} |
+{{/each}}
+
+**Recommended selection** (up to {{remaining_capacity}} items to stay within capacity): {{recommended_selection}}
+  </output>
+</step>
+
+<step n="7" goal="User confirms or adjusts ranking">
+  <ask>Review the ranking above. Options:
+- [c] Confirm recommended selection as-is
+- [m] Modify selection (specify item numbers to include)
+- [r] Re-rank items (provide new priority order)
+- [x] Cancel without assigning
+
+Choice:</ask>
+  <check if="user selects 'x'">
+    <output>❌ Assignment cancelled — no changes made.</output>
+    <action>Exit workflow</action>
+  </check>
+  <check if="user selects 'm'">
+    <ask>Enter item numbers to assign (comma-separated):</ask>
+    <action>Update {{confirmed_items}} with user selection</action>
+  </check>
+  <check if="user selects 'r'">
+    <ask>Enter item numbers in your preferred priority order (comma-separated). Only items you include will be assigned — items not listed will be excluded from this session and remain in the unassigned backlog:</ask>
+    <action>Set {{confirmed_items}} = only the items matching the user-provided numbers, in the order provided. Items from {{candidate_items}} NOT mentioned are excluded from assignment in this session (they remain available in the backlog for future sprints).</action>
+  </check>
+  <check if="user selects 'c'">
+    <action>Set {{confirmed_items}} = recommended selection</action>
+  </check>
+  <action>Store confirmed ranking in {{confirmed_ranking}} for auditability (included in workflow output)</action>
+</step>
+
+<step n="8" goal="Assign selected items to sprint with capacity enforcement">
+  <action>For each item in {{confirmed_items}}, in confirmed ranking order:</action>
+  <action>Re-calculate current assigned count (in case multiple items are being added)</action>
+  <check if="assigning this item would exceed capacity">
+    <output>⚠️ **Capacity Warning:** Adding "{{item.title}}" would bring assigned items to {{new_count}}/{{target_sprint.capacity}} — exceeding sprint capacity by {{overage}}.</output>
+    <ask>Options:
+- [a] Add anyway (over-capacity acknowledged)
+- [s] Skip this item
+- [m] Modify sprint capacity first via `/modify-sprint`
+
+Choice:</ask>
+    <check if="user selects 's'">
+      <action>Skip this item — do not add to sprint. Continue to next item in the {{confirmed_items}} loop.</action>
+    </check>
+    <check if="user selects 'm'">
+      <output>💡 Run `/modify-sprint` to increase capacity for {{target_sprint.sprint_name}}, then re-run `/add-to-sprint`.</output>
+      <action>Exit workflow</action>
+    </check>
+  </check>
+  <action>Add item identifier to {{target_sprint.assigned_items}} list in the sprint-plan-{{target_sprint.sprint_number}}.yaml artifact</action>
+  <action>Item identifier format: story key for user stories (e.g., `12-1-add-sprint-workflow`), file basename for bugs (e.g., `bug-login-crash`)</action>
+</step>
+
+<step n="9" goal="Persist changes and display confirmed ranking for auditability">
+  <action>Update `_bmad-output/implementation-artifacts/sprint-plan-{{target_sprint.sprint_number}}.yaml`:
+    - Update `assigned_items` list with all newly assigned item identifiers
+    - Update `last_modified` to current ISO timestamp
+  </action>
+  <action>**Do NOT modify sprint-status.yaml** — sprint membership is exclusively tracked in sprint-plan-{n}.yaml</action>
+  <output>
+## ✅ Assignment Complete
+
+**Sprint:** {{target_sprint.sprint_name}}
+**Items assigned this session:** {{assigned_this_session}}
+
+### Confirmed Ranking (Audit Record)
+
+| Rank | ID | Title | Type | Business Value | Dependencies | Severity | Effort |
+|---|---|---|---|---|---|---|---|
+{{#each confirmed_ranking}}
+| {{rank}} | {{id}} | {{title}} | {{type}} | {{business_value}} | {{dependency_status}} | {{severity}} | {{effort}} |
+{{/each}}
+
+**Updated Capacity:** {{new_assigned_count}}/{{target_sprint.capacity}} items used ({{new_remaining}} remaining)
+
+**Next Steps:**
+- Use `/modify-sprint` to adjust capacity or remove items
+- Use `/sprint-status-view` to view the full sprint with all assigned items
+  </output>
+</step>
+
+</workflow>

package/lib/bmad-extension/workflows/modify-sprint/workflow.md

@@ -1,8 +1,3 @@
-<!-- DEPRECATED: This workflow references the old sprint-plan-{n}.yaml format.
-     It will be reworked in Story 17.4. Use /add-sprint to create sprints in the new format. -->
-
-> **DEPRECATED:** This workflow references the old `sprint-plan-{n}.yaml` format. It will be reworked in Story 17.4. Use `/add-sprint` to create sprints in the new format.
-
 # Modify Sprint Workflow
 
 Guided workflow to modify an existing sprint — add/remove items, change capacity, update metadata.

package/lib/bmad-extension/workflows/sprint-status-view/workflow.md

@@ -1,4 +1,193 @@
-<!-- This workflow has been superseded by lib/bmad-extension/skills/sprint-status-view/SKILL.md -->
-<!-- Resolved via skill:sprint-status-view in module-help.csv -->
+# Sprint Status View Workflow
 
-See `lib/bmad-extension/skills/sprint-status-view/SKILL.md` for the current workflow.
+Extension workflow that displays sprint progress with assigned items (stories + bugs), type distinction, and remaining capacity.
+
+> **Architecture mandate:** This workflow is a NEW extension at `lib/bmad-extension/workflows/sprint-status-view/`. It does NOT modify any files under `_bmad/bmm/workflows/`.
+
+<workflow>
+
+<step n="1" goal="Discover all sprint artifact files">
+  <action>Glob `_bmad-output/implementation-artifacts/sprint-plan-*.yaml` to discover all sprint artifact files</action>
+  <check if="no sprint files found">
+    <output>
+ℹ️ **No Sprints Found**
+
+No sprint plan files exist yet (`sprint-plan-*.yaml`).
+
+**To get started:**
+- Run `/add-sprint` to create your first sprint
+- Run `/add-to-sprint` to assign backlog items to it
+    </output>
+    <action>Exit workflow</action>
+  </check>
+  <action>For each sprint file found, read the full YAML content and store as {{sprint_plans}} list</action>
+  <action>Sort {{sprint_plans}} by sprint_number ascending</action>
+</step>
+
+<step n="2" goal="Load sprint-status.yaml for user story execution statuses">
+  <action>Read `_bmad-output/implementation-artifacts/sprint-status.yaml`</action>
+  <check if="file not found">
+    <output>⚠️ `sprint-status.yaml` not found. User story execution statuses will not be available. Run `/sprint-planning` to initialize.</output>
+    <action>Set {{story_status_map}} = {} (empty — will show data integrity warnings per missing item)</action>
+  </check>
+  <check if="file found">
+    <action>Parse development_status section into {{story_status_map}} — key: story key, value: status</action>
+    <action>Exclude epic-* keys and *-retrospective keys from the map</action>
+  </check>
+</step>
+
+<step n="3" goal="Discover bug stories for type/severity data">
+  <action>Glob `_bmad-output/implementation-artifacts/bug-*.md` to discover all bug story files</action>
+  <check if="no bug files found">
+    <action>Set {{bug_metadata_map}} = {} (empty)</action>
+  </check>
+  <check if="bug files found">
+    <action>For each bug file, parse YAML frontmatter to extract: type, severity, title</action>
+    <action>Build {{bug_metadata_map}} — key: file basename (e.g., `bug-login-crash`), value: {severity, title}</action>
+  </check>
+</step>
+
+<step n="4" goal="Display sprint status for each sprint">
+  <action>For each sprint in {{sprint_plans}} (in order):</action>
+  <action>Calculate: {{assigned_count}} = length(sprint.assigned_items)</action>
+  <action>Calculate: {{remaining_capacity}} = sprint.capacity - {{assigned_count}}</action>
+
+  <action>For each item identifier in sprint.assigned_items, resolve item details:
+
+    **If item is a story (key matches regex `^\d+-\d+-.+`):**
+    - Look up status in {{story_status_map}}[item_key]
+    - If NOT found in {{story_status_map}}:
+      → Record as DATA INTEGRITY WARNING: "Item {item_key} has no status entry in sprint-status.yaml — run /sprint-planning to initialize status tracking for this item."
+      → Display item with marker: ⚠️ [status unknown]
+    - If found: display with current status label
+
+    **If item is a bug (key matches regex `^bug-.+`):**
+    - Look up in {{bug_metadata_map}}[item_key]
+    - If NOT found: display with title as item_key, severity as "unknown"
+    - If found: display with title and severity from frontmatter
+    - Bug execution status: use `status` from bug file frontmatter if present; otherwise "not-started"
+
+    **If item matches neither pattern:** display as type "Unknown" with raw identifier as title
+  </action>
+
+  <output>
+---
+
+## 🏃 {{sprint.sprint_name}} (Sprint {{sprint.sprint_number}})
+
+**Status:** {{sprint.status}} | **Capacity:** {{sprint.capacity}} items | **Assigned:** {{assigned_count}} | **Remaining:** {{remaining_capacity}}
+{{#if sprint.start_context}}**Start:** {{sprint.start_context}}{{/if}} {{#if sprint.end_context}}| **End:** {{sprint.end_context}}{{/if}}
+
+{{#if over_capacity}}
+⚠️ **Over capacity by {{overage}} item(s)**
+{{/if}}
+
+### Assigned Items
+
+| Item | Title | Type | Status / Severity |
+|---|---|---|---|
+{{#each resolved_items}}
+{{#if is_story}}
+| {{item_key}} | {{title}} | 📋 Story | {{status}} |
+{{/if}}
+{{#if is_bug}}
+| {{item_key}} | {{title}} | 🐛 Bug | Severity: {{severity}} / {{bug_status}} |
+{{/if}}
+{{/each}}
+
+{{#if data_integrity_warnings}}
+**⚠️ Data Integrity Warnings:**
+{{#each data_integrity_warnings}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+{{#if assigned_items_empty}}
+*(No items assigned to this sprint)*
+{{/if}}
+  </output>
+</step>
+
+<step n="5" goal="Display unassigned backlog summary">
+  <action>Collect all item keys from {{story_status_map}} that are NOT in any sprint's assigned_items list — these are unassigned user stories</action>
+  <action>Collect all bug basenames from {{bug_metadata_map}} that are NOT in any sprint's assigned_items list — these are unassigned bugs</action>
+  <action>Count unassigned stories by status: {{unassigned_by_status}}</action>
+  <output>
+---
+
+## 📦 Unassigned Backlog
+
+### 📋 Unassigned Stories
+
+| Status | Count |
+|---|---|
+| backlog | {{count_backlog}} |
+| ready-for-dev | {{count_ready}} |
+| in-progress | {{count_in_progress}} |
+| review | {{count_review}} |
+| done | {{count_done}} |
+
+*Total unassigned stories: {{total_unassigned}}*
+
+### 🐛 Unassigned Bugs
+
+{{#if unassigned_bugs}}
+| ID / File | Title | Severity |
+|---|---|---|
+{{#each unassigned_bugs}}
+| {{id}} | {{title}} | {{severity}} |
+{{/each}}
+{{else}}
+*(No unassigned bugs)*
+{{/if}}
+
+**Tip:** Use `/add-to-sprint` to assign unassigned items to a sprint.
+  </output>
+</step>
+
+<step n="6" goal="Offer next actions">
+  <ask>Options:
+1. Show full unassigned backlog item list (IDs + titles + statuses)
+2. Add items to a sprint — run `/add-to-sprint`
+3. Modify a sprint — run `/modify-sprint`
+4. Create a new sprint — run `/add-sprint`
+5. Exit
+
+Choice:</ask>
+  <check if="choice == 1">
+    <action>For each unassigned story key in {{story_status_map}} not assigned to any sprint, display: key, inferred title, status</action>
+    <action>For each unassigned bug in {{bug_metadata_map}} not assigned to any sprint, display: id, title, severity</action>
+    <output>
+### Full Unassigned Backlog
+
+**Stories:**
+| Key | Title | Status |
+|---|---|---|
+{{#each unassigned_story_items}}
+| {{key}} | {{title}} | {{status}} |
+{{/each}}
+
+**Bugs:**
+| ID | Title | Severity |
+|---|---|---|
+{{#each unassigned_bugs}}
+| {{id}} | {{title}} | {{severity}} |
+{{/each}}
+    </output>
+    <goto step="6" />
+  </check>
+  <check if="choice == 2">
+    <output>▶️ Run `/add-to-sprint` to assign backlog items to a sprint.</output>
+  </check>
+  <check if="choice == 3">
+    <output>▶️ Run `/modify-sprint` to add/remove items or change sprint settings.</output>
+  </check>
+  <check if="choice == 4">
+    <output>▶️ Run `/add-sprint` to create a new sprint.</output>
+  </check>
+  <check if="choice == 5">
+    <action>Exit workflow</action>
+  </check>
+</step>
+
+</workflow>