ma-agents 3.4.8 → 3.5.0

package/_bmad-output/implementation-artifacts/done/17-2-flat-backlog-model.md

@@ -0,0 +1,264 @@
+# Story 17.2: Flat Backlog Model
+
+Status: review
+
+<!-- Note: Validation is optional. Run validate-create-story for quality check before dev-story. -->
+
+## Story
+
+As a **Scrum Master**,
+I want a flat backlog file listing all stories and bugs in priority order, independent of their parent epic,
+So that sprint planning works from a single prioritized list, not epic-grouped sections.
+
+## Acceptance Criteria
+
+1. **Given** the backlog is generated from the epics document,
+   **When** the backlog file is created at `{implementation_artifacts}/backlog.yaml`,
+   **Then** it contains ALL stories and bugs as a flat ordered list:
+   ```yaml
+   backlog:
+     - id: "5-5-explicit-parameter-passing"
+       type: story
+       epic: 5
+       title: "Explicit Parameter Passing"
+       priority: 1
+       status: backlog
+     - id: "BUG-path-spaces"
+       type: bug
+       epic: null
+       title: "Fix space-in-path bug"
+       priority: 2
+       status: backlog
+       severity: high
+   ```
+
+2. **Given** a story is assigned to a sprint,
+   **When** the backlog is viewed,
+   **Then** the item shows `sprint: sprint-3` indicating its assignment,
+   **And** it is still visible in the backlog (with sprint annotation) for reference.
+
+3. **Given** stories exist across multiple epics,
+   **When** the backlog is ordered,
+   **Then** ordering is by the `priority` field, not by epic number,
+   **And** items from different epics can be interleaved based on priority.
+
+4. **Given** an item has status `done`,
+   **When** the backlog is generated or refreshed,
+   **Then** it is NOT included in the backlog (done items live in the done archive).
+
+## Tasks / Subtasks
+
+- [x] Task 1: Define backlog.yaml schema (AC: #1, #2, #3, #4)
+  - [x] 1.1: Create the authoritative backlog YAML schema documentation in `_bmad-output/implementation-artifacts/sprint-management-guardrails.md` (renamed by Story 17.1). Schema fields per item:
+    - `id` (string): Story IDs follow `{epic}-{story}-{slug}` format; Bug IDs follow `BUG-{slug}` format (per Story 17.1 Item ID Format Contract)
+    - `type` (enum): `story` or `bug`
+    - `epic` (int|null): Epic number for stories; `null` for bugs (FR64 — bugs don't belong to epics)
+    - `title` (string): Human-readable title, always quoted in YAML
+    - `priority` (int): Sequential integer starting from 1, lower = higher priority
+    - `status` (enum): `backlog | ready-for-dev | in-progress | review` (done items excluded per AC #4)
+    - `sprint` (string|null): Sprint ID if assigned (e.g., `sprint-3`), `null` if unassigned
+    - `severity` (enum|null): `critical | high | medium | low` for bugs only, `null` for stories
+  - [x] 1.2: Add backlog schema to guardrails doc under a new "Backlog Model" section
+
+- [x] Task 2: Create `generate-backlog` SKILL.md (AC: #1, #3, #4)
+  - [x] 2.1: Create skill package at `lib/bmad-extension/skills/generate-backlog/SKILL.md` with YAML frontmatter:
+    ```yaml
+    ---
+    name: generate-backlog
+    description: Generate or refresh the flat backlog from epics and bug story files
+    type: skill
+    triggers:
+      - "generate backlog"
+      - "refresh backlog"
+    ---
+    ```
+  - [x] 2.2: Create `lib/bmad-extension/skills/generate-backlog/bmad-skill-manifest.yaml`
+  - [x] 2.3: Implement the workflow steps in SKILL.md:
+    - **Step 1: Load sources**
+      - Read `_bmad-output/planning-artifacts/epics.md` (or sharded equivalent)
+      - Glob `_bmad-output/implementation-artifacts/bug-*.md` for bug story files
+      - Read existing `_bmad-output/implementation-artifacts/backlog.yaml` if it exists (to preserve priority overrides and sprint assignments)
+    - **Step 2: Extract stories from epics**
+      - Parse each epic section for stories with format `{epic_num}-{story_num}-{slug}`
+      - Extract: id, title, epic number
+      - Look up current status from `sprint-status.yaml` development_status entries
+      - Exclude any item with status `done` (AC #4)
+    - **Step 3: Extract bugs**
+      - For each `bug-*.md` file, parse YAML frontmatter for: type, severity, title
+      - Derive id as `BUG-{slug}` from filename (strip `bug-` prefix, uppercase to `BUG-`)
+      - Set `epic: null` for all bugs
+      - Exclude any bug with status `done`
+    - **Step 4: Merge with existing backlog**
+      - If existing backlog.yaml exists, preserve `priority` and `sprint` assignments for items that still exist
+      - New items (not in existing backlog) get appended at the end with sequential priorities after existing items
+      - Items in existing backlog that no longer exist in sources are removed
+      - Items that have become `done` since last generation are removed
+    - **Step 5: Write backlog.yaml**
+      - Sort items by `priority` field (ascending)
+      - Re-number priorities as sequential integers 1..N (no gaps)
+      - Write to `_bmad-output/implementation-artifacts/backlog.yaml`
+      - Include header comment with generation timestamp
+    - **Step 6: Report**
+      - Display summary: total items, stories count, bugs count, new items added, items removed
+
+- [x] Task 3: Register in module-help.csv (AC: #1)
+  - [x] 3.1: Add row to `lib/bmad-extension/module-help.csv`:
+    ```
+    ma-skills,4-implementation,Generate Backlog,generate-backlog,,skill:generate-backlog,generate-backlog,false,bmm-sm,,"Generate or refresh flat backlog from epics and bug stories.",_bmad-output/implementation-artifacts,"backlog",
+    ```
+
+- [x] Task 4: Update sprint-planning workflow to call generate-backlog (AC: #1)
+  - [x] 4.1: Identify the sprint-planning workflow location (`_bmad/bmm/4-implementation/bmad-sprint-planning/workflow.md`)
+  - [x] 4.2: **Do NOT modify** the bmm workflow directly — instead, add a note in the generate-backlog SKILL.md that sprint-planning should invoke `/generate-backlog` as its first step when backlog model is available
+  - [x] 4.3: Add guidance in the SKILL.md output that explains the relationship: "Sprint-planning workflow should run `/generate-backlog` first to ensure the backlog is current before selecting stories for sprint creation"
+
+- [x] Task 5: Update guardrails with data authority (AC: #1, #2)
+  - [x] 5.1: Add to `sprint-management-guardrails.md` Data Authority Rules table:
+    | Concern | Authoritative Source | Read By |
+    |---|---|---|
+    | Item priority ordering | `backlog.yaml` | 17.4, 17.5, 17.7, 17.8 |
+    | Sprint membership | `sprints/sprint-{id}.yaml` | 17.4, 17.5, 17.6, 17.8 |
+  - [x] 5.2: Document that `sprint-status.yaml` is now a **derived file** — generated from backlog.yaml + sprint files (Story 17.8 will implement the derivation)
+  - [x] 5.3: Document backlog discovery glob: `_bmad-output/implementation-artifacts/backlog.yaml` (single file, not globbed)
+
+- [x] Task 6: Verify (AC: #1, #2, #3, #4)
+  - [x] 6.1: Trace SKILL.md logic — confirm all story extraction paths produce valid backlog entries
+  - [x] 6.2: Verify bug entries have `epic: null` and include `severity` field
+  - [x] 6.3: Verify done items are excluded from output
+  - [x] 6.4: Verify priority re-numbering produces sequential integers with no gaps
+  - [x] 6.5: Verify existing priority/sprint assignments are preserved on re-generation
+  - [x] 6.6: Verify sprint field shows sprint ID when assigned, null when unassigned
+
+## Dev Notes
+
+### Architecture Compliance
+
+- **SKILL.md is the authoritative file:** Following Epic 15 pattern, create the skill as a SKILL.md package at `lib/bmad-extension/skills/generate-backlog/`
+- **Extension module pattern:** Skill lives in `lib/bmad-extension/skills/` (NOT in `_bmad/bmm/workflows/`)
+- **YAML artifact format:** Backlog uses YAML, consistent with sprint files
+- **Single file model:** The backlog is ONE file (`backlog.yaml`), not sharded — it's the flat list of all active items
+- **Idempotent generation:** Running generate-backlog multiple times with no source changes produces identical output (minus timestamp)
+
+### Backlog YAML Schema (Authoritative)
+
+```yaml
+# backlog.yaml — Flat prioritized backlog
+# Generated by generate-backlog skill
+# Last generated: {ISO-8601 timestamp}
+
+backlog:
+  - id: "5-5-explicit-parameter-passing"   # Story ID: {epic}-{story}-{slug}
+    type: story                             # enum: story | bug
+    epic: 5                                 # int for stories, null for bugs
+    title: "Explicit Parameter Passing"     # always quoted
+    priority: 1                             # sequential int, 1 = highest
+    status: backlog                         # from sprint-status.yaml
+    sprint: null                            # sprint-{id} if assigned, null if not
+    severity: null                          # null for stories
+  - id: "BUG-path-spaces"                  # Bug ID: BUG-{slug}
+    type: bug
+    epic: null                              # bugs don't belong to epics (FR64)
+    title: "Fix space-in-path bug"
+    priority: 2
+    status: backlog
+    sprint: "sprint-3"                      # assigned to sprint-3
+    severity: high                          # bug-specific: critical|high|medium|low
+```
+
+### Relationship to sprint-status.yaml
+
+- `sprint-status.yaml` continues to exist but is now a **derived view** — generated from `backlog.yaml` + `sprints/sprint-{id}.yaml` files
+- Story 17.8 implements the derivation logic
+- Until 17.8 lands, `sprint-status.yaml` remains the manual source of truth for story status
+- The `generate-backlog` skill READS status from `sprint-status.yaml` but NEVER WRITES to it
+
+### What Changes from Current Model
+
+| Aspect | Current (Epic 12) | New (Epic 17) |
+|---|---|---|
+| Priority source | Epic order in sprint-status.yaml | `priority` field in backlog.yaml |
+| Item ordering | Grouped by epic | Flat, interleaved by priority |
+| Bug inclusion | Discovered via glob, not in status file | First-class entries in backlog.yaml |
+| Sprint assignment | Only in sprint-plan files | Also annotated in backlog.yaml `sprint` field |
+| Done items | Remain in sprint-status.yaml forever | Excluded from backlog (archived in done/) |
+
+### Impact on Other Epic 17 Stories
+
+- **17.4 (Backlog-to-Sprint):** Reads backlog.yaml to present unassigned items, writes `sprint` field when assigning
+- **17.5 (Sprint-to-Backlog):** Clears `sprint` field when removing from sprint
+- **17.6 (Done Item Cleanup):** Removes done items from backlog.yaml
+- **17.7 (Prioritization):** Reorders `priority` field in backlog.yaml
+- **17.8 (Sprint Status Display):** Reads backlog.yaml for unassigned items section
+
+### Critical Guardrails (Story-Specific)
+
+- Do NOT modify any files under `_bmad/bmm/workflows/` or `_bmad/core/`
+- Do NOT add npm dependencies
+- Do NOT modify `lib/installer.js`, `lib/agents.js`, or `bin/cli.js`
+- Do NOT modify `sprint-status.yaml` — only READ from it for status lookup
+- Do NOT include `done` items in the backlog — they are archived
+- Do NOT auto-assign priorities based on severity or business value — initial generation uses epic order, subsequent prioritization is via Story 17.7
+- Backlog must preserve existing priority/sprint data on re-generation (idempotent merge)
+- Always quote the `title` field in YAML output
+- Bug entries MUST have `epic: null` (FR64)
+- **Modify SKILL.md, not just workflow.md** — SKILL.md is the file invoked by skill resolution
+
+### Project Structure Notes
+
+- **Files to create:**
+  - `lib/bmad-extension/skills/generate-backlog/SKILL.md` — new skill (authoritative)
+  - `lib/bmad-extension/skills/generate-backlog/bmad-skill-manifest.yaml` — skill manifest
+- **Files to modify:**
+  - `lib/bmad-extension/module-help.csv` — add generate-backlog row
+  - `_bmad-output/implementation-artifacts/sprint-management-guardrails.md` — add backlog schema, data authority rules (assumes Story 17.1 has renamed this file)
+- **Files to create (output):**
+  - `_bmad-output/implementation-artifacts/backlog.yaml` — generated output (not committed to template, generated at runtime)
+- **Files NOT to touch:**
+  - `_bmad-output/implementation-artifacts/sprint-status.yaml` (read-only from this workflow)
+  - Any files under `_bmad/` or `lib/installer.js`
+  - Sprint files under `sprints/` (read-only for sprint assignment lookup)
+
+### References
+
+- [Source: _bmad-output/planning-artifacts/epics.md#Epic 17, Story 17.2] — Story requirements and acceptance criteria
+- [Source: _bmad-output/planning-artifacts/prd.md#FR65] — Flat backlog model, not grouped by epic
+- [Source: _bmad-output/planning-artifacts/prd.md#FR66] — Sprint capacity as item count
+- [Source: _bmad-output/planning-artifacts/prd.md#FR128] — Bugs as story type in backlog
+- [Source: _bmad-output/planning-artifacts/prd.md#FR130] — Done items removed from sprint status
+- [Source: _bmad-output/implementation-artifacts/17-1-sprint-entity-model.md] — Sprint YAML schema, Item ID Format Contract
+- [Source: _bmad-output/implementation-artifacts/epic-11-12-shared-guardrails.md] — Current guardrails (to be renamed/updated by 17.1)
+- [Source: lib/bmad-extension/skills/add-to-sprint/SKILL.md] — Current add-to-sprint workflow that reads from sprint-status.yaml (to be reworked in 17.4)
+- [Source: lib/bmad-extension/skills/create-bug-story/SKILL.md] — Bug story creation workflow and file format
+- [Source: lib/bmad-extension/module-help.csv] — Workflow registration
+
+### Git Intelligence
+
+Recent commits show Epic 15/16 patterns. Key conventions:
+- Conventional commit format: `feat(epic-17): story 17-2 flat backlog model`
+- SKILL.md + bmad-skill-manifest.yaml is the standard skill package format
+- `module-help.csv` uses `skill:{name}` to resolve to SKILL.md
+
+## Change Log
+
+- 2026-03-30: Story implemented — generate-backlog skill created with flat backlog YAML schema, registered in module-help.csv, guardrails updated with backlog model and data authority rules.
+
+## Dev Agent Record
+
+### Agent Model Used
+
+Claude Opus 4.6 (1M context)
+
+### Debug Log References
+
+None — clean implementation.
+
+### Completion Notes List
+
+Created generate-backlog skill (SKILL.md + manifest). Registered in module-help.csv. Updated guardrails with backlog model schema.
+
+### File List
+
+- `lib/bmad-extension/skills/generate-backlog/SKILL.md` (new)
+- `lib/bmad-extension/skills/generate-backlog/bmad-skill-manifest.yaml` (new)
+- `lib/bmad-extension/module-help.csv` (modified)
+- `sprint-management-guardrails.md` (modified)

package/_bmad-output/implementation-artifacts/done/17-3-bug-as-story-type.md

@@ -0,0 +1,208 @@
+# Story 17.3: Bug as Story Type
+
+Status: review
+
+<!-- Note: Validation is optional. Run validate-create-story for quality check before dev-story. -->
+
+## Story
+
+As a **Test Engineer**,
+I want bugs to appear in the backlog alongside stories as a distinct type,
+So that bugs are prioritized and assigned to sprints using the same workflow as stories.
+
+## Acceptance Criteria
+
+1. **Given** a bug is created via the bug-story workflow (Epic 11, FR61),
+   **When** the bug story file is created,
+   **Then** it is added to the backlog with `type: bug`,
+   **And** it includes bug-specific fields: `severity` (critical/high/medium/low), `version_found`, `bug_type`.
+
+2. **Given** bugs and stories coexist in the backlog,
+   **When** the backlog is displayed or used for sprint planning,
+   **Then** bugs are visually distinguished (type field) but sorted by the same priority field as stories,
+   **And** a critical bug can be prioritized above any story.
+
+3. **Given** a bug follows the same lifecycle as a story,
+   **When** the bug progresses through statuses,
+   **Then** it uses the same flow: `backlog -> ready-for-dev -> in-progress -> review -> done`,
+   **And** done bugs are archived the same way as done stories (FR130, FR131).
+
+## Tasks / Subtasks
+
+- [x] Task 1: Extend bug story file format with new fields (AC: #1)
+  - [x] 1.1: Update `lib/bmad-extension/skills/create-bug-story/SKILL.md` to gather two additional optional fields:
+    - `version_found` (string, optional): The version/commit where the bug was found (e.g., "3.0.0", "commit abc123"). Press Enter to skip -> stored as empty string.
+    - `bug_type` (enum, optional): Classification of bug. Options: `regression | functional | performance | security | ui | data | integration | other`. Press Enter to skip -> defaults to `functional`.
+  - [x] 1.2: Add `version_found` and `bug_type` prompts as a new step between current Step 3 (expected/actual) and Step 4 (root cause):
+    - Prompt: "What version or commit was this bug found in? (optional, press Enter to skip)"
+    - Prompt: "What type of bug is this? [regression / functional / performance / security / ui / data / integration / other] (optional, defaults to functional)"
+    - Validate bug_type against the enum list; reject invalid values with error and re-prompt
+  - [x] 1.3: Update YAML frontmatter template in Step 6 to include new fields:
+    ```yaml
+    ---
+    type: bug
+    severity: {{severity}}
+    title: {{bug_title}}
+    version_found: "{{version_found}}"
+    bug_type: {{bug_type}}
+    status: backlog
+    ---
+    ```
+  - [x] 1.4: Add `status: backlog` to the YAML frontmatter — this is the initial lifecycle status for newly created bugs, enabling the backlog generator (Story 17.2) to read bug status directly from the file
+  - [x] 1.5: Update the confirmation display in Step 5 to show the new fields
+
+- [x] Task 2: Add backlog integration to create-bug-story (AC: #1, #2)
+  - [x] 2.1: After writing the bug file in Step 6, add a new Step 7 that checks if `backlog.yaml` exists:
+    - If exists: read it, append new bug entry at the end (lowest priority), re-number priorities, write back
+    - If not exists: note in output that user should run `/generate-backlog` to include this bug
+  - [x] 2.2: Bug entry format for backlog.yaml (per Story 17.2 schema):
+    ```yaml
+    - id: "BUG-{{title_slug}}"
+      type: bug
+      epic: null
+      title: "{{bug_title}}"
+      priority: {{next_priority}}
+      status: backlog
+      sprint: null
+      severity: {{severity}}
+    ```
+  - [x] 2.3: After appending to backlog, display: "Bug added to backlog at priority {{priority}}. Use `/prioritize-backlog` to adjust priority."
+
+- [x] Task 3: Update backlog schema for bug-specific fields (AC: #1, #2)
+  - [x] 3.1: Update `_bmad-output/implementation-artifacts/sprint-management-guardrails.md` Backlog Model section (added by Story 17.2) to document:
+    - Bug entries have `severity` field (non-null)
+    - Bug entries have `epic: null` (invariant)
+    - Bug entries use `BUG-{slug}` ID format (uppercase prefix)
+  - [x] 3.2: Document the bug lifecycle: `backlog -> ready-for-dev -> in-progress -> review -> done`
+  - [x] 3.3: Document that bug status is tracked in the bug file's YAML frontmatter `status` field (not in sprint-status.yaml)
+
+- [x] Task 4: Ensure lifecycle parity with stories (AC: #3)
+  - [x] 4.1: Verify that the dev-story workflow can process bug files (it reads the story file by path — bug files follow the same markdown structure with different frontmatter)
+  - [x] 4.2: Add a note in SKILL.md output that done bugs are archived by Story 17.6's cleanup process to `done/BUG-{slug}.md`
+  - [x] 4.3: Verify the create-bug-story SKILL.md slug derivation produces IDs compatible with the Item ID Format Contract from Story 17.1:
+    - Bug file: `bug-{slug}.md` (lowercase prefix)
+    - Bug ID in backlog/sprint: `BUG-{slug}` (uppercase prefix)
+    - These must use the same slug — just different prefix casing
+
+- [x] Task 5: Update module-help.csv description (AC: #1)
+  - [x] 5.1: Update the `create-bug-story` row in `lib/bmad-extension/module-help.csv` description to mention backlog integration:
+    - Current: "Create a structured bug story from a detected defect and add to backlog."
+    - Updated: "Create a structured bug story with severity and type classification, add to backlog.yaml."
+
+- [x] Task 6: Verify (AC: #1, #2, #3)
+  - [x] 6.1: Trace create-bug-story SKILL.md — confirm new fields are gathered, validated, and written to frontmatter
+  - [x] 6.2: Verify bug entry in backlog.yaml follows schema (type: bug, epic: null, severity present)
+  - [x] 6.3: Verify `version_found` and `bug_type` default handling (empty string and "functional" respectively)
+  - [x] 6.4: Verify `status: backlog` is in frontmatter for new bugs
+  - [x] 6.5: Verify slug derivation: `bug-{slug}.md` filename maps to `BUG-{slug}` backlog ID
+
+## Dev Notes
+
+### Architecture Compliance
+
+- **SKILL.md is the authoritative file:** The create-bug-story skill is at `lib/bmad-extension/skills/create-bug-story/SKILL.md`
+- **Extension module pattern:** Modifications stay in `lib/bmad-extension/skills/create-bug-story/`
+- **Backward compatible:** Existing bug files without `version_found`, `bug_type`, or `status` fields still work — the generate-backlog skill (17.2) treats missing fields as defaults
+- **Bug ID Format Contract:** Bug file is `bug-{slug}.md`, Bug ID in backlog/sprint is `BUG-{slug}` — same slug, different prefix casing
+
+### Extended Bug Frontmatter Schema
+
+```yaml
+---
+type: bug                    # always "bug"
+severity: critical           # critical | high | medium | low
+title: "Login fails"         # always quoted
+version_found: "3.0.0"      # optional, empty string if skipped
+bug_type: regression         # regression|functional|performance|security|ui|data|integration|other
+status: backlog              # backlog|ready-for-dev|in-progress|review|done
+---
+```
+
+### Bug Lifecycle (Same as Stories)
+
+```
+backlog -> ready-for-dev -> in-progress -> review -> done
+```
+
+- Bug status is tracked in the bug file's own YAML frontmatter `status` field
+- Stories track status in `sprint-status.yaml` — bugs do NOT appear there
+- Done bugs are archived to `done/BUG-{slug}.md` by Story 17.6
+
+### Backward Compatibility
+
+Existing `bug-*.md` files created before this story will not have `version_found`, `bug_type`, or `status` fields. Consumers must handle:
+- Missing `version_found` -> treat as empty/unknown
+- Missing `bug_type` -> treat as `functional`
+- Missing `status` -> treat as `backlog`
+
+### Impact on Other Epic 17 Stories
+
+- **17.2 (Flat Backlog):** generate-backlog reads bug frontmatter including new fields
+- **17.4 (Backlog-to-Sprint):** Displays bug type and severity in prioritization UI
+- **17.6 (Done Item Cleanup):** Archives done bugs to `done/` subfolder
+- **17.7 (Prioritization):** Uses severity as a prioritization criterion for bugs
+- **17.8 (Sprint Status Display):** Shows bug type distinction in sprint view
+
+### Critical Guardrails (Story-Specific)
+
+- Do NOT modify any files under `_bmad/bmm/workflows/` or `_bmad/core/`
+- Do NOT add npm dependencies
+- Do NOT modify `lib/installer.js`, `lib/agents.js`, or `bin/cli.js`
+- Do NOT modify `sprint-status.yaml` — bugs are NOT tracked there
+- Do NOT change existing bug file format in a breaking way — new fields are additive only
+- Bug entries in backlog MUST have `epic: null` (FR64)
+- Bug IDs MUST use `BUG-{slug}` format with uppercase prefix
+- `version_found` and `bug_type` MUST be optional (backward compatible with existing bugs)
+
+### Project Structure Notes
+
+- **Files to modify (primary):**
+  - `lib/bmad-extension/skills/create-bug-story/SKILL.md` — add version_found, bug_type, status fields; add backlog integration step
+  - `lib/bmad-extension/module-help.csv` — update create-bug-story description
+  - `_bmad-output/implementation-artifacts/sprint-management-guardrails.md` — document bug lifecycle and frontmatter schema
+- **Files NOT to touch:**
+  - `lib/bmad-extension/workflows/create-bug-story/workflow.md` — legacy copy, sync or leave (SKILL.md is authoritative)
+  - `sprint-status.yaml` — bugs are not tracked here
+  - Any files under `_bmad/` or `lib/installer.js`
+
+### References
+
+- [Source: _bmad-output/planning-artifacts/epics.md#Epic 17, Story 17.3] — Story requirements and acceptance criteria
+- [Source: _bmad-output/planning-artifacts/prd.md#FR128] — Bugs as story type in backlog with same lifecycle
+- [Source: _bmad-output/planning-artifacts/prd.md#FR65] — Flat backlog containing both stories and bugs
+- [Source: _bmad-output/planning-artifacts/prd.md#FR130] — Done items removed from sprint status
+- [Source: _bmad-output/planning-artifacts/prd.md#FR131] — Done story files moved to done/ subfolder
+- [Source: _bmad-output/implementation-artifacts/17-1-sprint-entity-model.md] — Item ID Format Contract (BUG-{slug})
+- [Source: _bmad-output/implementation-artifacts/17-2-flat-backlog-model.md] — Backlog YAML schema
+- [Source: lib/bmad-extension/skills/create-bug-story/SKILL.md] — Current bug creation workflow to extend
+- [Source: lib/bmad-extension/module-help.csv] — Workflow registration
+
+### Git Intelligence
+
+Recent commits show Epic 15/16 patterns. Key conventions:
+- Conventional commit format: `feat(epic-17): story 17-3 bug as story type`
+- SKILL.md modifications follow the additive pattern — extend, don't rewrite
+
+## Change Log
+
+- 2026-03-30: Story implemented — extended create-bug-story with version_found, bug_type, status fields and backlog integration.
+
+## Dev Agent Record
+
+### Agent Model Used
+
+Claude Opus 4.6 (1M context)
+
+### Debug Log References
+
+None — clean implementation.
+
+### Completion Notes List
+
+Extended create-bug-story SKILL.md with version_found, bug_type, status fields. Added backlog integration step. Updated module-help.csv description. Updated guardrails with bug lifecycle.
+
+### File List
+
+- `lib/bmad-extension/skills/create-bug-story/SKILL.md` (modified)
+- `lib/bmad-extension/module-help.csv` (modified)
+- `sprint-management-guardrails.md` (modified)