ma-agents 3.4.8 → 3.4.9

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

@@ -1,159 +0,0 @@
----
-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

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

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

@@ -1,183 +0,0 @@
----
-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

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

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

@@ -1,195 +0,0 @@
----
-name: prioritize-backlog
-description: Reprioritize backlog items using multiple criteria — severity, business value, dependencies, type, age
-type: skill
-triggers:
-  - "prioritize backlog"
-  - "reorder backlog"
-  - "reprioritize"
----
-
-# Prioritize-Backlog Workflow
-
-Reprioritize backlog items using multiple criteria — severity, business value, dependencies, type, and age.
-
-<workflow>
-
-<step n="1" goal="Load backlog and dependency data">
-  <action>Read `_bmad-output/implementation-artifacts/backlog.yaml`</action>
-  <check if="file missing or empty (no items)">
-    <output>No backlog found or backlog is empty. Nothing to prioritize.</output>
-    <action>Exit workflow</action>
-  </check>
-  <action>Store all backlog items as {{backlog_items}}</action>
-  <action>Infer implicit dependencies: stories belonging to the same epic are assumed to be sequential (lower story number before higher)</action>
-  <action>Read `_bmad-output/implementation-artifacts/epics.md` (or equivalent epics source) for any explicitly declared dependencies</action>
-  <action>Build {{dependency_map}} — for each item, list the IDs it depends on (must be completed before it can start)</action>
-</step>
-
-<step n="2" goal="Display current backlog ordering">
-  <output>
-## Current Backlog
-
-| # | Priority | ID | Title | Type | Epic | Status | Sprint | Severity | Dependencies |
-|---|---|---|---|---|---|---|---|---|---|
-{{#each backlog_items}}
-| {{@index+1}} | {{priority}} | {{id}} | {{title}} | {{type}} | {{epic}} | {{status}} | {{sprint}} | {{severity}} | {{dependencies}} |
-{{/each}}
-
-*Total: {{backlog_items.length}} items*
-  </output>
-</step>
-
-<step n="3" goal="Choose prioritization mode">
-  <ask>Choose prioritization mode:
-1. **Full reprioritization** — enter items in desired order, remaining appended at end
-2. **Quick adjust** — move individual items up/down
-3. **Auto-suggest** — AI analysis with weighted criteria
-4. **Cancel**
-
-Choice:</ask>
-  <check if="choice == 4">
-    <output>Cancelled. No changes made.</output>
-    <action>Exit workflow</action>
-  </check>
-</step>
-
-<step n="3a" goal="Full reprioritization" if="choice == 1">
-  <ask>Enter item numbers in your desired priority order (comma-separated). Items not listed will be appended in their current relative order:</ask>
-  <action>Resolve entered numbers against the backlog table from step 2</action>
-  <action>Build {{new_order}}: user-specified items first (in given order), then remaining items appended in their original relative order</action>
-  <goto step="4" />
-</step>
-
-<step n="3b" goal="Quick adjust" if="choice == 2">
-  <action>Initialize {{new_order}} as a copy of the current {{backlog_items}} list (preserving current ordering)</action>
-  <ask>Select item number to move:</ask>
-  <action>Store selected item as {{item_to_move}}</action>
-  <ask>Move to:
-- Enter a position number (1 = top, N = bottom)
-- Or enter 'u' to move up one position, 'd' to move down one position
-
-Target:</ask>
-  <action>Move {{item_to_move}} to the specified position in {{new_order}}</action>
-  <output>Moved "{{item_to_move.title}}" to position {{new_position}}.</output>
-  <ask>Continue? [m] Move another item / [d] Done adjusting:</ask>
-  <check if="user selects 'm'">
-    <action>Display current ordering</action>
-    <goto step="3b" />
-  </check>
-  <check if="user selects 'd'">
-    <goto step="4" />
-  </check>
-</step>
-
-<step n="3c" goal="Auto-suggest prioritization" if="choice == 3">
-  <action>Analyze all backlog items using weighted criteria:
-    1. **Blocking dependencies** (highest weight) — items that block other items should come first
-    2. **Severity** (bugs only) — critical > high > medium > low
-    3. **Business value** — infer from epic priority, item description, and type
-    4. **Type priority** — bugs generally before stories of equal value
-    5. **Age** — older items (lower story numbers, earlier creation) get slight priority boost
-  </action>
-  <action>Generate {{suggested_order}} with rationale for each item's position</action>
-  <output>
-## Auto-Suggested Priority Order
-
-| New # | ID | Title | Type | Rationale |
-|---|---|---|---|---|
-{{#each suggested_order}}
-| {{@index+1}} | {{id}} | {{title}} | {{type}} | {{rationale}} |
-{{/each}}
-  </output>
-  <ask>Options:
-- [a] Accept this ordering
-- [m] Modify (switch to full reprioritization with this as starting point)
-- [r] Reject (return to mode selection)
-
-Choice:</ask>
-  <check if="user selects 'a'">
-    <action>Set {{new_order}} = {{suggested_order}}</action>
-    <goto step="4" />
-  </check>
-  <check if="user selects 'm'">
-    <action>Set current backlog display to {{suggested_order}}</action>
-    <goto step="3a" />
-  </check>
-  <check if="user selects 'r'">
-    <goto step="3" />
-  </check>
-</step>
-
-<step n="4" goal="Dependency validation">
-  <action>For each item in {{new_order}}, check if it appears before any item it depends on</action>
-  <check if="dependency violations found">
-    <output>
-**Dependency Warning:** The following items appear before their dependencies:
-
-{{#each violations}}
-- **{{item.id}}** (position {{item.position}}) depends on **{{dependency.id}}** (position {{dependency.position}})
-{{/each}}
-    </output>
-    <ask>How to proceed?
-- [o] Override — keep current order despite dependency warnings
-- [f] Fix — automatically reorder to satisfy dependencies
-- [c] Cancel — return to mode selection
-
-Choice:</ask>
-    <check if="user selects 'f'">
-      <action>Reorder {{new_order}} to satisfy dependency constraints (move dependency items before their dependents, preserving relative order otherwise)</action>
-      <output>Dependencies fixed. Updated ordering applied.</output>
-    </check>
-    <check if="user selects 'c'">
-      <goto step="3" />
-    </check>
-    <!-- if 'o', proceed with current order -->
-  </check>
-</step>
-
-<step n="5" goal="Confirm and persist new ordering">
-  <output>
-## Old vs New Priority Order
-
-| Position | Old | New |
-|---|---|---|
-{{#each comparison}}
-| {{position}} | {{old_id}} — {{old_title}} | {{new_id}} — {{new_title}} |
-{{/each}}
-  </output>
-  <ask>Provide a brief reason for this reprioritization:</ask>
-  <action>Store as {{reason}}</action>
-  <ask>Confirm? [y] Apply / [n] Cancel / [e] Edit order:</ask>
-  <check if="user selects 'n'">
-    <output>Cancelled. No changes made.</output>
-    <action>Exit workflow</action>
-  </check>
-  <check if="user selects 'e'">
-    <goto step="3" />
-  </check>
-  <check if="user input is not 'y', 'n', or 'e'">
-    <output>Unrecognized option: "{{user_input}}". Please enter [y], [n], or [e].</output>
-    <goto step="5" />
-  </check>
-
-  <action>Update `_bmad-output/implementation-artifacts/backlog.yaml`:
-    - Rewrite items in {{new_order}} sequence
-    - Set priority fields sequentially: 1, 2, 3, ..., N
-    - Add or update header comment: `# Reprioritized: {{current_date}} — {{reason}}`
-    - Preserve all other item fields unchanged
-  </action>
-  <output>
-## Reprioritization Complete
-
-**Items reordered:** {{new_order.length}}
-**Reason:** {{reason}}
-**Date:** {{current_date}}
-
-Updated priorities written to `_bmad-output/implementation-artifacts/backlog.yaml`.
-
-**Next Steps:**
-- Use `/sprint-status-view` to review sprint assignments
-- Use `/add-to-sprint` to assign top-priority items to a sprint
-  </output>
-</step>
-
-</workflow>

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

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