/testing-strategies

name: testing-strategies
description: Strategic guidance for choosing and implementing testing approaches across the test pyramid. Use when building comprehensive test suites that balance unit, integration, E2E, and contract testing for optimal speed and confidence. Covers multi-language patterns (TypeScript, Python, Go, Rust) and modern best practices including property-based testing, test data management, and CI/CD integration.

Testing Strategies

Build comprehensive, effective test suites by strategically selecting and implementing the right testing approaches across unit, integration, E2E, and contract testing levels.

Purpose

This skill provides strategic frameworks for:

• **Test Type Selection**: Determine when to use unit vs. integration vs. E2E vs. contract testing
• **Test Pyramid Balancing**: Optimize test distribution for fast feedback and reliable coverage
• **Multi-Language Implementation**: Apply consistent testing patterns across TypeScript, Python, Go, and Rust
• **Test Data Management**: Choose appropriate strategies (fixtures, factories, property-based testing)
• **CI/CD Integration**: Integrate tests into automated pipelines with optimal execution patterns

Testing is foundational to reliable software. With microservices architectures and continuous delivery becoming standard in 2025, strategic testing across multiple levels is more critical than ever.

When to Use This Skill

Invoke this skill when:

• Building a new feature that requires test coverage
• Designing a testing strategy for a new project
• Refactoring existing tests to improve speed or reliability
• Setting up CI/CD pipelines with testing stages
• Choosing between unit, integration, or E2E testing approaches
• Implementing contract testing for microservices
• Managing test data with fixtures, factories, or property-based testing

The Testing Pyramid Framework

Core Concept

The testing pyramid guides test distribution for optimal speed and confidence:

         /\
        /  \  E2E Tests (10%)
       /----\  - Slow but comprehensive
      /      \  - Full stack validation
     /--------\
    /          \  Integration Tests (20-30%)
   /            \  - Moderate speed
  /--------------\  - Component interactions
 /                \
/------------------\  Unit Tests (60-70%)
                      - Fast feedback
                      - Isolated units

**Key Principle**: More unit tests (fast, isolated), fewer E2E tests (slow, comprehensive). Integration tests bridge the gap.

Modern Adaptations (2025)

**Microservices Adjustment**:

• Add contract testing layer between unit and integration
• Increase integration/contract tests to 30% (validate service boundaries)
• Reduce E2E tests to critical user journeys only

**Cloud-Native Patterns**:

• Use containers for integration tests (ephemeral databases, test services)
• Parallel execution for fast CI/CD feedback
• Risk-based test prioritization (focus on high-impact areas)

For detailed pyramid guidance, see `references/testing-pyramid.md`.

Universal Testing Decision Tree

Which Test Type Should I Use?

START: Need to test [feature]

Q1: Does this involve multiple systems/services?
  ├─ YES → Q2
  └─ NO  → Q3

Q2: Is this a critical user-facing workflow?
  ├─ YES → E2E Test (complete user journey)
  └─ NO  → Integration or Contract Test

Q3: Does this interact with external dependencies (DB, API, filesystem)?
  ├─ YES → Integration Test (real DB, mocked API)
  └─ NO  → Q4

Q4: Is this pure business logic or a pure function?
  ├─ YES → Unit Test (fast, isolated)
  └─ NO  → Component or Integration Test

Test Type Selection Examples

| Feature | Test Type | Rationale | |---------|-----------|-----------| | `calculateTotal(items)` | Unit | Pure function, no dependencies | | `POST /api/users` endpoint | Integration | Tests API + database interaction | | User registration flow (form → API → redirect) | E2E | Critical user journey, full stack | | Microservice A → B communication | Contract | Service interface validation | | `formatCurrency(amount, locale)` | Unit + Property | Pure logic, many edge cases | | Form validation logic | Unit | Isolated business rules | | File upload to S3 | Integration | External service interaction |

For comprehensive decision frameworks, see `references/decision-tree.md`.

Testing Levels in Detail

Unit Testing (Foundation - 60-70%)

**Purpose**: Validate small, isolated units of code (functions, methods, components)

**Characteristics**:

• Fast (milliseconds per test)
• Isolated (no external dependencies)
• Deterministic (same input = same output)
• Broad coverage (many tests, small scope each)

**When to Use**:

• Pure functions (input → output)
• Business logic and algorithms
• Utility functions
• Component rendering (without integration)
• Validation logic

**Recommended Tools**:

• **TypeScript/JavaScript**: Vitest (primary, 10x faster than Jest), Jest (legacy)
• **Python**: pytest (industry standard)
• **Go**: testing package (stdlib) + testify (assertions)
• **Rust**: cargo test (stdlib)

For detailed patterns, see `references/unit-testing-patterns.md`.

Integration Testing (Middle Layer - 20-30%)

**Purpose**: Validate interactions between components, modules, or services

**Characteristics**:

• Moderate speed (seconds per test)
• Partial integration (real database, mocked external APIs)
• Focused scope (test component boundaries)
• API and database validation

**When to Use**:

• API endpoints (request → response)
• Database operations (CRUD, queries)
• Service-to-service communication
• Event handlers and message processing
• File I/O operations

**Recommended Tools**:

• **TypeScript/JavaScript**: Vitest + MSW (API mocking), Supertest (HTTP testing)
• **Python**: pytest + pytest-httpserver, pytest-postgresql
• **Go**: testing + httptest, testcontainers
• **Rust**: cargo test + mockito, testcontainers

For detailed patterns, see `references/integration-testing-patter