using-quality-engineering

Using Quality Engineering (Meta-Skill Router)

Your entry point to quality engineering methodology. This skill routes you to the right reference sheet for comprehensive quality engineering guidance.

Purpose

This is a meta-skill that:

1. Routes you to the correct quality engineering reference sheet
2. Combines multiple reference sheets for comprehensive testing strategies
3. Provides workflows for common quality problems
4. Explains when to use each specialist reference

You should use this skill: When facing testing challenges, quality automation, performance concerns, or reliability engineering problems.

---

Core Philosophy: Quality as Engineering

The Central Idea

Ad-Hoc Testing: Write tests → Hope they catch bugs → Fix when broken

• Tests as afterthought
• No systematic coverage strategy
• Flaky tests ignored or disabled
• Quality gates that don't gate

Quality Engineering: Strategy → Architecture → Automation → Observability

• Tests designed for specific failure modes
• Systematic coverage across test pyramid
• Flakiness as signal, not noise
• Quality gates that enforce standards

When This Pack Applies

Use quality-engineering when:

• Setting up or improving test infrastructure
• Debugging flaky or unreliable tests
• Designing testing strategy for new features
• Performance testing and optimization
• Production reliability and observability
• Security testing integration (SAST, dependency scanning, fuzzing)

Don't use quality-engineering when:

• Pure code architecture decisions (use system-architect)
• Security threat modeling (use security-architect)
• Pure UX testing research (use ux-designer)

---

How to Access Reference Sheets

IMPORTANT: All reference sheets are located in the SAME DIRECTORY as this SKILL.md file.

When this skill is loaded from: skills/using-quality-engineering/SKILL.md

Reference sheets like flaky-test-prevention.md are at: skills/using-quality-engineering/flaky-test-prevention.md

NOT at: skills/flaky-test-prevention.md ← WRONG PATH

When you see a link like [flaky-test-prevention.md](flaky-test-prevention.md), read the file from the same directory as this SKILL.md.

---

Routing Guide

When the user asks about quality engineering topics, load the appropriate reference sheet:

User's Question Topic	Load Reference Sheet
Test Fundamentals & Isolation
Test independence, idempotence, order-independence, isolation	test-isolation-fundamentals.md
API & Integration Testing
REST/GraphQL API testing, request validation, API mocking	api-testing-strategies.md
Component integration, database testing, test containers	integration-testing-patterns.md
End-to-End & UI Testing
End-to-end test design, E2E anti-patterns, browser automation	e2e-testing-strategies.md
Screenshot comparison, visual bugs, responsive testing	visual-regression-testing.md
Performance & Load Testing
Load testing, benchmarking, performance regression	performance-testing-fundamentals.md
Stress testing, spike testing, soak testing, capacity planning	load-testing-patterns.md
Test Quality & Maintenance
Test coverage, quality dashboards, CI/CD quality gates	quality-metrics-and-kpis.md
Test refactoring, page objects, reducing test debt	test-maintenance-patterns.md
Mutation testing, test effectiveness, mutation score	mutation-testing.md
Static Analysis & Security
SAST tools, ESLint, Pylint, code quality gates	static-analysis-integration.md
Dependency scanning, Snyk, Dependabot, vulnerability management	dependency-scanning.md
Fuzzing, random inputs, security vulnerabilities	fuzz-testing.md
Advanced Testing Techniques
Property-based testing, Hypothesis, fast-check, invariants	property-based-testing.md
Production Testing & Monitoring
Feature flags, canary testing, dark launches, prod monitoring	testing-in-production.md
Metrics, tracing, alerting, quality signals	observability-and-monitoring.md
Fault injection, resilience testing, failure scenarios	chaos-engineering-principles.md
Test Infrastructure
Test pyramid, CI/CD integration, test organization	test-automation-architecture.md
Fixtures, factories, seeding, test isolation, data pollution	test-data-management.md
Flaky tests, race conditions, timing issues, non-determinism	flaky-test-prevention.md
API contracts, schema validation, consumer-driven contracts	contract-testing.md

---

Common Problem Types and Reference Sheet Combinations

Scenario 1: "Our Tests Keep Failing Randomly"

Symptoms:

