Mythic-MCP: Skill for Claude Code

Integration Test Planning

Comprehensive guide for designing and implementing integration and end-to-end tests that validate real system behavior.

When to Use This Skill

Invoke this skill when:

• Planning test strategy for a feature
• Implementing integration tests
• Setting up test environments
• Designing test data management
• Troubleshooting test failures
• Validating service integrations
• Ensuring test coverage

Test Strategy Framework

Test Level Definitions

Integration Tests:

• Test interactions between 2+ services/components
• Use real databases, APIs, caches
• Validate data flows across boundaries
• Test service contracts and interfaces
• Shorter than E2E, focused on subsystems

End-to-End Tests:

• Test complete user workflows
• Involve all system components
• Validate full stack integration
• Test from entry point to data persistence
• Realistic user scenarios

Unit Tests (Minimal in CI-First):

• Only for complex business logic
• Algorithms, calculations, transformations
• NOT for database queries, API calls, or integrations
• Should be a small portion of total tests

Test Environment Setup

Docker Compose for Real Services

Example: Web Application Test Environment

# docker-compose.test.yml
version: '3.8'

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile.test
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_started
    environment:
      NODE_ENV: test
      DATABASE_URL: postgresql://testuser:testpass@postgres:5432/testdb
      REDIS_URL: redis://redis:6379/0
      JWT_SECRET: test-secret-key
      API_PORT: 3000
    ports:
      - "3000:3000"

  postgres:
    image: postgres:15-alpine
    environment:
      POSTGRES_USER: testuser
      POSTGRES_PASSWORD: testpass
      POSTGRES_DB: testdb
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U testuser"]
      interval: 5s
      timeout: 5s
      retries: 5
    tmpfs:
      - /var/lib/postgresql/data  # Fast in-memory storage for tests

  redis:
    image: redis:7-alpine
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 3s
      retries: 5

  # Optional: External API mock
  mock-api:
    image: mockserver/mockserver:latest
    environment:
      MOCKSERVER_INITIALIZATION_JSON_PATH: /config/expectations.json
    volumes:
      - ./tests/mocks:/config