shipquick 1.0.0

package/_bmad-safe/bmm-safe/workflows/4-implementation/sprint-status/instructions.md

@@ -0,0 +1,229 @@
+# Sprint Status - Multi-Mode Service
+
+<critical>The workflow execution engine is governed by: {project-root}/_bmad-safe/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project-root}/_bmad-safe/bmm-safe/workflows/4-implementation/sprint-status/workflow.yaml</critical>
+<critical>Modes: interactive (default), validate, data</critical>
+<critical>⚠️ ABSOLUTELY NO TIME ESTIMATES. Do NOT mention hours, days, weeks, or timelines.</critical>
+
+<workflow>
+
+<step n="0" goal="Determine execution mode">
+  <action>Set mode = {{mode}} if provided by caller; otherwise mode = "interactive"</action>
+
+  <check if="mode == data">
+    <action>Jump to Step 20</action>
+  </check>
+
+  <check if="mode == validate">
+    <action>Jump to Step 30</action>
+  </check>
+
+  <check if="mode == interactive">
+    <action>Continue to Step 1</action>
+  </check>
+</step>
+
+<step n="1" goal="Locate sprint status file">
+  <action>Try {sprint_status_file}</action>
+  <check if="file not found">
+    <output>❌ sprint-status.yaml not found.
+Run `/bmad:bmm:workflows:sprint-planning` to generate it, then rerun sprint-status.</output>
+    <action>Exit workflow</action>
+  </check>
+  <action>Continue to Step 2</action>
+</step>
+
+<step n="2" goal="Read and parse sprint-status.yaml">
+  <action>Read the FULL file: {sprint_status_file}</action>
+  <action>Parse fields: generated, project, project_key, tracking_system, story_location</action>
+  <action>Parse development_status map. Classify keys:</action>
+  - Epics: keys starting with "epic-" (and not ending with "-retrospective")
+  - Retrospectives: keys ending with "-retrospective"
+  - Stories: everything else (e.g., 1-2-login-form)
+  <action>Map legacy story status "drafted" → "ready-for-dev"</action>
+  <action>Count story statuses: backlog, ready-for-dev, in-progress, review, done</action>
+  <action>Map legacy epic status "contexted" → "in-progress"</action>
+  <action>Count epic statuses: backlog, in-progress, done</action>
+  <action>Count retrospective statuses: optional, done</action>
+
+<action>Validate all statuses against known values:</action>
+
+- Valid story statuses: backlog, ready-for-dev, in-progress, review, done, drafted (legacy)
+- Valid epic statuses: backlog, in-progress, done, contexted (legacy)
+- Valid retrospective statuses: optional, done
+
+  <check if="any status is unrecognized">
+    <output>
+⚠️ **Unknown status detected:**
+{{#each invalid_entries}}
+
+- `{{key}}`: "{{status}}" (not recognized)
+  {{/each}}
+
+**Valid statuses:**
+
+- Stories: backlog, ready-for-dev, in-progress, review, done
+- Epics: backlog, in-progress, done
+- Retrospectives: optional, done
+  </output>
+  <ask>How should these be corrected?
+  {{#each invalid_entries}}
+  {{@index}}. {{key}}: "{{status}}" → [select valid status]
+  {{/each}}
+
+Enter corrections (e.g., "1=in-progress, 2=backlog") or "skip" to continue without fixing:</ask>
+<check if="user provided corrections">
+<action>Update sprint-status.yaml with corrected values</action>
+<action>Re-parse the file with corrected statuses</action>
+</check>
+</check>
+
+<action>Detect risks:</action>
+
+- IF any story has status "review": suggest `/bmad:bmm:workflows:code-review`
+- IF any story has status "in-progress" AND no stories have status "ready-for-dev": recommend staying focused on active story
+- IF all epics have status "backlog" AND no stories have status "ready-for-dev": prompt `/bmad:bmm:workflows:create-story`
+- IF `generated` timestamp is more than 7 days old: warn "sprint-status.yaml may be stale"
+- IF any story key doesn't match an epic pattern (e.g., story "5-1-..." but no "epic-5"): warn "orphaned story detected"
+- IF any epic has status in-progress but has no associated stories: warn "in-progress epic has no stories"
+  </step>
+
+<step n="3" goal="Select next action recommendation">
+  <action>Pick the next recommended workflow using priority:</action>
+  <note>When selecting "first" story: sort by epic number, then story number (e.g., 1-1 before 1-2 before 2-1)</note>
+  1. If any story status == in-progress → recommend `dev-story` for the first in-progress story
+  2. Else if any story status == review → recommend `code-review` for the first review story
+  3. Else if any story status == ready-for-dev → recommend `dev-story`
+  4. Else if any story status == backlog → recommend `create-story`
+  5. Else if any retrospective status == optional → recommend `retrospective`
+  6. Else → All implementation items done; congratulate the user - you both did amazing work together!
+  <action>Store selected recommendation as: next_story_id, next_workflow_id, next_agent (SM/DEV as appropriate)</action>
+</step>
+
+<step n="4" goal="Display summary">
+  <output>
+## 📊 Sprint Status
+
+- Project: {{project}} ({{project_key}})
+- Tracking: {{tracking_system}}
+- Status file: {sprint_status_file}
+
+**Stories:** backlog {{count_backlog}}, ready-for-dev {{count_ready}}, in-progress {{count_in_progress}}, review {{count_review}}, done {{count_done}}
+
+**Epics:** backlog {{epic_backlog}}, in-progress {{epic_in_progress}}, done {{epic_done}}
+
+**Next Recommendation:** /bmad:bmm:workflows:{{next_workflow_id}} ({{next_story_id}})
+
+{{#if risks}}
+**Risks:**
+{{#each risks}}
+
+- {{this}}
+  {{/each}}
+  {{/if}}
+
+  </output>
+  </step>
+
+<step n="5" goal="Offer actions">
+  <ask>Pick an option:
+1) Run recommended workflow now
+2) Show all stories grouped by status
+3) Show raw sprint-status.yaml
+4) Exit
+Choice:</ask>
+
+  <check if="choice == 1">
+    <output>Run `/bmad:bmm:workflows:{{next_workflow_id}}`.
+If the command targets a story, set `story_key={{next_story_id}}` when prompted.</output>
+  </check>
+
+  <check if="choice == 2">
+    <output>
+### Stories by Status
+- In Progress: {{stories_in_progress}}
+- Review: {{stories_in_review}}
+- Ready for Dev: {{stories_ready_for_dev}}
+- Backlog: {{stories_backlog}}
+- Done: {{stories_done}}
+    </output>
+  </check>
+
+  <check if="choice == 3">
+    <action>Display the full contents of {sprint_status_file}</action>
+  </check>
+
+  <check if="choice == 4">
+    <action>Exit workflow</action>
+  </check>
+</step>
+
+<!-- ========================= -->
+<!-- Data mode for other flows -->
+<!-- ========================= -->
+
+<step n="20" goal="Data mode output">
+  <action>Load and parse {sprint_status_file} same as Step 2</action>
+  <action>Compute recommendation same as Step 3</action>
+  <template-output>next_workflow_id = {{next_workflow_id}}</template-output>
+  <template-output>next_story_id = {{next_story_id}}</template-output>
+  <template-output>count_backlog = {{count_backlog}}</template-output>
+  <template-output>count_ready = {{count_ready}}</template-output>
+  <template-output>count_in_progress = {{count_in_progress}}</template-output>
+  <template-output>count_review = {{count_review}}</template-output>
+  <template-output>count_done = {{count_done}}</template-output>
+  <template-output>epic_backlog = {{epic_backlog}}</template-output>
+  <template-output>epic_in_progress = {{epic_in_progress}}</template-output>
+  <template-output>epic_done = {{epic_done}}</template-output>
+  <template-output>risks = {{risks}}</template-output>
+  <action>Return to caller</action>
+</step>
+
+<!-- ========================= -->
+<!-- Validate mode -->
+<!-- ========================= -->
+
+<step n="30" goal="Validate sprint-status file">
+  <action>Check that {sprint_status_file} exists</action>
+  <check if="missing">
+    <template-output>is_valid = false</template-output>
+    <template-output>error = "sprint-status.yaml missing"</template-output>
+    <template-output>suggestion = "Run sprint-planning to create it"</template-output>
+    <action>Return</action>
+  </check>
+
+<action>Read and parse {sprint_status_file}</action>
+
+<action>Validate required metadata fields exist: generated, project, project_key, tracking_system, story_location</action>
+<check if="any required field missing">
+<template-output>is_valid = false</template-output>
+<template-output>error = "Missing required field(s): {{missing_fields}}"</template-output>
+<template-output>suggestion = "Re-run sprint-planning or add missing fields manually"</template-output>
+<action>Return</action>
+</check>
+
+<action>Verify development_status section exists with at least one entry</action>
+<check if="development_status missing or empty">
+<template-output>is_valid = false</template-output>
+<template-output>error = "development_status missing or empty"</template-output>
+<template-output>suggestion = "Re-run sprint-planning or repair the file manually"</template-output>
+<action>Return</action>
+</check>
+
+<action>Validate all status values against known valid statuses:</action>
+
+- Stories: backlog, ready-for-dev, in-progress, review, done (legacy: drafted)
+- Epics: backlog, in-progress, done (legacy: contexted)
+- Retrospectives: optional, done
+  <check if="any invalid status found">
+  <template-output>is_valid = false</template-output>
+  <template-output>error = "Invalid status values: {{invalid_entries}}"</template-output>
+  <template-output>suggestion = "Fix invalid statuses in sprint-status.yaml"</template-output>
+  <action>Return</action>
+  </check>
+
+<template-output>is_valid = true</template-output>
+<template-output>message = "sprint-status.yaml valid: metadata complete, all statuses recognized"</template-output>
+</step>
+
+</workflow>

package/_bmad-safe/bmm-safe/workflows/4-implementation/sprint-status/workflow.yaml

@@ -0,0 +1,35 @@
+# Sprint Status - Implementation Tracker
+name: sprint-status
+description: "Summarize sprint-status.yaml, surface risks, and route to the right implementation workflow."
+author: "BMad"
+
+# Critical variables from config
+config_source: "{project-root}/_bmad-safe/bmm-safe/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+date: system-generated
+implementation_artifacts: "{config_source}:implementation_artifacts"
+planning_artifacts: "{config_source}:planning_artifacts"
+
+# Workflow components
+installed_path: "{project-root}/_bmad-safe/bmm-safe/workflows/4-implementation/sprint-status"
+instructions: "{installed_path}/instructions.md"
+
+# Inputs
+variables:
+  sprint_status_file: "{implementation_artifacts}/sprint-status.yaml"
+  tracking_system: "file-system"
+
+# Smart input file references
+input_file_patterns:
+  sprint_status:
+    description: "Sprint status file generated by sprint-planning"
+    whole: "{implementation_artifacts}/sprint-status.yaml"
+    load_strategy: "FULL_LOAD"
+
+# Standalone so IDE commands get generated
+standalone: true
+
+# No web bundle needed

package/_bmad-safe/bmm-safe/workflows/4-implementation/story-refinement/instructions.md

@@ -0,0 +1,72 @@
+# Story Refinement Instructions
+
+<critical>The workflow execution engine is governed by: {project-root}/\_bmad-safe/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project-root}/\_bmad-safe/bmm-safe/workflows/4-implementation/story-refinement/workflow.yaml</critical>
+
+## Purpose
+
+Break Features into team-ready Stories with clear Acceptance Criteria.
+
+---
+
+## Refinement Process
+
+### Step 1: Select Feature
+
+- Choose Feature from PI plan
+- Review benefit hypothesis
+
+### Step 2: Identify Stories
+
+- What Stories deliver this Feature?
+- Consider User Stories and Enabler Stories
+
+### Step 3: Write Stories
+
+Use template: `{project-root}/_bmad-safe/bmm-safe/templates/safe/story-template.md`
+
+**Format:**
+
+```
+As a [user type]
+I want [capability]
+So that [benefit]
+```
+
+### Step 4: Define Acceptance Criteria
+
+**Given-When-Then format:**
+
+```
+Given [context]
+When [action]
+Then [expected result]
+```
+
+### Step 5: Estimate
+
+- Use Story Points (1, 2, 3, 5, 8, 13)
+- If > 8, split the Story
+
+### Step 6: Validate INVEST
+
+- Independent
+- Negotiable
+- Valuable
+- Estimable
+- Small
+- Testable
+
+---
+
+## Splitting Large Stories
+
+Use: `{project-root}/_bmad-safe/bmm-safe/tasks/split-story.md`
+
+---
+
+## Outputs
+
+1. Ready Stories in backlog
+2. Clear Acceptance Criteria
+3. Story estimates

package/_bmad-safe/bmm-safe/workflows/4-implementation/story-refinement/workflow.yaml

@@ -0,0 +1,53 @@
+# Story Refinement - Break Features into Team-Ready Stories
+name: story-refinement
+description: "Refine Features into team-ready Stories with clear acceptance criteria and INVEST principles"
+author: "BMad Method - SAFe"
+
+# Critical variables from config
+config_source: "{project-root}/_bmad-safe/bmm-safe/config.yaml"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+user_skill_level: "{config_source}:user_skill_level"
+document_output_language: "{config_source}:document_output_language"
+date: system-generated
+implementation_artifacts: "{config_source}:implementation_artifacts"
+planning_artifacts: "{config_source}:planning_artifacts"
+output_folder: "{implementation_artifacts}"
+
+# Workflow components
+installed_path: "{project-root}/_bmad-safe/bmm-safe/workflows/4-implementation/story-refinement"
+instructions: "{installed_path}/instructions.md"
+template_story: "{project-root}/_bmad-safe/bmm-safe/templates/safe/story-template.md"
+checklist_dor: "{project-root}/_bmad-safe/bmm-safe/checklists/definition-of-ready.md"
+task_split: "{project-root}/_bmad-safe/bmm-safe/tasks/split-story.md"
+
+# Variables and inputs
+variables:
+  project_context: "**/project-context.md"
+  project_name: "{config_source}:project_name"
+  
+  # Refinement inputs
+  features: "{planning_artifacts}/*feature*.md"
+  team_backlog: "{implementation_artifacts}/*backlog*.md"
+  pi_objectives: "{implementation_artifacts}/*pi-objectives*.md"
+
+# Smart input file references
+input_file_patterns:
+  features:
+    description: "Features to refine into stories"
+    whole: "{planning_artifacts}/*feature*.md"
+    load_strategy: "FULL_LOAD"
+  backlog:
+    description: "Current team backlog"
+    whole: "{implementation_artifacts}/*backlog*.md"
+    load_strategy: "SCAN_HEADERS"
+
+# Output configuration
+default_output_file: "{implementation_artifacts}/refined-stories.md"
+
+# Workflow mode
+workflow:
+  type: single-mode
+  mode: Create
+
+standalone: true

package/_bmad-safe/bmm-safe/workflows/4-implementation/system-demo/instructions.md

@@ -0,0 +1,66 @@
+# System Demo Instructions
+
+<critical>The workflow execution engine is governed by: {project-root}/\_bmad-safe/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project-root}/\_bmad-safe/bmm-safe/workflows/4-implementation/system-demo/workflow.yaml</critical>
+
+## Purpose
+
+Demonstrate the integrated increment to stakeholders at the end of each PI.
+
+---
+
+## Preparation (1 week before)
+
+1. Collect demo-ready Features from all teams
+2. Create demo script with flow
+3. Prepare demo environment
+4. Confirm Business Owner attendance
+5. Send agenda to stakeholders
+
+---
+
+## Agenda (1-2 hours)
+
+### 1. Welcome & PI Context (5 min)
+
+- RTE opens and sets context
+- Review PI goals
+
+### 2. Feature Demonstrations (45-60 min)
+
+- Each team demos completed Features
+- Focus on business value, not technical details
+- Show integrated solution where possible
+
+### 3. Business Value Assessment (15 min)
+
+- Business Owners assess value delivered
+- Compare actual vs planned objectives
+
+### 4. Stakeholder Feedback (15 min)
+
+- Open Q&A
+- Collect feedback for improvement
+
+### 5. Next PI Preview (10 min)
+
+- High-level roadmap for next PI
+- Set expectations
+
+---
+
+## Outputs
+
+1. Demo notes
+2. Business Value assessment scores
+3. Stakeholder feedback
+4. Items for I&A
+
+---
+
+## Tips
+
+- Keep demos focused on user outcomes
+- Rehearse before the event
+- Have backup plan for technical issues
+- Celebrate team achievements

package/_bmad-safe/bmm-safe/workflows/4-implementation/system-demo/workflow.yaml

@@ -0,0 +1,49 @@
+# System Demo - PI System Demo Event
+name: system-demo
+description: "Facilitate PI System Demo at the end of each PI to showcase integrated work from all teams"
+author: "BMad Method - SAFe"
+
+# Critical variables from config
+config_source: "{project-root}/_bmad-safe/bmm-safe/config.yaml"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+user_skill_level: "{config_source}:user_skill_level"
+document_output_language: "{config_source}:document_output_language"
+date: system-generated
+implementation_artifacts: "{config_source}:implementation_artifacts"
+output_folder: "{implementation_artifacts}"
+
+# Workflow components
+installed_path: "{project-root}/_bmad-safe/bmm-safe/workflows/4-implementation/system-demo"
+instructions: "{installed_path}/instructions.md"
+
+# Variables and inputs
+variables:
+  project_context: "**/project-context.md"
+  project_name: "{config_source}:project_name"
+  
+  # System Demo inputs
+  pi_objectives: "{implementation_artifacts}/*pi-objectives*.md"
+  completed_features: "{planning_artifacts}/*feature*.md"
+  sprint_status: "{implementation_artifacts}/sprint-status.yaml"
+
+# Smart input file references
+input_file_patterns:
+  features:
+    description: "Completed features to demo"
+    whole: "{planning_artifacts}/*feature*.md"
+    load_strategy: "FULL_LOAD"
+  stories:
+    description: "Completed stories this PI"
+    whole: "{implementation_artifacts}/*story*.md"
+    load_strategy: "SCAN_HEADERS"
+
+# Output configuration
+default_output_file: "{implementation_artifacts}/system-demo-notes.md"
+
+# Workflow mode
+workflow:
+  type: single-mode
+  mode: Facilitate
+
+standalone: true

package/_bmad-safe/bmm-safe/workflows/4-implementation/team-backlog/instructions.md

@@ -0,0 +1,59 @@
+# Team Backlog Instructions
+
+<critical>The workflow execution engine is governed by: {project-root}/\_bmad-safe/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project-root}/\_bmad-safe/bmm-safe/workflows/4-implementation/team-backlog/workflow.yaml</critical>
+
+## Purpose
+
+The Product Owner's primary artifact for managing team work.
+
+---
+
+## Backlog Components
+
+1. **User Stories** - Deliver user value
+2. **Enabler Stories** - Technical work enabling features
+3. **Defects** - Bugs to fix
+4. **Tech Debt** - Code quality improvements
+
+---
+
+## Prioritization Process
+
+### Step 1: Review Current State
+
+- What's in progress?
+- What's blocked?
+- What's completed?
+
+### Step 2: Apply WSJF
+
+Use `{project-root}/_bmad-safe/bmm-safe/tasks/apply-wsjf.md`
+
+### Step 3: Check Alignment
+
+- Do top items align with PI Objectives?
+- Are dependencies managed?
+
+### Step 4: Refinement Status
+
+- Are top 10 items Ready?
+- Use Definition of Ready checklist
+
+---
+
+## Maintenance Frequency
+
+| Activity        | Frequency        |
+| --------------- | ---------------- |
+| Priority review | Weekly           |
+| Refinement      | 2x per Iteration |
+| Full grooming   | Every Iteration  |
+
+---
+
+## Outputs
+
+1. Prioritized backlog
+2. Identified gaps
+3. Ready items for next Iteration

package/_bmad-safe/bmm-safe/workflows/4-implementation/team-backlog/workflow.yaml

@@ -0,0 +1,53 @@
+# Team Backlog Management - Prioritize and Manage Team Backlog
+name: team-backlog
+description: "Manage and prioritize the Team Backlog with WSJF and capacity-based planning"
+author: "BMad Method - SAFe"
+
+# Critical variables from config
+config_source: "{project-root}/_bmad-safe/bmm-safe/config.yaml"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+user_skill_level: "{config_source}:user_skill_level"
+document_output_language: "{config_source}:document_output_language"
+date: system-generated
+implementation_artifacts: "{config_source}:implementation_artifacts"
+planning_artifacts: "{config_source}:planning_artifacts"
+output_folder: "{implementation_artifacts}"
+
+# Workflow components
+installed_path: "{project-root}/_bmad-safe/bmm-safe/workflows/4-implementation/team-backlog"
+instructions: "{installed_path}/instructions.md"
+template_story: "{project-root}/_bmad-safe/bmm-safe/templates/safe/story-template.md"
+template_wsjf: "{project-root}/_bmad-safe/bmm-safe/templates/safe/wsjf-calculator.md"
+task_wsjf: "{project-root}/_bmad-safe/bmm-safe/tasks/apply-wsjf.md"
+
+# Variables and inputs
+variables:
+  project_context: "**/project-context.md"
+  project_name: "{config_source}:project_name"
+  
+  # Backlog inputs
+  pi_objectives: "{implementation_artifacts}/*pi-objectives*.md"
+  features: "{planning_artifacts}/*feature*.md"
+  existing_stories: "{implementation_artifacts}/*story*.md"
+
+# Smart input file references
+input_file_patterns:
+  features:
+    description: "Features from ART backlog"
+    whole: "{planning_artifacts}/*feature*.md"
+    load_strategy: "SCAN_HEADERS"
+  stories:
+    description: "Existing stories in backlog"
+    whole: "{implementation_artifacts}/*story*.md"
+    load_strategy: "SCAN_HEADERS"
+
+# Output configuration
+default_output_file: "{implementation_artifacts}/team-backlog.md"
+
+# Workflow mode
+workflow:
+  type: single-mode
+  mode: Create
+
+standalone: true