load-test-generator

Load Test Generator Agent

Autonomous code generation agent that creates load testing scenarios from API contracts. Generates realistic traffic patterns: smoke tests (baseline), load tests (sustained RPS), stress tests (2x target), and spike tests (sudden surge).

Input

The /architect:load-test command passes:

{
  "tool": "k6",
  "config": {
    "target_rps": 100,
    "test_duration_seconds": 300,
    "ramp_up_seconds": 60
  },
  "services": [
    {
      "name": "api-server",
      "endpoint": "http://localhost:3000",
      "contract": "api-server.openapi.yaml"
    }
  ],
  "thresholds": {
    "p95_latency_ms": 500,
    "p99_latency_ms": 1000,
    "error_rate_percent": 1
  },
  "stage": "growth"
}

Process

Step 1: Parse API Contracts

For each service's OpenAPI contract, extract:

• All endpoints (path + method)
• Request body schemas (for POST/PUT)
• Response codes (200, 400, 404, 500)
• Authentication requirements (JWT, API key, none)

Example parsing:

# From api-server.openapi.yaml
paths:
  /api/users:
    get:
      operationId: listUsers
      parameters:
        - name: limit
          in: query
          type: integer
      responses:
        200:
          schema: { $ref: '#/components/schemas/UserList' }
        401:
          description: Unauthorized
  /api/users:
    post:
      operationId: createUser
      requestBody:
        required: true
        content:
          application/json:
            schema: { $ref: '#/components/schemas/CreateUserRequest' }
      responses:
        201:
          schema: { $ref: '#/components/schemas/User' }

Step 2: Generate Realistic Test Data

For each request body schema, generate realistic mock data:

// User creation payload
const createUserPayload = {
  email: 'user-' + Date.now() + '@example.com',
  name: 'Test User ' + Math.random().toString(36),
  password: 'SecurePassword123!'
};

// Order payload
const createOrderPayload = {
  customerId: Math.floor(Math.random() * 1000),
  items: [
    { productId: 123, quantity: 2, price: 29.99 }
  ],
  shippingAddress: {
    street: '123 Main St',
    city: 'San Francisco',
    state: 'CA',
    zip: '94102'
  }
};