• Tests pass locally, fail in CI
• Same test fails intermittently
• Test failures don't reproduce

Reference Sheet Sequence:

1. flaky-test-prevention.md - Diagnose root cause (race conditions, timing, state)
2. test-isolation-fundamentals.md - Ensure test independence
3. test-data-management.md - Fix data pollution issues

Scenario 2: "Setting Up Test Infrastructure from Scratch"

Symptoms:

• New project needs testing strategy
• Migrating to new test framework
• Building CI/CD quality gates

Reference Sheet Sequence:

1. test-automation-architecture.md - Design test pyramid
2. quality-metrics-and-kpis.md - Define quality gates
3. integration-testing-patterns.md - Set up integration tests
4. e2e-testing-strategies.md - Add E2E coverage

Scenario 3: "Performance Problems in Production"

Symptoms:

• Slow response times
• Resource exhaustion
• Scaling issues

Reference Sheet Sequence:

1. performance-testing-fundamentals.md - Baseline measurements
2. load-testing-patterns.md - Stress and capacity testing
3. observability-and-monitoring.md - Production monitoring

Scenario 4: "Security Testing Integration"

Symptoms:

• Need to catch vulnerabilities early
• Compliance requirements
• Supply chain security concerns

Reference Sheet Sequence:

1. static-analysis-integration.md - Code quality and SAST
2. dependency-scanning.md - Supply chain security
3. fuzz-testing.md - Input validation vulnerabilities

Scenario 5: "Test Suite Takes Too Long"

Symptoms:

• CI takes 30+ minutes
• Developers skip running tests locally
• Test parallelization issues

Reference Sheet Sequence:

1. test-automation-architecture.md - Review test pyramid balance
2. test-maintenance-patterns.md - Reduce test debt
3. mutation-testing.md - Identify low-value tests

---

When NOT to Load Reference Sheets

Only answer directly (without loading) for:

• Meta questions about this plugin ("What reference sheets are available?")
• Questions about which reference to use ("Should I use e2e-testing-strategies or test-automation-architecture?")
• Simple clarification questions

User demands "just answer, don't route" is NOT an exception - still load the reference sheet. User asking to skip routing signals they need the specialist guidance even more.

---

Quality Engineering Reference Sheets Catalog

After routing, load the appropriate reference sheet for detailed guidance:

Test Fundamentals

1. test-isolation-fundamentals.md - Test independence, idempotence, order-independence, isolation patterns

API & Integration

2. api-testing-strategies.md - REST/GraphQL testing, request validation, API mocking
3. integration-testing-patterns.md - Database testing, test containers, component integration
4. contract-testing.md - Consumer-driven contracts, schema validation, API contracts

End-to-End & UI

5. e2e-testing-strategies.md - Browser automation, E2E anti-patterns, test design
6. visual-regression-testing.md - Screenshot comparison, responsive testing, visual bugs

Performance & Load

7. performance-testing-fundamentals.md - Benchmarking, performance regression, baseline measurements
8. load-testing-patterns.md - Stress testing, spike testing, capacity planning

Test Quality & Maintenance

9. quality-metrics-and-kpis.md - Coverage metrics, quality dashboards, CI/CD gates
10. test-maintenance-patterns.md - Test refactoring, page objects, test debt
11. mutation-testing.md - Test effectiveness, mutation score, mutation operators

Static Analysis & Security

12. static-analysis-integration.md - SAST tools, ESLint, Pylint, quality gates
13. dependency-scanning.md - Snyk, Dependabot, supply chain security
14. fuzz-testing.md - Random input testing, security vulnerabilities

Advanced Techniques

15. property-based-testing.md - Hypothesis, fast-check, invariant testing

Production & Monitoring

16. testing-in-production.md - Feature flags, canary testing, dark launches
17. observability-and-monitoring.md - Metrics, tracing, alerting, SLIs/SLOs
18. chaos-engineering-principles.md - Fault injection, resilience testing

Test Infrastructure

19. test-automation-architecture.md - Test pyramid, CI/CD integration, organization
20. test-data-management.md - Fixtures, factories, seeding, data isolation
21. flaky-test-prevention.md - Race conditions, timing issues, non-determinism