cassel/calctext

Fork 0

Files

C. Cassel bfe0e01254 initial commit

2026-03-16 19:54:53 -04:00

33 KiB

Raw Blame History

stepsCompleted, created, status, approvedDate, designCompletedDate, foundationCompletedDate

stepsCompleted

created

status

approvedDate

designCompletedDate

foundationCompletedDate

step-01-discovery

step-02-classification

step-03-requirements

step-04-tools

step-05-plan-review

step-06-design

step-07-foundation

2026-01-27

FOUNDATION_COMPLETE

2026-01-27

2026-01-28

Workflow Creation Plan

Discovery Notes

User's Vision: Create an ongoing learning companion that teaches testing progressively through a structured curriculum. Users at the company (and beyond) lack testing knowledge regardless of experience level - from hobbyist beginners to experienced VPs. The TEA (Test Architecture Enterprise) module has extensive documentation (~24k lines, 200 files, 9 workflows, 35 knowledge fragments), but manual teaching doesn't scale. This workflow solves that by providing self-paced, structured learning with state persistence across multiple sessions.

Who It's For:

New QA engineers (primary onboarding use case)
Developers who need testing knowledge
Anyone at the company requiring testing fundamentals through advanced practices
Scalable to entire team without manual teaching

What It Produces:

Multi-session learning journey (7 sessions, 30-90 min each)
Session-by-session progress tracking via persistent state file
Learning artifacts: session notes, test files, reports, completion certificate
Personalized learning paths customized by role (QA vs Dev vs Lead vs VP)
Knowledge validation through quizzes after each session
Resume capability - users can pause and continue across days/weeks

Key Insights:

Content volume (~24k lines) makes single-session teaching infeasible
State persistence is critical for multi-session continuity
Just-in-time content loading per session keeps context manageable
First use case: new QA onboarding completing in 1-2 weeks
Workflow must reference and integrate TEA docs and knowledge base extensively
Users learn at their own pace without requiring instructor availability

Technical Architecture Requirements:

7-session curriculum structure
State file: tracks progress, scores, completed sessions, artifacts, next recommended session
Role-based path customization
Knowledge validation gates between sessions
Artifact generation per session
Integration with TEA module documentation and knowledge base

Classification Decisions

Workflow Name: teach-me-testing Target Path: {project-root}/src/workflows/testarch/bmad-teach-me-testing/

4 Key Decisions:

Document Output: Yes (produces progress files, session notes, artifacts, completion certificate)
Module Affiliation: TEA module (9th workflow in test architecture)
Session Type: Continuable (multi-session learning over 1-2 weeks)
Lifecycle Support: Tri-modal (Create + Edit + Validate for future-proofing)

Structure Implications:

Tri-modal architecture: Needs steps-c/, steps-e/, steps-v/ folders
Continuable workflow: Requires step-01-init.md with continuation detection + step-01b-continue.md for resuming
State tracking: Uses stepsCompleted in progress file frontmatter
Document templates: Progress tracking YAML, session notes markdown, completion certificate
Module integration: Access to TEA module variables, docs paths, knowledge base paths
Data folder: Shared data for curriculum structure, role paths, session content mappings

Requirements

Flow Structure:

Pattern: Mixed (non-linear between sessions, linear within sessions, branching at start only)
Phases: Initial assessment → Session selection (non-linear) → Session execution (linear: teach → quiz → artifact) → Completion
Estimated steps: Init + Continue + Assessment + 7 Session steps + Final Polish/Certificate generation = ~10-12 core step files
Session jumping: Users can skip to any session based on experience level
Within session: Strictly linear progression through teaching content

User Interaction:

Style: Mixed (mostly autonomous teaching with collaborative decision points)
Decision points:
- Role/experience assessment (entry)
- Session selection (menu-driven, can jump around)
- Quiz answers (validation gates)
- Continue to next session or exit
Checkpoint frequency: At session completion (save progress, offer continue/exit)
Teaching approach: AI presents content, user absorbs - minimal interruption once learning

Inputs Required:

