bmm-opencode 1.4.3 → 1.6.0

package/_bmad/tea/workflows/testarch/nfr-assess/workflow.md

@@ -0,0 +1,39 @@
+---
+name: testarch-nfr
+description: 'Assess non-functional requirements (performance, security, reliability, maintainability) before release with evidence-based validation'
+web_bundle: true
+---
+
+# Non-Functional Requirements Assessment
+
+**Goal:** Assess non-functional requirements (performance, security, reliability, maintainability) before release with evidence-based validation
+
+**Role:** You are the Master Test Architect.
+
+---
+
+## WORKFLOW ARCHITECTURE
+
+This workflow uses **tri-modal step-file architecture**:
+
+- **Create mode (steps-c/)**: primary execution flow
+- **Validate mode (steps-v/)**: validation against checklist
+- **Edit mode (steps-e/)**: revise existing outputs
+
+---
+
+## INITIALIZATION SEQUENCE
+
+### 1. Mode Determination
+
+"Welcome to the workflow. What would you like to do?"
+
+- **[C] Create** — Run the workflow
+- **[V] Validate** — Validate existing outputs
+- **[E] Edit** — Edit existing outputs
+
+### 2. Route to First Step
+
+- **If C:** Load `steps-c/step-01-load-context.md`
+- **If V:** Load `steps-v/step-01-validate.md`
+- **If E:** Load `steps-e/step-01-assess.md`

package/_bmad/tea/workflows/testarch/nfr-assess/workflow.yaml

@@ -0,0 +1,47 @@
+# Test Architect workflow: nfr-assess
+name: testarch-nfr
+description: "Assess non-functional requirements (performance, security, reliability, maintainability) before release with evidence-based validation"
+author: "BMad"
+
+# Critical variables from config
+config_source: "{project-root}/_bmad/tea/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
+
+# Workflow components
+installed_path: "{project-root}/_bmad/tea/workflows/testarch/nfr-assess"
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+template: "{installed_path}/nfr-report-template.md"
+
+# Variables and inputs
+variables:
+  # NFR category assessment (defaults to all categories)
+  custom_nfr_categories: "" # Optional additional categories beyond standard (security, performance, reliability, maintainability)
+
+# Output configuration
+default_output_file: "{output_folder}/nfr-assessment.md"
+
+# Required tools
+required_tools:
+  - read_file # Read story, test results, metrics, logs, BMad artifacts
+  - write_file # Create NFR assessment, gate YAML, evidence checklist
+  - list_files # Discover test results, metrics, logs
+  - search_repo # Find NFR-related tests and evidence
+  - glob # Find result files matching patterns
+
+tags:
+  - qa
+  - nfr
+  - test-architect
+  - performance
+  - security
+  - reliability
+
+execution_hints:
+  interactive: false # Minimize prompts
+  autonomous: true # Proceed without user input unless blocked
+  iterative: true

package/_bmad/tea/workflows/testarch/teach-me-testing/checklist.md

