docs: update all documentation and add AI tooling configs
- Rewrite README.md with current architecture, features and stack - Update docs/API.md with all current endpoints (corporate, BI, client 360) - Update docs/ARCHITECTURE.md with cache, modular queries, services, ETL - Update docs/GUIA-USUARIO.md for all roles (admin, corporate, agente) - Add docs/INDEX.md documentation index - Add PROJETO.md comprehensive project reference - Add BI-CCC-Implementation-Guide.md - Include AI agent configs (.claude, .agents, .gemini, _bmad) - Add netbird VPN configuration - Add status report Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
130
.agents/skills/bmad-teach-me-testing/instructions.md
Normal file
130
.agents/skills/bmad-teach-me-testing/instructions.md
Normal file
@@ -0,0 +1,130 @@
|
||||
# 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
|
||||
|
||||
### 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 35 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/testarch/knowledge>
|
||||
- **Issues:** Report via TEA module repository
|
||||
Reference in New Issue
Block a user