Required:
- User role (QA, Dev, Lead, VP)
- Experience level (beginner, intermediate, experienced)
- Learning goals (fundamentals, TEA-specific, advanced patterns)
Optional:
- Existing project for practical examples
- Specific pain points (flaky tests, slow tests, hard to maintain)
Prerequisites:
- TEA module installed
- Access to TEA docs and knowledge base
- Understanding of time commitment (30-90 min per session)

Output Specifications:

Type: Multiple document types
Format: Mixed formats
- Progress file: Structured YAML with specific schema (sessions, scores, artifacts, completed_date, next_recommended)
- Session notes: Free-form markdown built progressively per session
- Completion certificate: Structured format with completion data
Sections:
- Progress file has fixed schema
- Session notes vary by session content
- Certificate has standard completion fields
Frequency:
- Progress file: Updated after each session
- Session notes: Generated per session
- Certificate: Generated at final completion

Success Criteria:

User completes their chosen sessions (might be 1, might be all 7)
Knowledge validated through quizzes (≥70% passing threshold)
Artifacts generated successfully (progress file exists, session notes created, learning tracked)
User can apply knowledge (write their first good test following TEA principles)
Onboarding velocity achieved (new QAs complete core sessions within 1-2 weeks)
Scalability proven (multiple team members learn without requiring instructor time)

Instruction Style:

Overall: Mixed (prescriptive for structure, intent-based for teaching)
Prescriptive for:
- Initial assessment (consistent role/experience classification)
- Quiz questions (need exact validation logic)
- Progress tracking (exact state file updates)
- Session navigation (clear menu structure)
Intent-based for:
- Teaching sessions (AI adapts explanations naturally)
- Example selection (AI chooses relevant TEA docs/knowledge fragments)
- Artifact generation (AI synthesizes learning into notes)
- Role-flavored content (AI adjusts examples based on user role)

Tools Configuration

Core BMAD Tools:

Party Mode: Included (optional via A/P menu) - Use for collaborative exploration when the learner wants a lighter format
Advanced Elicitation: Included (optional via A/P menu) - Use for deeper discovery or clarification during sessions
Brainstorming: Excluded - Not needed for structured curriculum delivery

LLM Features:

Web-Browsing: Included - Use case: Safety net for framework updates (Cypress, Jest, newer Playwright versions) and frameworks not covered in TEA docs. Motto: "Only reach out when you don't have the info"
File I/O: Included - Operations: Read TEA docs (/docs/.md), read knowledge fragments (/src/testarch/knowledge/.md), write progress file ({user}-tea-progress.yaml), write session notes, write completion certificate
Sub-Agents: Excluded - Sessions are linear teaching steps handled by TEA agent, not complex specialized tasks requiring delegation
Sub-Processes: Excluded - Learning is sequential (one session at a time), no parallel processing needed

Memory:

Type: Continuable workflow with persistent state
Tracking:
- stepsCompleted array in progress YAML
- Session completion tracking (id, status, completed_date, score, artifacts)
- Progress metrics (completion_percentage, next_recommended)
- Progress file structure:
```
user: { user_name }
role: { qa/dev/lead/vp }
sessions: [{ id, status, completed_date, score, artifacts }]
completion_percentage: { percent }
next_recommended: { session-id }
```
- Continuation support via step-01b-continue.md with progress dashboard

External Integrations:

None - Self-contained within TEA module, no external databases/APIs/MCP servers needed

Installation Requirements:

None - All selected tools are built-in (Web-Browsing and File I/O are standard LLM features)
User preference: N/A (no installations required)

Workflow Design

Complete Flow Overview

Entry → Init (check for progress) → [New User: Assessment | Returning User: Dashboard] → Session Menu (hub) → Sessions 1-7 (loop back to menu) → Completion Certificate

Step Structure (CREATE mode - steps-c/)

Total: 12 step files

Phase 1: Initialization & Continuation