@@ -0,0 +1,197 @@
+# Teach Me Testing - Quality Checklist
+
+## Workflow Quality Standards
+
+Use this checklist to validate the teaching workflow meets quality standards.
+
+---
+
+## Foundation Quality
+
+- [ ] **workflow.md** exists with proper frontmatter
+- [ ] Tri-modal routing logic present (Create/Edit/Validate)
+- [ ] Configuration loading references correct module (TEA)
+- [ ] First step path correct (`./steps-c/step-01-init.md`)
+- [ ] Folder structure complete (steps-c/, steps-e/, steps-v/, data/, templates/)
+
+---
+
+## Template Quality
+
+- [ ] **progress-template.yaml** has complete schema
+- [ ] All 7 sessions defined with proper structure
+- [ ] Session status tracking fields present (not-started/in-progress/completed)
+- [ ] stepsCompleted array for continuation tracking
+- [ ] **session-notes-template.md** has all required sections
+- [ ] **certificate-template.md** includes all 7 sessions
+
+---
+
+## Step File Quality (CREATE mode)
+
+### Initialization Steps
+
+- [ ] **step-01-init.md** checks for existing progress file
+- [ ] Continuation detection logic works correctly
+- [ ] **step-01b-continue.md** loads progress and routes to session menu
+- [ ] Progress dashboard displays completion status
+
+### Assessment Step
+
+- [ ] **step-02-assess.md** gathers role, experience, goals
+- [ ] Validation for role (QA/Dev/Lead/VP)
+- [ ] Validation for experience (beginner/intermediate/experienced)
+- [ ] Assessment data written to progress file
+
+### Session Menu Hub
+
+- [ ] **step-03-session-menu.md** displays all 7 sessions
+- [ ] Completion indicators shown (✓ completed, 🔄 in-progress, ⬜ not-started)
+- [ ] Branching logic routes to selected session (1-7)
+- [ ] Exit logic (X) routes to completion if all done, otherwise saves and exits
+
+### Session Steps (1-7)
+
+- [ ] Each session loads relevant TEA docs just-in-time
+- [ ] Teaching content presented (mostly autonomous)
+- [ ] Quiz validation with ≥70% threshold
+- [ ] Session notes artifact generated
+- [ ] Progress file updated (status, score, artifact path)
+- [ ] Returns to session menu hub after completion
+
+### Completion Step
+
+- [ ] **step-05-completion.md** verifies all 7 sessions complete
+- [ ] Certificate generated with accurate data
+- [ ] Final progress file update (certificate_generated: true)
+- [ ] Congratulations message shown
+
+---
+
+## Data File Quality
+
+- [ ] **curriculum.yaml** defines all 7 sessions
+- [ ] **role-paths.yaml** maps role customizations
+- [ ] **session-content-map.yaml** references TEA docs/fragments/URLs correctly
+- [ ] **quiz-questions.yaml** has questions for all sessions
+- [ ] **tea-resources-index.yaml** has complete documentation index
+
+---
+
+## Content Quality
+
+### TEA Documentation Integration
+
+- [ ] Local file paths correct (`/docs/*.md`, `/src/testarch/knowledge/*.md`)
+- [ ] Online URLs correct (<https://bmad-code-org.github.io/...>)
+- [ ] GitHub fragment links correct
+- [ ] Triple reference system (local + online + GitHub) implemented
+
+### Role-Based Content
+
+- [ ] QA examples present (practical testing focus)
+- [ ] Dev examples present (integration/TDD focus)
+- [ ] Lead examples present (architecture/patterns focus)
+- [ ] VP examples present (strategy/metrics focus)
+
+### Quiz Quality
+
+- [ ] Questions test understanding, not memorization
+- [ ] 3-5 questions per session
+- [ ] Mix of difficulty levels
+- [ ] Clear correct answers with explanations
+
+---
+
+## Error Handling
+
+- [ ] Corrupted progress file detection
+- [ ] Backup and recovery options
+- [ ] Missing TEA docs fallback (Web-Browsing)
+- [ ] Quiz failure recovery (review or continue)
+- [ ] Session interruption handling (auto-save)
+
+---
+
+## User Experience
+
+- [ ] Clear navigation instructions
+- [ ] Progress visibility (completion percentage, next recommended)
+- [ ] Auto-save after each session
+- [ ] Resume capability works seamlessly
+- [ ] Exit options clear at all decision points
+
+---
+
+## State Management
+
+- [ ] stepsCompleted array updated correctly
+- [ ] Session tracking accurate (status, dates, scores)
+- [ ] Completion percentage calculated correctly
+- [ ] Next recommended session logic works
+- [ ] lastStep and lastContinued timestamps updated
+
+---
+
+## Validation Mode
+
+- [ ] **step-v-01-validate.md** checks all quality standards
+- [ ] Generates validation report
+- [ ] Identifies issues clearly
+- [ ] Provides remediation suggestions
+
+---
+
+## Edit Mode
+
+- [ ] **step-e-01-assess-workflow.md** identifies what to edit
+- [ ] **step-e-02-apply-edits.md** applies modifications safely
+- [ ] Preserves workflow integrity during edits
+
+---
+
+## Documentation
+
+- [ ] **instructions.md** clear and complete
+- [ ] **checklist.md** (this file) comprehensive
+- [ ] README (if present) accurate
+- [ ] Inline comments in complex logic
+
+---
+
+## Performance
+
+- [ ] Just-in-time loading (not loading all docs upfront)
+- [ ] Session steps complete in reasonable time (<5 min)
+- [ ] Quiz validation fast (<1 min)
+- [ ] Progress file writes efficient
+
+---
+
+## Security
+
+- [ ] No hardcoded credentials
+- [ ] File paths use variables
+- [ ] Progress files private to user
+- [ ] No sensitive data in session notes
+
+---
+
+## Completion Criteria
+
+✅ **Workflow is ready for deployment when:**
+
+- All checkboxes above are checked
+- All step files exist and follow standards
+- All templates present and correct
+- Data files complete and accurate
+- Error handling robust
+- User experience smooth
+- Documentation complete
+
+---
+
+**Validation Date:** **\*\***\_\_\_**\*\***
+**Validated By:** **\*\***\_\_\_**\*\***
+**Issues Found:** **\*\***\_\_\_**\*\***
+**Status:** ⬜ Ready for Production | ⬜ Needs Revisions

package/_bmad/tea/workflows/testarch/teach-me-testing/data/curriculum.yaml

@@ -0,0 +1,129 @@
+# TEA Academy Curriculum Structure
+# Defines the 7-session learning path with objectives and content mappings
+
+sessions:
+  - id: session-01-quickstart
+    name: "Quick Start"
+    duration: "30 min"
+    difficulty: beginner
+    objective: "Get immediate value by seeing TEA in action"
+    description: "TEA Lite intro, run automate workflow, understand engagement models"
+    recommended_for:
+      - beginner
+      - intermediate
+      - experienced
+    prerequisites: []
+
+  - id: session-02-concepts
+    name: "Core Concepts"
+    duration: "45 min"
+    difficulty: beginner
+    objective: "Understand WHY behind TEA principles"
+    description: "Risk-based testing, DoD, testing as engineering philosophy"
+    recommended_for:
+      - beginner
+      - intermediate
+    prerequisites: []
+
+  - id: session-03-architecture
+    name: "Architecture & Patterns"
+    duration: "60 min"
+    difficulty: intermediate
+    objective: "Understand TEA patterns and architecture"
+    description: "Fixtures, network-first patterns, data factories, step-file architecture"
+    recommended_for:
+      - intermediate
+      - experienced
+    prerequisites:
+      - session-02-concepts
+
+  - id: session-04-test-design
+    name: "Test Design"
+    duration: "60 min"
+    difficulty: intermediate
+    objective: "Learn risk assessment and coverage planning"
+    description: "Test Design workflow, risk/testability assessment, coverage planning"
+    recommended_for:
+      - intermediate
+      - experienced
+    prerequisites:
+      - session-02-concepts
+
+  - id: session-05-atdd-automate
+    name: "ATDD & Automate"
+    duration: "60 min"
+    difficulty: intermediate
+    objective: "Generate tests with TDD red-green approach"
+    description: "ATDD workflow (red phase), Automate workflow, component TDD, API testing"
+    recommended_for:
+      - intermediate
+      - experienced
+    prerequisites:
+      - session-02-concepts
+
+  - id: session-06-quality-trace
+    name: "Quality & Trace"
+    duration: "45 min"
+    difficulty: intermediate
+    objective: "Audit quality and ensure traceability"
+    description: "Test Review (5 dimensions), Trace workflow, quality metrics"
+    recommended_for:
+      - intermediate
+      - experienced
+    prerequisites:
+      - session-02-concepts
+
+  - id: session-07-advanced
+    name: "Advanced Patterns"
+    duration: "ongoing"
+    difficulty: advanced
+    objective: "Deep-dive into specific knowledge fragments"
+    description: "Menu-driven exploration of 34 knowledge fragments organized by category"
+    recommended_for:
+      - experienced
+    prerequisites: []
+
+# Learning Paths by Experience Level
+learning_paths:
+  beginner:
+    recommended_sequence:
+      - session-01-quickstart
+      - session-02-concepts
+      - session-03-architecture
+      - session-04-test-design
+      - session-05-atdd-automate
+      - session-06-quality-trace
+      - session-07-advanced
+    skip_optional: []
+
+  intermediate:
+    recommended_sequence:
+      - session-01-quickstart
+      - session-02-concepts
+      - session-03-architecture
+      - session-04-test-design
+      - session-05-atdd-automate
+      - session-06-quality-trace
+      - session-07-advanced
+    skip_optional:
+      - session-01-quickstart # Can skip if already familiar
+    certificate_eligible_if_skipped: false
+
+  experienced:
+    recommended_sequence:
+      - session-02-concepts
+      - session-03-architecture
+      - session-04-test-design
+      - session-05-atdd-automate
+      - session-06-quality-trace
+      - session-07-advanced
+    skip_optional:
+      - session-01-quickstart
+    certificate_eligible_if_skipped: false
+
+# Completion Requirements
+completion:
+  minimum_sessions: 7 # All sessions required for certificate
+  passing_score: 70 # Minimum quiz score to pass session
+  average_score_threshold: 70 # Minimum average for certificate
+  certificate_note: "Certificate eligibility requires completion.minimum_sessions. If intermediate.skip_optional or experienced.skip_optional sessions are skipped, certificate eligibility is forfeited."

package/_bmad/tea/workflows/testarch/teach-me-testing/data/quiz-questions.yaml

@@ -0,0 +1,206 @@
+# Quiz Questions Bank
+# Organized by session with questions, answers, and explanations
+
+session-01-quickstart:
+  passing_score: 70
+  questions:
+    - id: q1-purpose
+      question: "What is the primary purpose of TEA?"
+      options:
+        A: "Replace all testing tools with a single framework"
+        B: "Make testing expertise accessible through structured workflows and knowledge"
+        C: "Automate 100% of test writing"
+        D: "Only works for Playwright tests"
+      correct: B
+      explanation: "TEA makes testing expertise accessible and scalable through workflows and knowledge fragments. It's not about replacing tools or automating everything."
+
+    - id: q2-risk-matrix
+      question: "What does the P0-P3 risk matrix help with?"
+      options:
+        A: "Prioritizing test coverage based on criticality"
+        B: "Grading test code quality"
+        C: "Measuring test execution speed"
+        D: "Tracking bug severity"
+      correct: A
+      explanation: "P0-P3 helps prioritize what to test based on risk (Probability × Impact). P0 = critical features like login, P3 = nice-to-have like tooltips."
+
+    - id: q3-engagement
+      question: "Which TEA engagement model is best for quick value in 30 minutes?"
+      options:
+        A: "TEA Enterprise"
+        B: "TEA Lite"
+        C: "TEA Integrated"
+        D: "TEA Brownfield"
+      correct: B
+      explanation: "TEA Lite is the 30-minute quick start approach. Enterprise and Integrated are more comprehensive."
+
+session-02-concepts:
+  passing_score: 70
+  questions:
+    - id: q1-p0-priority
+      question: "In the P0-P3 matrix, what priority level should login/authentication have?"
+      options:
+        A: "P3 - Low priority"
+        B: "P2 - Medium priority"
+        C: "P1 - High priority"
+        D: "P0 - Critical priority"
+      correct: D
+      explanation: "Login/authentication is P0 - critical. Business fails if broken. High usage, high impact, business-critical."
+
+    - id: q2-hard-waits
+      question: "What is the problem with using sleep(5000) instead of waitFor conditions?"
+      options:
+        A: "It makes tests slower"
+        B: "It's a hard wait that doesn't react to state changes (violates DoD)"
+        C: "It uses too much memory"
+        D: "It's not supported in modern frameworks"
+      correct: B
+      explanation: "Hard waits don't react to state changes - they guess timing. Use waitFor to react to conditions. This violates TEA Definition of Done."
+
+    - id: q3-self-cleaning
+      question: "What does 'self-cleaning tests' mean in TEA Definition of Done?"
+      options:
+        A: "Tests automatically fix their own bugs"
+        B: "Tests delete/deactivate entities they create during testing"
+        C: "Tests run faster by cleaning up code"
+        D: "Tests remove old test files"
+      correct: B
+      explanation: "Self-cleaning means tests delete/deactivate entities they created. No manual cleanup required."
+
+session-03-architecture:
+  passing_score: 70
+  questions:
+    - id: q1-fixtures
+      question: "What is the main benefit of fixture composition?"
+      options:
+        A: "Faster test execution"
+        B: "DRY - define once, reuse everywhere"
+        C: "Better error messages"
+        D: "Automatic screenshot capture"
+      correct: B
+      explanation: "Fixture composition allows you to define setup once and reuse everywhere. DRY principle for test setup."
+
+    - id: q2-network-first
+      question: "Why is 'network-first' better than mocking after the action?"
+      options:
+        A: "It's faster"
+        B: "It prevents race conditions"
+        C: "It uses less memory"
+        D: "It's easier to write"
+      correct: B
+      explanation: "Setting up network interception BEFORE the action prevents race conditions. The mock is ready when the action triggers."
+
+    - id: q3-step-file
+      question: "What pattern does this teaching workflow use?"
+      options:
+        A: "Page Object Model"
+        B: "Behavior Driven Development"
+        C: "Step-File Architecture"
+        D: "Test Pyramid"
+      correct: C
+      explanation: "This workflow uses step-file architecture: micro-file design, just-in-time loading, sequential enforcement."
+
+session-04-test-design:
+  passing_score: 70
+  questions:
+    - id: q1-test-design-purpose
+      question: "What does the Test Design workflow help you do?"
+      options:
+        A: "Write tests faster"
+        B: "Plan tests BEFORE writing them"
+        C: "Run tests in parallel"
+        D: "Debug test failures"
+      correct: B
+      explanation: "Test Design workflow helps you plan tests before writing them. Design before code, like architecture before implementation."
+
+    - id: q2-risk-calculation
+      question: "How do you calculate risk?"
+      options:
+        A: "Probability + Impact"
+        B: "Probability × Impact"
+        C: "Probability - Impact"
+        D: "Probability / Impact"
+      correct: B
+      explanation: "Risk = Probability × Impact. Multiply the likelihood of failure by the impact of failure."
+
+    - id: q3-p0-coverage
+      question: "For P0 features, which test levels should you use?"
+      options:
+        A: "Only E2E tests"
+        B: "Only unit tests"
+        C: "Unit + Integration + E2E (comprehensive)"
+        D: "Manual testing only"
+      correct: C
+      explanation: "P0 features need comprehensive coverage: Unit + Integration + E2E. High confidence for critical features."
+
+session-05-atdd-automate:
+  passing_score: 70
+  questions:
+    - id: q1-red-phase
+      question: "What is the 'red' phase in TDD?"
+      options:
+        A: "Tests fail (code doesn't exist yet)"
+        B: "Tests pass"
+        C: "Code is refactored"
+        D: "Tests are deleted"
+      correct: A
+      explanation: "Red phase: Tests fail because the code doesn't exist yet. Write tests first, then implement."
+
+    - id: q2-atdd-vs-automate
+      question: "What's the difference between ATDD and Automate workflows?"
+      options:
+        A: "ATDD generates E2E, Automate generates API tests"
+        B: "ATDD writes tests first (red phase), Automate tests existing code"
+        C: "ATDD is faster than Automate"
+        D: "They're the same workflow"
+      correct: B
+      explanation: "ATDD writes failing tests first (red phase), then you implement. Automate generates tests for existing code (coverage expansion)."
+
+    - id: q3-api-testing
+      question: "Why use pure API tests without a browser?"
+      options:
+        A: "They look prettier"
+        B: "They're easier to debug"
+        C: "They're faster and test business logic directly"
+        D: "They're required by TEA"
+      correct: C
+      explanation: "Pure API tests are faster (no browser overhead) and test business logic directly without UI complexity."
+
+session-06-quality-trace:
+  passing_score: 70
+  questions:
+    - id: q1-five-dimensions
+      question: "What are the 5 dimensions in Test Review workflow?"
+      options:
+        A: "Speed, cost, coverage, bugs, time"
+        B: "Determinism, Isolation, Assertions, Structure, Performance"
+        C: "Unit, integration, E2E, manual, exploratory"
+        D: "P0, P1, P2, P3, P4"
+      correct: B
+      explanation: "Test Review evaluates 5 dimensions: Determinism (no flakiness), Isolation (parallel-safe), Assertions (correct checks), Structure (readable/maintainable organization), Performance (speed)."
+
+    - id: q2-release-gate
+      question: "When should the Trace workflow gate decision be RED (block release)?"
+      options:
+        A: "Any test failures exist"
+        B: "P0 gaps exist (critical requirements not tested)"
+        C: "Code coverage is below 80%"
+        D: "Tests are slow"
+      correct: B
+      explanation: "RED gate when P0 gaps exist - critical requirements not tested. Don't ship if critical features lack test coverage."
+
+    - id: q3-metrics
+      question: "Which metric matters most for quality?"
+      options:
+        A: "Total line coverage %"
+        B: "Number of tests written"
+        C: "P0/P1 coverage %"
+        D: "Test file count"
+      correct: C
+      explanation: "P0/P1 coverage matters most - it measures coverage of critical/high-priority features. Total line coverage is a vanity metric."
+
+session-07-advanced:
+  # No quiz - exploratory session
+  # Score: 100 (completion based, not quiz based)
+  passing_score: 100
+  questions: []