chore: initial monorepo scaffold + WDS Phase 1+2 artifacts

- Nx 22.7 monorepo (pnpm 11.1, TypeScript 5.9, Node 24)
- apps/api: NestJS 11 (CJS conforme CODING-RULES.md PGD-DB-004)
- apps/web: React 19 + Vite 8 (ESM)
- libs/shared/api-interface: Zod contract base
- Docker Compose dev: Postgres 18, Valkey 8, MinIO, Mailpit
- WDS artifacts:
  - design-artifacts/A-Product-Brief/ (5 docs canônicos + 16 dialogs)
  - design-artifacts/B-Trigger-Map/ (hub + 4 personas + feature impact)
- Stack canon: STACK.md v2.2 + CODING-RULES.md v2.0 + brand.md
- AGENTS.md + README.md como entrada para devs/agentes

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-27 14:34:20 +00:00
commit 17c08e6392
3631 changed files with 855518 additions and 0 deletions

View File

@@ -0,0 +1,137 @@
# Teach Me Testing - Usage Instructions
## Overview
The Teach Me Testing workflow is a multi-session learning companion that teaches testing progressively through 7 structured sessions with state persistence. Designed for self-paced learning over 1-2 weeks.
## Who Should Use This
- **New QA Engineers:** Complete onboarding in testing fundamentals
- **Developers:** Learn testing from an integration perspective
- **Team Leads:** Understand architecture patterns and team practices
- **VPs/Managers:** Grasp testing strategy and quality metrics
## How to Run
### Starting Fresh
```bash
# From TEA module location
cd /path/to/bmad-method-test-architecture-enterprise
# Run the workflow
bmad run teach-me-testing
```
Or invoke through TEA agent menu:
```bash
bmad agent tea
# Select [TMT] Teach Me Testing
```
### Continuing Existing Progress
The workflow automatically detects existing progress and resumes where you left off. Your progress is saved at:
- `{test_artifacts}/teaching-progress/{your-name}-tea-progress.yaml`
## Workflow Structure
### Step Entrypoints
- Create / start: `{skill-root}/steps-c/step-01-init.md`
- Continue existing progress: `{skill-root}/steps-c/step-01b-continue.md`
- Validate the workflow: `{skill-root}/steps-v/step-v-01-validate.md`
- Edit the workflow: `{skill-root}/steps-e/step-e-01-assess-workflow.md`
### 7 Sessions
1. **Quick Start (30 min)** - TEA Lite intro, run automate workflow
2. **Core Concepts (45 min)** - Risk-based testing, DoD, philosophy
3. **Architecture (60 min)** - Fixtures, network patterns, framework
4. **Test Design (60 min)** - Risk assessment workflow
5. **ATDD & Automate (60 min)** - ATDD + Automate workflows
6. **Quality & Trace (45 min)** - Test review + Trace workflows
7. **Advanced Patterns (ongoing)** - Menu-driven knowledge fragment exploration
### Non-Linear Learning
- Jump to any session based on your experience level
- Beginners: Start at Session 1
- Intermediate: Skip to Session 3-6
- Experienced: Jump to Session 7 (Advanced)
### Session Flow
Each session follows this pattern:
1. Load relevant TEA docs just-in-time
2. Present teaching content (mostly autonomous)
3. Knowledge validation quiz (interactive)
4. Generate session notes artifact
5. Update progress file
6. Return to session menu (continue or exit)
## Progress Tracking
Your progress is automatically saved after each session:
- **Progress file:** `{test_artifacts}/teaching-progress/{your-name}-tea-progress.yaml`
- **Session notes:** `{test_artifacts}/tea-academy/{your-name}/session-{N}-notes.md`
- **Certificate:** `{test_artifacts}/tea-academy/{your-name}/tea-completion-certificate.md`
## Quiz Scoring
- **Passing threshold:** ≥70%
- **On failure:** Option to review content or continue anyway
- **Attempts:** 3 attempts per question before showing correct answer
## Completion
Complete all 7 sessions to receive your TEA Academy completion certificate with:
- Session completion dates and scores
- Skills acquired checklist
- Learning artifacts paths
- Recommended next steps
## Tips for Success
1. **Set aside dedicated time** - Each session requires focus (30-90 min)
2. **Take notes** - Session notes are generated, but add your own insights
3. **Apply immediately** - Practice concepts on your current project
4. **Explore fragments** - Session 7 has 42 knowledge fragments to deep-dive
5. **Share with team** - Help others learn by sharing your experience
## Customization by Role
The workflow adapts examples based on your role:
- **QA:** Practical testing focus, workflow usage
- **Dev:** Integration perspective, TDD approach
- **Lead:** Architecture decisions, team patterns
- **VP:** Strategy, ROI, quality metrics
## Troubleshooting
### Progress file corrupted
- Workflow detects corruption and offers fresh start
- Backup file created automatically
### Missing TEA docs
- Workflow uses Web-Browsing fallback for external frameworks
- Primary source is always local docs
### Session interrupted
- Progress auto-saved after quiz completion
- Resume from session menu on next run
## Support
- **Documentation:** <https://bmad-code-org.github.io/bmad-method-test-architecture-enterprise/>
- **Knowledge Fragments:** <https://github.com/bmad-code-org/bmad-method-test-architecture-enterprise/tree/main/src/agents/bmad-tea/resources/knowledge>
- **Issues:** Report via TEA module repository