step-01-init.md (Init Step - Continuable)
- Goal: Welcome user, check for existing progress file, explain workflow, create initial progress if new
- Type: Init (Continuable) - checks for {user}-tea-progress.yaml, routes to step-01b if exists
- Menu: Auto-proceed (Pattern 3) - no user menu
- Logic: Checks for existing progress → routes to step-01b if exists, otherwise creates new and proceeds to step-02
step-01b-continue.md (Continuation Step)
- Goal: Load existing progress, show dashboard with completion status, route to session menu
- Type: Continuation - reads stepsCompleted, displays progress percentage
- Menu: Auto-proceed (Pattern 3) - no user menu
- Logic: Shows progress dashboard → auto-routes to step-03-session-menu

Phase 2: Assessment & Path Selection

step-02-assess.md (Middle Step - Standard)
- Goal: Gather role (QA/Dev/Lead/VP), experience level, learning goals, optional pain points
- Type: Middle (Standard) auto-proceed
- Menu: Auto-proceed (Pattern 3) - no user menu
- On completion: Saves assessment to progress file → loads step-03-session-menu
step-03-session-menu.md (Branch Step - Hub)
- Goal: Present 7 sessions with descriptions + completion status, allow non-linear selection
- Type: Branch Step (custom menu: 1-7, X for exit)
- Menu: Custom branching (Pattern 4)
- Display: [1-7] Select session | [X] Exit
- Logic:
  - 1-7: Routes to corresponding session step
  - X: If all sessions complete → routes to step-05-completion; if incomplete → saves and exits
- This is the hub - all sessions return here

Phase 3: Session Execution (7 Sessions)

5-11. step-04-session-[01-07].md (Middle Steps - Complex)

Each session follows same pattern:
- Loads relevant TEA docs just-in-time
- Presents teaching content (mostly autonomous)
- Knowledge validation quiz (collaborative)
- Generates session notes artifact
- Updates progress file
- Returns to step-03-session-menu
Menu: Standard A/P/C (Pattern 1) - users might want Advanced Elicitation
On C: Saves session notes, updates progress (mark complete, update score), returns to hub

Sessions:

session-01: Quick Start (30 min) - TEA Lite intro, run automate workflow
session-02: Core Concepts (45 min) - Risk-based testing, DoD, philosophy
session-03: Architecture (60 min) - Fixtures, network patterns, framework
session-04: Test Design (60 min) - Risk assessment workflow
session-05: ATDD & Automate (60 min) - ATDD + Automate workflows
session-06: Quality & Trace (45 min) - Test review + Trace workflows
session-07: Advanced Patterns (ongoing) - Menu-driven knowledge fragment exploration

Phase 4: Completion

step-05-completion.md (Final Step)
- Goal: Generate completion certificate, final progress update, congratulate
- Type: Final - no nextStepFile, marks workflow complete
- Menu: None (final step)
- Logic: Generates certificate, displays congratulations, workflow ends

Interaction Patterns

Auto-proceed steps: step-01-init, step-01b-continue, step-02-assess
Standard A/P/C: step-04-session-[01-07]
Custom branching: step-03-session-menu (hub)
No menu: step-05-completion (final)

Data Flow

