{"slug":"unified_variant_comparison","filename":"unified_variant_comparison.csv","schema_markdown":"# unified_variant_comparison.csv\n\n**Purpose:** declares the architecture variants you are comparing for the\nevaluation Bridge will run.\n\n**Required columns:**\n\n| Column | Type | Required | Description |\n|---|---|---|---|\n| `variant_id` | string | yes | stable identifier for this variant within your system |\n| `variant_name` | string | yes | human-readable name (≤80 chars) |\n| `role_names` | string (semicolon-separated) | yes | semicolon-separated list of agent/role names that compose this variant |\n| `strategy_mode` | enum | yes | one of: `single_agent`, `multi_agent_pipeline`, `parallel_majority`, `tournament`, `custom` |\n| `primary_metric` | string | yes | the metric you optimize for this variant (e.g., `task_success_rate`, `latency_ms`, `cost_per_query_usd`) |\n| `primary_metric_value` | float | yes | current observed value of `primary_metric` for this variant |\n| `secondary_metric` | string | no | optional secondary trade-off metric |\n| `secondary_metric_value` | float | no | observed value of `secondary_metric` |\n| `notes` | string | no | free-form notes (≤500 chars) |\n\n**Minimum row count:** 2 (at least 2 variants to compare; otherwise comparison is undefined)\n\n**Example:**\n\n```csv\nvariant_id,variant_name,role_names,strategy_mode,primary_metric,primary_metric_value,secondary_metric,secondary_metric_value,notes\nv_baseline,Baseline single-agent,gpt-4-classifier,single_agent,task_success_rate,0.72,latency_ms,1200,production for 4 months\nv_pipeline,3-agent pipeline,planner;executor;verifier,multi_agent_pipeline,task_success_rate,0.84,latency_ms,3400,A/B trial week 2\n```\n\n**What this CSV is NOT:**\n- Not a benchmark dataset (Bridge does not run benchmarks; it evaluates your variant comparison structure)\n- Not a leaderboard (no ranking imposed; Bridge analyzes the trade-off space)\n- Not a research result (this is your current system state, not a publication artifact)\n\n**Canonical source:** `bdc-bridge-passport` repository at frozen SHA recorded in `PASSPORT_REPO_PIN.md`.\n","page_url":"/passport/schemas/unified_variant_comparison","template_url":"/passport/template/unified_variant_comparison","canonical_source":"https://github.com/malishomen/bdc-bridge-passport"}