ma-agents 3.1.0 → 3.3.0

package/lib/bmad-extension/skills/cleanup-done/SKILL.md

@@ -0,0 +1,159 @@
+---
+name: cleanup-done
+description: Archive done stories and bugs — move files to done/ subfolder and remove from sprint/backlog
+type: skill
+triggers:
+  - "cleanup done"
+  - "archive done items"
+---
+
+# Cleanup-Done Workflow
+
+Archive done stories and bugs — move files to the `done/` subfolder and remove from sprint/backlog tracking.
+
+<workflow>
+
+<step n="1" goal="Identify all done items across data sources">
+  <action>Read `_bmad-output/implementation-artifacts/sprint-status.yaml` — collect all story keys where status is `done`</action>
+  <action>Read `_bmad-output/implementation-artifacts/backlog.yaml` — collect all items where status is `done`</action>
+  <action>Glob `_bmad-output/implementation-artifacts/bug-*.md` — for each bug file, parse YAML frontmatter and collect those with `status: done`</action>
+  <action>Deduplicate across all three sources — build {{done_items}} as a unified list with: id, title, type (story/bug), source_file</action>
+  <check if="no done items found">
+    <output>No items with status `done` found across sprint-status.yaml, backlog.yaml, or bug files. Nothing to archive.</output>
+    <action>Exit workflow</action>
+  </check>
+</step>
+
+<step n="2" goal="Display done items and confirm archival scope">
+  <output>
+## Done Items Ready for Archival
+
+| # | ID | Title | Type | Source |
+|---|---|---|---|---|
+{{#each done_items}}
+| {{@index+1}} | {{id}} | {{title}} | {{type}} | {{source}} |
+{{/each}}
+
+*Total: {{done_items.length}} items*
+  </output>
+  <ask>Options:
+- [a] Archive all
+- [s] Select specific items (enter item numbers)
+- [q] Cancel
+
+Choice:</ask>
+  <check if="user selects 'q'">
+    <output>Cancelled. No changes made.</output>
+    <action>Exit workflow</action>
+  </check>
+  <check if="user selects 'a'">
+    <action>Set {{items_to_archive}} = all {{done_items}}</action>
+  </check>
+  <check if="user selects 's'">
+    <ask>Enter item numbers to archive (comma-separated):</ask>
+    <action>Resolve entered numbers against the table above</action>
+    <action>Set {{items_to_archive}} = selected items</action>
+  </check>
+</step>
+
+<step n="3" goal="Ensure done/ directory exists">
+  <action>Check if `_bmad-output/implementation-artifacts/done/` directory exists</action>
+  <action>If not, create it</action>
+</step>
+
+<step n="4" goal="Move files to done/ directory">
+  <action>For each item in {{items_to_archive}}:
+
+    **Stories** (type == story):
+    - Source: `_bmad-output/implementation-artifacts/{id}.md`
+    - Destination: `_bmad-output/implementation-artifacts/done/{id}.md`
+    - Use rename/move operation
+    - Skip if source file does not exist (log warning)
+    - Skip if destination file already exists (log warning — do not overwrite)
+
+    **Bugs** (type == bug):
+    - Source: `_bmad-output/implementation-artifacts/bug-{slug}.md`
+    - Destination: `_bmad-output/implementation-artifacts/done/bug-{slug}.md`
+    - Use rename/move operation
+    - Skip if source file does not exist (log warning)
+    - Skip if destination file already exists (log warning — do not overwrite)
+  </action>
+  <action>Track results: {{moved}}, {{skipped_missing}}, {{skipped_exists}}</action>
+</step>
+
+<step n="5" goal="Remove done IDs from sprint files">
+  <action>Glob `_bmad-output/implementation-artifacts/sprints/sprint-*.yaml` to find all sprint files</action>
+  <action>For each sprint file:
+    - Read the sprint's `items` array
+    - Check if any item IDs in the array match {{items_to_archive}}
+    - If NO matches found: skip this sprint file entirely (no modification needed)
+    - If matches found:
+      - Remove the matching item IDs from the array
+      - If items array becomes empty AND sprint status is `active`: auto-close the sprint by setting status to `closed`
+      - Update `last_modified` to current ISO timestamp
+      - Write the updated sprint file
+  </action>
+</step>
+
+<step n="6" goal="Remove done items from backlog.yaml">
+  <action>Read `_bmad-output/implementation-artifacts/backlog.yaml`</action>
+  <action>Remove all entries whose ID is in {{items_to_archive}}</action>
+  <action>Re-number remaining item priorities sequentially: 1, 2, 3, ..., N</action>
+  <action>Write updated `_bmad-output/implementation-artifacts/backlog.yaml`</action>
+</step>
+
+<step n="7" goal="Remove done entries from sprint-status.yaml">
+  <action>Read `_bmad-output/implementation-artifacts/sprint-status.yaml`</action>
+  <action>In the `development_status` section:
+    - Remove done story keys that are in {{items_to_archive}}
+    - Remove done bug keys that are in {{items_to_archive}}
+    - Do NOT remove epic keys (keys matching `epic-*`)
+    - Do NOT remove retrospective keys (keys ending with `-retrospective`)
+    - If all stories belonging to an epic have been removed: set that epic's status to `done`
+    - Preserve YAML comments where possible
+  </action>
+  <action>Write updated `_bmad-output/implementation-artifacts/sprint-status.yaml`</action>
+</step>
+
+<step n="8" goal="Report summary">
+  <output>
+## Archival Complete
+
+**Files moved to `done/`:** {{moved_count}}
+{{#each moved_items}}
+- {{id}} ({{type}}) -> done/
+{{/each}}
+
+{{#if skipped_missing.length}}
+**Skipped (source missing):** {{skipped_missing.length}}
+{{#each skipped_missing}}
+- {{id}} — source file not found
+{{/each}}
+{{/if}}
+
+{{#if skipped_exists.length}}
+**Skipped (already in done/):** {{skipped_exists.length}}
+{{#each skipped_exists}}
+- {{id}} — destination already exists
+{{/each}}
+{{/if}}
+
+**Sprint updates:**
+{{#each updated_sprints}}
+- {{sprint_id}}: removed {{removed_count}} item(s){{#if auto_closed}} — auto-closed (no remaining items){{/if}}
+{{/each}}
+
+**Backlog:** {{backlog_removed_count}} items removed, priorities renumbered 1..{{backlog_remaining_count}}
+
+**Sprint-status.yaml:** {{status_removed_count}} entries removed
+{{#if epics_marked_done.length}}
+- Epics marked done: {{#each epics_marked_done}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}
+{{/if}}
+
+**Next Steps:**
+- Use `/sprint-status-view` to verify updated sprint state
+- Use `/prioritize-backlog` to reorder remaining backlog items
+  </output>
+</step>
+
+</workflow>

package/lib/bmad-extension/skills/cleanup-done/bmad-skill-manifest.yaml

@@ -0,0 +1,3 @@
+type: skill
+name: cleanup-done
+module: ma-skills

package/lib/bmad-extension/skills/create-bug-story/SKILL.md

@@ -55,7 +55,32 @@ Guided workflow to create a structured bug story from a detected defect and add
   <action>Store as {{actual_behavior}}</action>
 </step>
 
-<step n="4" goal="Gather root cause hypothesis and affected files">
+<step n="4" goal="Gather version and bug type">
+  <ask>What version was this bug found in? (optional — press Enter to skip; e.g., "2.3.1", "v1.0.0-rc2")</ask>
+  <action>Store as {{version_found}} (empty string if skipped)</action>
+
+  <output>
+**Bug type classifications:**
+- `regression` — Previously working feature now broken
+- `functional` — Feature does not work as specified
+- `performance` — Unacceptable latency, throughput, or resource usage
+- `security` — Vulnerability or authentication/authorization flaw
+- `ui` — Visual or interaction defect
+- `data` — Data corruption, loss, or incorrect transformation
+- `integration` — Failure at system/service boundaries
+- `other` — Does not fit the above categories
+  </output>
+  <ask>What is the bug type? [regression / functional / performance / security / ui / data / integration / other] (default: functional)</ask>
+  <action>Store as {{bug_type}}</action>
+  <action>If empty or blank, default to "functional"</action>
+  <action>Normalize to lowercase</action>
+  <check if="{{bug_type}} is not one of: regression, functional, performance, security, ui, data, integration, other">
+    <output>❌ Bug type must be one of: regression, functional, performance, security, ui, data, integration, other.</output>
+    <goto step="4" />
+  </check>
+</step>
+
+<step n="5" goal="Gather root cause hypothesis and affected files">
   <ask>What is your root cause hypothesis? (optional — press Enter to skip; e.g., "Null check missing in validateUser()")</ask>
   <action>Store as {{root_cause}} (empty string if skipped)</action>
 
@@ -67,7 +92,7 @@ Guided workflow to create a structured bug story from a detected defect and add
   <action>Store as {{suggested_fix}} (empty string if skipped)</action>
 </step>
 
-<step n="5" goal="Confirm all bug details before writing">
+<step n="6" goal="Confirm all bug details before writing">
   <action>Derive {{title_slug}} by converting {{bug_title}} to lowercase kebab-case:
     - Convert to lowercase
     - Replace spaces and underscores with hyphens
@@ -82,6 +107,8 @@ Guided workflow to create a structured bug story from a detected defect and add
 
 - **Title:** {{bug_title}}
 - **Severity:** {{severity}}
+- **Bug Type:** {{bug_type}}
+- **Version Found:** {{version_found}} *(empty if skipped)*
 - **Affected Component:** {{affected_component}}
 - **Reproduction Steps:** {{reproduction_steps}}
 - **Expected Behavior:** {{expected_behavior}}
@@ -93,14 +120,15 @@ Guided workflow to create a structured bug story from a detected defect and add
   </output>
   <ask>Confirm creation? [y] Yes / [n] Cancel / [e] Edit a field:</ask>
   <check if="user selects 'e'">
-    <ask>Which field to edit? (title / severity / component / steps / expected / actual / root-cause / files / fix)</ask>
+    <ask>Which field to edit? (title / severity / component / steps / expected / actual / version / bug-type / root-cause / files / fix)</ask>
     <check if="field == 'title' OR field == 'severity'"><goto step="1" /></check>
     <check if="field == 'component' OR field == 'steps'"><goto step="2" /></check>
     <check if="field == 'expected' OR field == 'actual'"><goto step="3" /></check>
-    <check if="field == 'root-cause' OR field == 'files' OR field == 'fix'"><goto step="4" /></check>
+    <check if="field == 'version' OR field == 'bug-type'"><goto step="4" /></check>
+    <check if="field == 'root-cause' OR field == 'files' OR field == 'fix'"><goto step="5" /></check>
     <check if="none of the above matched">
-      <output>❌ Unrecognized field. Valid options: title / severity / component / steps / expected / actual / root-cause / files / fix</output>
-      <goto step="5" />
+      <output>❌ Unrecognized field. Valid options: title / severity / component / steps / expected / actual / version / bug-type / root-cause / files / fix</output>
+      <goto step="6" />
     </check>
   </check>
   <check if="user selects 'n'">
@@ -109,7 +137,7 @@ Guided workflow to create a structured bug story from a detected defect and add
   </check>
 </step>
 
-<step n="6" goal="Write bug story file">
+<step n="7" goal="Write bug story file">
   <action>Check if {{output_file}} already exists</action>
   <check if="file already exists">
     <output>⚠️ A bug story already exists at `{{output_file}}`.</output>
@@ -136,7 +164,10 @@ Guided workflow to create a structured bug story from a detected defect and add
 ```
 ---
 type: bug
+status: backlog
 severity: {{severity}}
+bug_type: {{bug_type}}
+version_found: {{version_found}}
 title: {{bug_title}}
 ---
 
@@ -183,8 +214,45 @@ title: {{bug_title}}
 - **File:** `{{output_file}}`
 - **Title:** {{bug_title}}
 - **Severity:** {{severity}}
+- **Bug Type:** {{bug_type}}
 - **Component:** {{affected_component}}
+  </output>
+</step>
+
+<step n="8" goal="Add bug entry to backlog.yaml">
+  <action>Check if `_bmad-output/implementation-artifacts/backlog.yaml` exists</action>
+
+  <check if="backlog.yaml exists">
+    <action>Read `_bmad-output/implementation-artifacts/backlog.yaml`</action>
+    <action>Determine the next priority number by finding the highest existing priority value and adding 1</action>
+    <action>Append a new entry at the end of the backlog items list with the following format:
+```yaml
+- id: "BUG-{{title_slug}}"
+  type: bug
+  epic: null
+  title: "{{bug_title}}"
+  priority: N
+  status: backlog
+  sprint: null
+  severity: {{severity}}
+```
+    Where N is the next priority number.
+    </action>
+    <action>Re-number all priorities sequentially (1, 2, 3, ...) from top to bottom to ensure no gaps</action>
+    <action>Write the updated backlog.yaml back to disk</action>
+    <output>
+📋 **Backlog updated!** Added `BUG-{{title_slug}}` to `_bmad-output/implementation-artifacts/backlog.yaml` with priority {{N}}.
+    </output>
+  </check>
 
+  <check if="backlog.yaml does not exist">
+    <output>
+ℹ️ No `backlog.yaml` found at `_bmad-output/implementation-artifacts/backlog.yaml`.
+Run `/generate-backlog` to create a backlog that will include this bug story.
+    </output>
+  </check>
+
+  <output>
 **Next Steps:**
 - Use `/add-to-sprint` to assign this bug to the current sprint
 - Use `/sprint-status-view` to see all sprint items including this bug

package/lib/bmad-extension/skills/generate-backlog/SKILL.md

@@ -0,0 +1,183 @@
+---
+name: generate-backlog
+description: Generate or refresh a flat backlog.yaml from epics and bug stories, preserving existing priority and sprint assignments
+type: skill
+triggers:
+  - "generate backlog"
+  - "refresh backlog"
+---
+
+# Generate Backlog Workflow
+
+Generate or refresh a flat `backlog.yaml` from epic stories and bug reports. Preserves existing priority and sprint assignments, appends new items, removes stale items, and re-numbers priorities 1..N.
+
+<workflow>
+
+<step n="1" goal="Load sources">
+  <action>Read `_bmad-output/planning-artifacts/epics.md` — this is the master list of epics with their stories.</action>
+  <check if="epics.md does not exist">
+    <output>**Error:** `_bmad-output/planning-artifacts/epics.md` not found. Cannot generate backlog without an epics file.</output>
+    <action>Exit workflow</action>
+  </check>
+
+  <action>Glob `_bmad-output/implementation-artifacts/bug-*.md` to discover all bug story files.</action>
+  <action>Store the list of bug files as {{bug_files}} (may be empty — zero bugs is valid).</action>
+
+  <action>Read `_bmad-output/implementation-artifacts/sprint-status.yaml` if it exists — this provides the current status of each story (done, in-progress, backlog, etc.).</action>
+  <action>Store the status map as {{status_map}} (keyed by story id). If the file does not exist, use an empty map.</action>
+
+  <action>Read `_bmad-output/implementation-artifacts/backlog.yaml` if it exists — this is the existing backlog to merge with.</action>
+  <action>Store the existing backlog items as {{existing_items}} (list). If the file does not exist, use an empty list.</action>
+
+  <output>
+**Sources loaded:**
+- epics.md: found
+- Bug files: {{bug_files | length}} file(s)
+- sprint-status.yaml: {{status_map exists ? "found" : "not found (empty status)"}}
+- Existing backlog.yaml: {{existing_items | length}} item(s)
+  </output>
+</step>
+
+<step n="2" goal="Extract stories from epics">
+  <action>Parse `epics.md` to extract every story from every epic. Each epic is a level-2 heading (`## Epic N: ...`) and each story within it is a level-3 heading (`### Story N.M: ...`) or a list item following the pattern `- **Story N.M:** Title` or `- N.M: Title`.</action>
+
+  <action>For each story found:
+    - Derive {{story_id}} as a kebab-case slug: `"{epic_number}-{story_number}-{title_slug}"` (e.g., `"5-5-explicit-parameter-passing"`)
+      - Title slug: lowercase, replace spaces/underscores with hyphens, remove non-alphanumeric/non-hyphen characters, collapse consecutive hyphens, trim leading/trailing hyphens
+    - Set {{epic}} to the epic number (integer)
+    - Set {{title}} to the story title text
+    - Look up status from {{status_map}} using the story identifier. If found and status is `done`, skip this story (exclude from backlog). If found, use that status. If not found, default to `backlog`.
+    - Set {{type}} = `story`
+    - Set {{severity}} = `null`
+    - Set {{sprint}} = `null`
+    - Set {{priority}} = `null` (will be assigned during merge/sort)
+  </action>
+
+  <action>Store the extracted stories as {{extracted_stories}} list.</action>
+  <output>Extracted {{extracted_stories | length}} active stories from epics (done items excluded).</output>
+</step>
+
+<step n="3" goal="Extract bugs">
+  <action>For each file in {{bug_files}}:
+    - Read the file and parse the YAML frontmatter (between `---` delimiters)
+    - Extract `title`, `severity`, and `status` from frontmatter
+    - Derive {{bug_id}} from the **filename**, not the title: strip the `bug-` prefix and `.md` extension, then uppercase to `"BUG-{slug}"` (e.g., `bug-login-crash.md` → `BUG-login-crash`)
+    - Use `status` from frontmatter directly (bugs track their own status). If `status` is missing, default to `backlog`. If status is `done`, skip this bug (exclude from backlog).
+    - Build a backlog item:
+      - id: {{bug_id}}
+      - type: `bug`
+      - epic: `null`
+      - title: {{title}}
+      - priority: `null` (assigned during merge/sort)
+      - status: {{frontmatter_status or "backlog"}}
+      - sprint: `null`
+      - severity: {{severity}}
+  </action>
+
+  <action>Store the extracted bugs as {{extracted_bugs}} list.</action>
+  <output>Extracted {{extracted_bugs | length}} active bugs (done items excluded).</output>
+</step>
+
+<step n="4" goal="Merge with existing backlog">
+  <action>Combine {{extracted_stories}} and {{extracted_bugs}} into {{new_items}} list.</action>
+
+  <action>Build a lookup map from {{existing_items}} keyed by `id`.</action>
+
+  <action>For each item in {{new_items}}:
+    - If an item with the same `id` exists in {{existing_items}}:
+      - **Preserve** the existing `priority` value
+      - **Preserve** the existing `sprint` assignment
+      - **Update** `status` from the freshly extracted value (which may reflect sprint-status.yaml changes)
+      - **Update** `title`, `type`, `epic`, `severity` from the freshly extracted values (source of truth)
+    - If no matching item exists in {{existing_items}}:
+      - This is a new item — keep all freshly extracted values
+      - Set `priority` to `null` (will be placed at the end during sort)
+  </action>
+
+  <action>Identify stale items: any item in {{existing_items}} whose `id` does NOT appear in {{new_items}}. These items no longer exist in the source files and should be removed.</action>
+
+  <action>Store the final merged list as {{merged_items}}.</action>
+  <action>Store the count of new items added as {{new_count}}.</action>
+  <action>Store the count of stale items removed as {{stale_count}}.</action>
+  <action>Store the count of preserved items as {{preserved_count}}.</action>
+
+  <output>
+**Merge results:**
+- Preserved (existing): {{preserved_count}}
+- New items added: {{new_count}}
+- Stale items removed: {{stale_count}}
+  </output>
+</step>
+
+<step n="5" goal="Write backlog.yaml">
+  <action>Sort {{merged_items}} for final output:
+    1. Items WITH an existing numeric `priority` come first, sorted ascending by priority
+    2. Items WITHOUT a priority (`null`) come after, sorted by:
+       a. `type`: bugs before stories (bugs get priority attention)
+       b. `severity` for bugs: critical > high > medium > low
+       c. `epic` number ascending for stories (lower epics first)
+       d. `id` alphabetically as final tiebreaker
+  </action>
+
+  <action>Re-number priorities sequentially 1..N across all items in the sorted list.</action>
+
+  <action>Get current ISO timestamp as {{generated_at}}.</action>
+
+  <action>Write `_bmad-output/implementation-artifacts/backlog.yaml` with this structure:
+
+```yaml
+# Flat Backlog — auto-generated by generate-backlog
+# Generated: {{generated_at}}
+# Total items: {{merged_items | length}}
+#
+# Schema per item:
+#   id, type, epic, title, priority, status, sprint, severity
+
+backlog:
+  - id: "5-5-explicit-parameter-passing"
+    type: story
+    epic: 5
+    title: "Explicit Parameter Passing"
+    priority: 1
+    status: backlog
+    sprint: null
+    severity: null
+  # ... remaining items ...
+```
+
+  **YAML output rules:**
+  - Always quote `id` and `title` fields (they contain hyphens and special characters)
+  - `epic` is an integer for stories, `null` for bugs
+  - `sprint` is a string like `"sprint-3"` if assigned, or `null`
+  - `severity` is a string (`critical`, `high`, `medium`, `low`) for bugs, `null` for stories
+  - `status` is one of: `backlog`, `ready-for-dev`, `in-progress`, `review` (done items excluded)
+  - `priority` is always a positive integer (1 = highest priority)
+  - Use 2-space indentation for YAML
+  </action>
+
+  <output>Backlog written to `_bmad-output/implementation-artifacts/backlog.yaml` with {{merged_items | length}} items.</output>
+</step>
+
+<step n="6" goal="Report summary">
+  <output>
+## Backlog Generation Complete
+
+| Metric              | Count |
+|----------------------|-------|
+| Total items          | {{merged_items | length}} |
+| Stories              | {{story_count}} |
+| Bugs                 | {{bug_count}} |
+| New items added      | {{new_count}} |
+| Stale items removed  | {{stale_count}} |
+| Items preserved      | {{preserved_count}} |
+
+**Output:** `_bmad-output/implementation-artifacts/backlog.yaml`
+
+**Next Steps:**
+- Review priorities — new items are appended at the end; reorder as needed
+- Use `/add-to-sprint` to assign high-priority items to the current sprint
+- Use `/sprint-status-view` to see sprint progress
+  </output>
+</step>
+
+</workflow>

package/lib/bmad-extension/skills/generate-backlog/bmad-skill-manifest.yaml

@@ -0,0 +1,3 @@
+type: skill
+name: generate-backlog
+module: ma-skills

package/lib/bmad-extension/skills/modify-sprint/SKILL.md

@@ -7,12 +7,75 @@ triggers:
   - "edit sprint"
 ---
 
+<!-- PARTIALLY REWORKED: Item assignment is handled by /add-to-sprint (Story 17.4).
+     Item removal is handled by /remove-from-sprint (Story 17.5).
+     Sprint activation (planning -> active) is handled below (Step 3e).
+     The legacy workflow below still references old sprint-plan-{n}.yaml paths for
+     other operations. A full rework of modify-sprint is planned for a future story. -->
+
+> **Note:** Item assignment and removal are now handled by `/add-to-sprint` and `/remove-from-sprint`. Use the **Activate Sprint** option below to transition a sprint from `planning` to `active`.
+
 # Modify Sprint Workflow
 
 Guided workflow to modify an existing sprint — add/remove items, change capacity, update metadata.
 
 <workflow>
 
+<step n="3e" goal="Activate a sprint (planning -> active)">
+  <action>Glob `_bmad-output/implementation-artifacts/sprints/sprint-*.yaml` to discover all sprint files</action>
+  <check if="no sprint files found">
+    <output>No sprints found. Run `/add-sprint` first.</output>
+    <action>Exit workflow</action>
+  </check>
+  <action>Read each sprint file; extract: id, name, status, capacity, items count</action>
+  <action>Display sprints table</action>
+  <output>
+## Available Sprints
+
+| # | ID | Name | Status | Items | Capacity |
+|---|---|---|---|---|---|
+{{#each sprints}}
+| {{@index+1}} | {{id}} | {{name}} | {{status}} | {{items_count}} | {{capacity}} |
+{{/each}}
+  </output>
+  <ask>Which sprint to activate? (enter number, or 'q' to cancel):</ask>
+  <check if="user enters 'q'">
+    <output>Cancelled.</output>
+    <action>Exit workflow</action>
+  </check>
+  <action>Store selected sprint as {{target_sprint}}</action>
+
+  <!-- Validate transition -->
+  <check if="target_sprint.status != 'planning'">
+    <output>Only sprints in `planning` status can be activated. Sprint "{{target_sprint.name}}" is currently `{{target_sprint.status}}`.</output>
+    <action>Exit workflow</action>
+  </check>
+
+  <!-- Check single-active constraint -->
+  <action>Check if any other sprint has status `active`</action>
+  <check if="another sprint is already active">
+    <output>Cannot activate "{{target_sprint.name}}" — sprint "{{active_sprint.name}}" ({{active_sprint.id}}) is already active. Close it first before activating another sprint.</output>
+    <action>Exit workflow</action>
+  </check>
+
+  <ask>Activate "{{target_sprint.name}}" ({{target_sprint.id}})? This will set status to `active`. [y] Yes / [n] Cancel:</ask>
+  <check if="user selects 'n'">
+    <output>Cancelled.</output>
+    <action>Exit workflow</action>
+  </check>
+
+  <action>Set target_sprint.status = "active"</action>
+  <action>Update `last_modified` to current ISO timestamp</action>
+  <action>Write updated sprint file to `_bmad-output/implementation-artifacts/sprints/{{target_sprint.id}}.yaml`</action>
+  <output>
+Sprint "{{target_sprint.name}}" is now **active**.
+
+**Next Steps:**
+- Use `/add-to-sprint` to assign backlog items
+- Use `/sprint-status-view` to see sprint progress
+  </output>
+</step>
+
 <step n="1" goal="List available sprints and select one to modify">
   <action>Glob `_bmad-output/implementation-artifacts/sprint-plan-*.yaml` to discover all sprint artifact files</action>
   <check if="no sprint files found">