Progress File: {test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml

Schema:

user: { user_name }
role: { qa/dev/lead/vp }
experience_level: { beginner/intermediate/experienced }
learning_goals: [list]
pain_points: [optional list]
started_date: 2026-01-27
last_session_date: 2026-01-27

sessions:
  - id: session-01-quickstart
    status: completed
    completed_date: 2026-01-27
    score: 90
    notes_artifact: '{test_artifacts}/tea-academy/{user_name}/session-01-notes.md'
  - id: session-02-concepts
    status: in-progress
    started_date: 2026-01-27
  # ... sessions 03-07

sessions_completed: 1
total_sessions: 7
completion_percentage: 14
next_recommended: session-02-concepts

stepsCompleted: ['step-01-init', 'step-02-assess', 'step-04-session-01']
lastStep: 'step-04-session-01'
lastContinued: '2026-01-27'

Data Flow Per Step:

step-01-init: Creates initial progress YAML if new
step-01b-continue: Reads progress file, updates lastContinued
step-02-assess: Updates role, experience, goals, pain_points
step-03-session-menu: Reads sessions array (display status)
step-04-session-[N]: Reads progress (for role), writes session notes, updates sessions array
step-05-completion: Reads all sessions data, writes certificate

Error Handling:

Quiz failure (<70%): Offer review or continue anyway
Missing TEA docs: Use Web-Browsing fallback
Corrupted progress: Backup and offer fresh start
Session interrupted: Auto-save after quiz completion

Checkpoints:

After assessment complete
After each quiz completion
After each session artifact generation
On user exit from session menu

File Structure

teach-me-testing/
├── workflow.md                              # Main entry point
├── workflow.yaml                            # Workflow metadata
│
├── steps-c/                                 # CREATE mode (12 steps)
│   ├── step-01-init.md
│   ├── step-01b-continue.md
│   ├── step-02-assess.md
│   ├── step-03-session-menu.md
│   ├── step-04-session-01.md
│   ├── step-04-session-02.md
│   ├── step-04-session-03.md
│   ├── step-04-session-04.md
│   ├── step-04-session-05.md
│   ├── step-04-session-06.md
│   ├── step-04-session-07.md
│   └── step-05-completion.md
│
├── steps-e/                                 # EDIT mode (2 steps)
│   ├── step-e-01-assess-workflow.md
│   └── step-e-02-apply-edits.md
│
├── steps-v/                                 # VALIDATE mode (1 step)
│   └── step-v-01-validate.md
│
├── data/                                    # Shared data files
│   ├── curriculum.yaml
│   ├── role-paths.yaml
│   ├── session-content-map.yaml
│   ├── quiz-questions.yaml
│   └── tea-resources-index.yaml
│
├── templates/                               # Document templates
│   ├── progress-template.yaml
│   ├── session-notes-template.md
│   └── certificate-template.md
│
├── instructions.md
└── checklist.md

Role and Persona Definition

AI Role: Master Test Architect and Teaching Guide

Expertise:

Deep knowledge of testing principles (risk-based, test pyramid, types)
Expert in TEA methodology (9 workflows, architecture patterns, 35 knowledge fragments)
Familiar with Playwright, test automation, CI/CD
Teaching pedagogy: progressive learning, knowledge validation, role-based examples

Communication Style:

Teaching: Clear, patient, educational - adapts complexity by role
Quizzes: Encouraging, constructive feedback, non-judgmental
Navigation: Clear, concise, shows completion status prominently
Tone: Encouraging but not patronizing, technical but accessible

Teaching Principles:

Just-in-time learning (load content when needed)
Active recall (quiz after teaching)
Spaced repetition (reference earlier concepts)
Role-flavored examples (same concept, different contexts)
Artifact generation (learners keep notes)

Validation and Error Handling

Output Validation:

Progress file: Schema, status, score (0-100), date, artifact paths
Session notes: Frontmatter present, content not empty (min 100 chars)
Certificate: All 7 sessions complete, valid dates, user info present

User Input Validation:

Role: Must be QA, Dev, Lead, or VP
Experience: beginner, intermediate, or experienced
Quiz answers: 3 attempts before showing correct answer
Session selection: Must be 1-7 or X

Error Recovery:

Corrupted progress: Backup, offer fresh start
Missing docs: Web-Browsing fallback
Quiz failure: Review or continue options
Interrupted session: Auto-save progress

Success Criteria:

Session complete: Content presented, quiz passed, notes generated, progress updated
Workflow complete: All 7 sessions done, avg score ≥70%, artifacts created, certificate generated

Special Features

Conditional Logic:

Session menu routing: Check if all complete → route to completion or show menu
Quiz scoring: If ≥70% proceed, if <70% offer review

Branch Points:

Initial entry: Progress exists? → continue vs new
Experience-based recommendations: Beginner → session 1, Experienced → session 7

Integration with TEA Workflows:

Session 1: Demonstrates [TA] Automate
Session 3: May run [TF] Framework
Session 4: Runs [TD] Test Design
Session 5: Runs [AT] ATDD + [TA] Automate
Session 6: Runs [RV] Test Review + [TR] Trace

Role-Based Content:

QA: Practical testing focus
Dev: Integration and TDD focus
Lead: Architecture and patterns focus
VP: Strategy and metrics focus

Session 7 Special Handling:

Exploratory menu-driven deep-dive into 35 knowledge fragments
Organized by categories (Testing Patterns, Playwright Utils, Config/Governance, etc.)
Links to GitHub for browsing

Content Sources (Triple Reference System):

Local files: /docs/*.md, /src/testarch/knowledge/*.md
Online docs: <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/>
GitHub fragments: Direct links to knowledge fragment source files

Design Summary

Complete: 12-step CREATE workflow with hub pattern Continuable: Progress file tracks state across sessions Non-linear: Users jump to any session from hub Role-flavored: Same concepts, role-specific examples Triple content: Local + online + GitHub sources Web-Browsing: Fallback for missing/updated docs Auto-save: After each session completion Tri-modal: Create (12 steps) + Edit (2 steps) + Validate (1 step)

Foundation Build Complete

Created: 2026-01-28

Folder Structure:

teach-me-testing/
├── workflow.md                           ✓ Created
├── steps-c/                              ✓ Created (empty, to be populated)
├── steps-e/                              ✓ Created (empty, to be populated)
├── steps-v/                              ✓ Created (empty, to be populated)
├── data/                                 ✓ Created (empty, to be populated)
├── templates/                            ✓ Created
│   ├── progress-template.yaml            ✓ Created
│   ├── session-notes-template.md         ✓ Created
│   └── certificate-template.md           ✓ Created
├── instructions.md                       ✓ Created
└── checklist.md                          ✓ Created

Location: {external-project-root}/_bmad-output/bmb-creations/workflows/teach-me-testing/

Configuration:

Workflow name: teach-me-testing
Continuable: Yes (multi-session learning)
Document output: Yes (Progress YAML, Session notes MD, Certificate MD)
Mode: Tri-modal (Create + Edit + Validate)
Module: TEA (Test Architecture Enterprise)

Files Created:

workflow.md
- Tri-modal routing logic (Create/Edit/Validate)
- Configuration loading from TEA module
- Step-file architecture principles
- Initialization sequence
templates/progress-template.yaml
- Complete progress tracking schema
- 7 sessions defined
- Session status tracking (not-started/in-progress/completed)
- stepsCompleted array for continuation
- Progress metrics (completion_percentage, next_recommended)
templates/session-notes-template.md
- Session metadata
- Key concepts, objectives, takeaways
- TEA resources referenced
- Quiz results
- Practical examples
templates/certificate-template.md
- Completion certificate structure
- All 7 sessions with scores
- Skills acquired checklist
- Learning artifacts paths
- Next steps recommendations
instructions.md
- How to run the workflow
- Session structure and flow
- Progress tracking details
- Troubleshooting guide
checklist.md
- Quality validation checklist
- Foundation quality checks
- Step file quality standards
- Data file quality requirements
- Completion criteria

Next Steps:

Step 8: Build step-01-init.md (initialization with continuation detection)
Step 9: Build step-01b-continue.md (continuation/resume logic)
Step 10+: Build remaining 10 step files (assessment, session menu, 7 sessions, completion)
Populate data/ folder with curriculum, role paths, session content map, quizzes, resources index

Step 01 Build Complete

Created: 2026-01-28

Files:

steps-c/step-01-init.md ✓
steps-c/step-01b-continue.md ✓

Step Configuration:

Type: Continuable (multi-session learning)
Input Discovery: No (self-contained teaching)
Progress File: {test_artifacts}/teaching-progress/{user_name}-tea-progress.yaml
Menu Pattern: Auto-proceed (no user menu)

step-01-init.md:

Checks for existing progress file
If exists → routes to step-01b-continue
If not → creates new progress from template, proceeds to step-02-assess
Initializes stepsCompleted array
Creates complete session tracking structure (all 7 sessions)

step-01b-continue.md:

Loads existing progress file
Updates lastContinued timestamp
Displays progress dashboard with completion status
Shows session indicators (✅ completed, 🔄 in-progress, ⬜ not-started)
Auto-routes to step-03-session-menu (hub)

Frontmatter Compliance:

All variables used in step body
Relative paths for internal references
No hardcoded paths
Follows frontmatter standards

Next Steps:

Build step-02-assess.md (assessment)
Build step-03-session-menu.md (hub)
Build 7 session steps (step-04-session-01 through step-04-session-07)
Build step-05-completion.md (certificate generation)

Step 02 Build Complete

Created: 2026-01-28

Files:

steps-c/step-02-assess.md ✓

Step Configuration:

Type: Middle Step (Standard) auto-proceed
Next Step: step-03-session-menu
Menu Pattern: Auto-proceed (Pattern 3) - no user menu

step-02-assess.md:

Gathers role (QA/Dev/Lead/VP) with validation
Gathers experience level (beginner/intermediate/experienced) with validation
Gathers learning goals (required, validated)
Gathers pain points (optional)
Updates progress file with all assessment data
Provides experience-based session recommendations
Updates stepsCompleted array with 'step-02-assess'
Routes to step-03-session-menu (hub)

Frontmatter Compliance:

All variables used in step body
Relative paths for internal references
No hardcoded paths
Follows frontmatter standards

Remaining Steps: 9 more to build

step-03-session-menu (hub with branching)
step-04-session-01 through step-04-session-07 (7 teaching sessions)
step-05-completion (certificate generation)

Step 03 Build Complete

Created: 2026-01-28

Files:

steps-c/step-03-session-menu.md ✓

Step Configuration:

Type: Branch Step (Hub) with custom menu (1-7, X)
Routes To: Any of 7 sessions OR completion OR exit
Menu Pattern: Custom branching (Pattern 4)

step-03-session-menu.md:

Loads progress file to get session completion status
Displays all 7 sessions with status indicators (✅ completed, 🔄 in-progress, ⬜ not-started)
Shows completion percentage and scores
Provides session descriptions and durations
Recommends next session based on progress
Detects when all 7 sessions complete → routes to completion
Allows non-linear session selection (jump to any session)
Exit option (X) saves progress and ends workflow
This is the HUB - all sessions return here
No stepsCompleted update (routing hub, not content step)

Routing Logic:

1-7 → Routes to corresponding session step
X → Saves and exits workflow
All complete → Auto-routes to step-05-completion

Frontmatter Compliance:

All 7 session file references used in routing logic
Completion file reference used for all-done scenario
Progress file loaded for status display
Relative paths for all step files

Remaining Steps: 8 more to build

step-04-session-01 through step-04-session-07 (7 teaching sessions)
step-05-completion (certificate generation)

Step 04-Session-01 Build Complete

Created: 2026-01-28

Files:

steps-c/step-04-session-01.md ✓

Step Configuration:

Type: Middle Step (Complex) with A/P/C menu
Session: Quick Start (30 min)
Next Step: Returns to step-03-session-menu (hub)
Menu Pattern: Standard A/P/C (Pattern 1)

step-04-session-01.md:

Session 1: Quick Start - TEA Lite intro, run automate workflow
Updates progress (status: in-progress at start, completed at end)
Teaching content: What is TEA, TEA Lite, Automate workflow, engagement models
Role-adapted examples (QA/Dev/Lead/VP perspectives)
3-question quiz with validation (passing: ≥70%)
Quiz retry option if failing (<70%)
Generates session notes using template with all quiz results
Updates progress file (status, score, notes_artifact, completion_percentage)
Updates stepsCompleted array with 'step-04-session-01'
Returns to session menu hub (step-03)

Teaching Topics:

What is TEA and why it exists
9 workflows + 35 knowledge fragments
Quality standards (Definition of Done)
Risk-based testing (P0-P3 matrix)
TEA engagement models (Lite/Solo/Integrated/Enterprise/Brownfield)
Automate workflow conceptual overview

TEA Resources Referenced:

TEA Overview, TEA Lite Quickstart, Automate Workflow docs
Online URLs provided for further reading

Remaining Steps: 7 more to build

step-04-session-02 through step-04-session-07 (6 more teaching sessions)
step-05-completion (certificate generation)

Step 04-Session-02 Build Complete

Created: 2026-01-28 Files: steps-c/step-04-session-02.md ✓ Session: Core Concepts (45 min) - Testing as Engineering, Risk-based testing (P0-P3), TEA Definition of Done Pattern: Middle Step (Complex) with A/P/C menu, returns to hub Teaching: Philosophy, risk matrix, quality standards with role-adapted examples Quiz: 3 questions on P0-P3, hard waits, self-cleaning tests Knowledge Fragments: test-quality.md, probability-impact.md

Remaining: 6 steps (sessions 03-07 + completion)

Step 04-Session-03 Build Complete

Created: 2026-01-28 Files: steps-c/step-04-session-03.md ✓ Session: Architecture & Patterns (60 min) Topics: Fixture composition, network-first patterns, data factories, step-file architecture Knowledge Fragments: fixture-architecture.md, network-first.md, data-factories.md Quiz: 3 questions on fixtures, network-first, step-file architecture

Step 04-Session-04 Build Complete

Created: 2026-01-28 Files: steps-c/step-04-session-04.md ✓ Session: Test Design (60 min) Topics: Test Design workflow, risk/testability assessment, coverage planning, test priorities matrix Knowledge Fragments: test-levels-framework.md, test-priorities-matrix.md Quiz: 3 questions on test design, risk calculation, P0 coverage

Step 04-Session-05 Build Complete

Created: 2026-01-28 Files: steps-c/step-04-session-05.md ✓ Session: ATDD & Automate (60 min) Topics: ATDD workflow (red-green TDD), Automate workflow, component TDD, API testing patterns Knowledge Fragments: component-tdd.md, api-testing-patterns.md, api-request.md Quiz: 3 questions on TDD red phase, ATDD vs Automate, API testing

Step 04-Session-06 Build Complete

Created: 2026-01-28 Files: steps-c/step-04-session-06.md ✓ Session: Quality & Trace (45 min) Topics: Test Review workflow (5 dimensions), Trace workflow, quality metrics Quiz: 3 questions on quality dimensions, release gates, metrics

Step 04-Session-07 Build Complete

Created: 2026-01-28 Files: steps-c/step-04-session-07.md ✓ Session: Advanced Patterns (ongoing) Format: Menu-driven exploration of 35 knowledge fragments Categories: Testing Patterns (9), Playwright Utils (11), Config/Governance (6), Quality Frameworks (5), Auth/Security (3) No Quiz: Exploratory session, score: 100 on completion Special: Repeatable, user can explore multiple fragments, returns to hub

Step 05-Completion Build Complete

Created: 2026-01-28 Files: steps-c/step-05-completion.md ✓ Type: Final Step (no next step) Purpose: Verify all 7 sessions complete, generate certificate, final progress update, celebrate Certificate: Includes all session scores, skills acquired, learning artifacts, next steps Final: Updates progress (certificate_generated: true, completion_date) No Menu: Workflow ends here

CREATE Mode Build Complete (12 Steps)

All CREATE mode steps built: ✓

step-01-init.md - Initialize with continuation detection
step-01b-continue.md - Resume with progress dashboard
step-02-assess.md - Role/experience assessment
step-03-session-menu.md - Session selection hub
step-04-session-01.md - Quick Start
step-04-session-02.md - Core Concepts
step-04-session-03.md - Architecture & Patterns
step-04-session-04.md - Test Design
step-04-session-05.md - ATDD & Automate
step-04-session-06.md - Quality & Trace
step-04-session-07.md - Advanced Patterns
step-05-completion.md - Certificate generation

Remaining:

Data files (curriculum.yaml, role-paths.yaml, session-content-map.yaml, quiz-questions.yaml, tea-resources-index.yaml)
EDIT mode steps (2 steps)
VALIDATE mode steps (1 step)

Data Files Build Complete

Created: 2026-01-28

Files:

data/curriculum.yaml ✓ - 7-session structure, learning paths by experience, completion requirements
data/role-paths.yaml ✓ - Role customizations for QA/Dev/Lead/VP with focus areas and teaching adaptations
data/session-content-map.yaml ✓ - Maps sessions to TEA docs, knowledge fragments, online URLs, workflows
data/quiz-questions.yaml ✓ - Question bank for sessions 1-6 (session 7 is exploratory, no quiz)
data/tea-resources-index.yaml ✓ - Comprehensive index of 32 docs + 35 knowledge fragments with GitHub links

All 5 data files complete.

EDIT Mode Build Complete

Created: 2026-01-28

Files:

steps-e/step-e-01-assess-workflow.md ✓ - Identify what to edit, gather edit requirements
steps-e/step-e-02-apply-edits.md ✓ - Apply modifications with user approval, validate integrity

All 2 EDIT mode steps complete.

VALIDATE Mode Build Complete

Created: 2026-01-28

Files:

steps-v/step-v-01-validate.md ✓ - Comprehensive quality validation against BMAD standards, generates validation report

All 1 VALIDATE mode step complete.

🏆 WORKFLOW BUILD COMPLETE

Status: ✅ 100% COMPLETE

Total Files Created: 24 files

Foundation (6 files)

workflow.md
instructions.md
checklist.md
workflow-plan-teach-me-testing.md
(plus 3 templates)

Templates (3 files)

progress-template.yaml
session-notes-template.md
certificate-template.md

CREATE Mode (12 step files)

step-01-init.md
step-01b-continue.md
step-02-assess.md
step-03-session-menu.md
step-04-session-01.md through step-04-session-07.md (7 sessions)
step-05-completion.md

Data Files (5 files)

curriculum.yaml
role-paths.yaml
session-content-map.yaml
quiz-questions.yaml
tea-resources-index.yaml

EDIT Mode (2 step files)

step-e-01-assess-workflow.md
step-e-02-apply-edits.md

VALIDATE Mode (1 step file)

step-v-01-validate.md

Next Action Required

DEPLOYMENT: Move workflow from staging to TEA module

Source (Staging): {external-project-root}/_bmad-output/bmb-creations/workflows/teach-me-testing/

Target (Production): {project-root}/src/workflows/testarch/bmad-teach-me-testing/

Command:

cp -r {external-project-root}/_bmad-output/bmb-creations/workflows/teach-me-testing \
      {project-root}/src/workflows/testarch/

After deployment:

Update TEA agent menu to add [TMT] Teach Me Testing
Test the workflow: bmad run teach-me-testing
Validate: bmad run teach-me-testing -v
Document in TEA module README

Workflow Creation: COMPLETE ✅ Ready for Deployment: YES Validation Status: Not yet validated (run -v mode after deployment)

33 KiB Raw Blame History

Workflow Creation Plan

Discovery Notes

Classification Decisions

Requirements

Tools Configuration

Workflow Design

Complete Flow Overview

Step Structure (CREATE mode - steps-c/)

Phase 1: Initialization & Continuation

Phase 2: Assessment & Path Selection

Phase 3: Session Execution (7 Sessions)

Phase 4: Completion

Interaction Patterns

Data Flow

File Structure

Role and Persona Definition

Validation and Error Handling

Special Features

Design Summary

Foundation Build Complete

Step 01 Build Complete

Step 02 Build Complete

Step 03 Build Complete

Step 04-Session-01 Build Complete

Step 04-Session-02 Build Complete

Step 04-Session-03 Build Complete

Step 04-Session-04 Build Complete

Step 04-Session-05 Build Complete

Step 04-Session-06 Build Complete

Step 04-Session-07 Build Complete

Step 05-Completion Build Complete

CREATE Mode Build Complete (12 Steps)

Data Files Build Complete

EDIT Mode Build Complete

VALIDATE Mode Build Complete

🏆 WORKFLOW BUILD COMPLETE

Foundation (6 files)

Templates (3 files)

CREATE Mode (12 step files)

Data Files (5 files)

EDIT Mode (2 step files)

VALIDATE Mode (1 step file)

Next Action Required

33 KiB

Raw Blame History