Operations pillar · v0.16.0

ab-experiment AbExperiment

A/B experiment record.

$id · https://corpospec.com/schemas/v0.16.0/ab-experiment.schema.json

Fields

Field	Type	Required	Description
alpha	number	yes	Statistical-significance threshold (α).
analysis_plan	string	yes	Detailed analysis plan (pre-registered).
decision	ExperimentDecision	yes	Decision outcome.
end_date	IsoDate	yes	ISO 8601 date (YYYY-MM-DD).
entity	PathRef	yes	Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
hypothesis	string	yes	One-sentence hypothesis ("If we do X, then Y will move by Z").
id	PathRef	yes	Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
metrics	ExperimentMetric[]	yes
name	string	yes
owner	PathRef	yes	Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
power	number	yes	Statistical-power threshold (1−β).
start_date	IsoDate	yes	ISO 8601 date (YYYY-MM-DD).
status	ExperimentStatus	yes	Lifecycle.
target_sample_size_per_variant	integer	yes	Target sample size per variant (from power analysis).
variants	ExperimentVariant[]	yes
decision_ref	PathRef?	—	PathRef to the decision narrative (BDR / readout).
feature_flag_ref	PathRef?	—	PathRef to the feature flag implementing the variants.
observed_sample_size_per_variant	integer?	—	Observed sample size per variant at end.

Shared types referenced within this schema.

ExperimentDecision

Decision outcome.

ExperimentMetric

One metric attached to the experiment.

type: object

ExperimentMetricDirection

Metric direction (improvement criterion).

ExperimentStatus

Lifecycle.

ExperimentVariant

One experiment variant.

type: object

IsoDate

ISO 8601 date (YYYY-MM-DD).

type: string

PathRef

Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`

pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$

# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/ab-experiment.schema.json