The Complete Production SOP: How to Deploy and Run GrowthBook Open-Source Feature Flags & A/B Testing in Autonomous AI Agents

---
name: "growthbook-ab-testing-feature-flags"
description: "Run statistically sound A/B tests and feature rollouts using self-hosted GrowthBook."
metadata:
  author: "GrowthBook"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "run ab test growthbook"
  - "setup growthbook sdk"
  - "tracking callback growthbook"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Execution SOP
1. Initialize SDK: const gb = new GrowthBook({ apiHost, clientKey, trackingCallback }).
2. Load features: await gb.loadFeatures({ autoRefresh: true }).
3. Run experiment: const { value } = gb.run({ key: 'pricing-test', variations: ['Control', 'Variant A'] });
4. Send exposure event in trackingCallback to warehouse for automated statistical analysis.

import { GrowthBook } from '@growthbook/growthbook';

export const growthbook = new GrowthBook({
  apiHost: process.env.NEXT_PUBLIC_GROWTHBOOK_API_HOST || 'https://growthbook.internal.domain',
  clientKey: process.env.NEXT_PUBLIC_GROWTHBOOK_CLIENT_KEY || '',
  enableDevMode: process.env.NODE_ENV !== 'production',
  trackingCallback: (experiment, result) => {
    // Telemetry pipeline ingestion (e.g., Segment, PostHog, or internal endpoint)
    if (typeof window !== 'undefined' && (window as any).analytics) {
      (window as any).analytics.track('Experiment Viewed', {
        experimentId: experiment.key,
        variationId: result.variationId,
        value: result.value,
        hashAttribute: experiment.hashAttribute || 'id',
      });
    }
  },
});

import React, { useEffect, useState } from 'react';
import { growthbook } from '@/lib/growthbook';

interface CheckoutPricingProps {
  userId: string;
  country: string;
}

export const CheckoutPricing: React.FC<CheckoutPricingProps> = ({ userId, country }) => {
  const [ready, setReady] = useState(false);

  useEffect(() => {
    growthbook.setAttributes({ id: userId, country });
    growthbook.loadFeatures({ autoRefresh: true })
      .then(() => setReady(true))
      .catch((err) => {
        console.error('GrowthBook hydration failed:', err);
        setReady(true);
      });
  }, [userId, country]);

  if (!ready) return <div className="skeleton">Loading pricing tier...</div>;

  const { value: tier } = growthbook.run({
    key: 'checkout-pricing-model',
    variations: ['monthly_flat', 'annual_discounted'],
  });

  return (
    <div className="pricing-card">
      <h3>Selected Plan: {tier === 'annual_discounted' ? 'Annual Saver (20% Off)' : 'Standard Monthly'}</h3>
    </div>
  );
};

import { render, screen } from '@testing-library/react';
import { CheckoutPricing } from '../CheckoutPricing';
import { growthbook } from '@/lib/growthbook';

describe('CheckoutPricing A/B Test', () => {
  afterEach(() => {
    growthbook.destroy();
  });

  it('evaluates control variant properly', async () => {
    growthbook.setForcedVariations({ 'checkout-pricing-model': 0 });
    render(<CheckoutPricing userId="user_1" country="US" />);
    expect(await screen.findByText(/Standard Monthly/i)).toBeInTheDocument();
  });

  it('evaluates discount variant properly', async () => {
    growthbook.setForcedVariations({ 'checkout-pricing-model': 1 });
    render(<CheckoutPricing userId="user_2" country="US" />);
    expect(await screen.findByText(/Annual Saver/i)).toBeInTheDocument();
  });
});