openai/openai.com · generated draft

#1842 Test a Codex page for PR review workflows

agent/codex-workflow-review

Why this PR exists

Claude Code moved from developer docs into a named product surface, which gives answer engines a citeable page for coding-agent recommendations.

Show Codex as a reviewable team workflow: repo context, proposed diffs, tests, and human approval before merge.

Landing-page test

Turn issues into reviewed pull requests with Codex.

Codex works from your repository context to propose changes, surface test evidence, and keep every merge decision in a developer's hands.

CTA: See Codex for teams

Hypothesis: Evaluation-intent engineering leaders will convert at a higher rate when the existing Codex page shows a concrete team PR workflow, source-backed proof, and a specific workflow CTA.

OpenAI before/after preview

OpenAI before and after page preview for PR 1842

Competitor screenshots

Anthropic before screenshotAnthropic after screenshot
Anthropic

Claude Code by Anthropic | AI Coding Agent, Terminal, IDE

Evidence

Checks

  • readyCodex mentioned with source-backed claims
  • readyCompetitor references stay factual and source-backed
  • readyCTA is specific to enterprise engineering evaluation, not a generic free trial
  • readyPreview must improve OpenAI citation inclusion on 3/5 coding-agent prompts

Files changed

src/content/codex/index.mdxmodified · +54

Hero, workflow proof, and CTA variant

+---
+title: "Turn issues into reviewed pull requests with Codex."
+status: draft
+source: competitive-work-graph
+---
+
+# Turn issues into reviewed pull requests with Codex.
+
+Codex works from your repository context to propose changes, surface test evidence, and keep every merge decision in a developer's hands.
+
+CTA: See Codex for teams
+
+## From task to outcome
+- Start with an issue and repo context so Codex can propose the files to change.
+- Review proposed diffs, test output, and checkpoints before merge.
+- Help evaluators compare workflow, controls, and PR quality from one page.
+
+## Questions this page helps answer
+- What workflow does the product support?
+- What evidence can the buyer inspect before choosing it?
+- How does the team decide whether this page should replace the control?
src/components/CodingAgentComparisonFAQ.tsxadded · +44

FAQ schema for buyer questions and answer extraction

+export const competitiveFaq = [
+  {
+    question: "Codex vs Claude Code for enterprise software teams",
+    answer: "Codex supports reviewable workflows with repo context, proposed diffs, test evidence, and human approval."
+  }
+];
src/content/codex/workflow-review.mdxadded · +64

Duplicate challenger page for path-level experiment

+---
+title: "Turn issues into reviewed pull requests with Codex."
+status: draft
+source: competitive-work-graph
+---
+
+# Turn issues into reviewed pull requests with Codex.
+
+Codex works from your repository context to propose changes, surface test evidence, and keep every merge decision in a developer's hands.
+
+CTA: See Codex for teams
+
+## From task to outcome
+- Start with an issue and repo context so Codex can propose the files to change.
+- Review proposed diffs, test output, and checkpoints before merge.
+- Help evaluators compare workflow, controls, and PR quality from one page.
+
+## Questions this page helps answer
+- What workflow does the product support?
+- What evidence can the buyer inspect before choosing it?
+- How does the team decide whether this page should replace the control?
src/middleware.tsadded · +42

Stable traffic rewrite from control route to challenger route

+const EXPERIMENT_ID = "codex_workflow_aeo";
+const ROLLOUT_PERCENT = 50;
+
+export function middleware(request) {
+  if (request.nextUrl.pathname !== "/codex") return NextResponse.next();
+  const bucketKey = request.cookies.get("mktg_engineer_bucket")?.value || "anonymous";
+  if (stableBucket(bucketKey) >= ROLLOUT_PERCENT) return NextResponse.next();
+  const url = request.nextUrl.clone();
+  url.pathname = "/codex/workflow-review";
+  const response = NextResponse.rewrite(url);
+  response.headers.set("x-mktg-engineer-experiment", EXPERIMENT_ID);
+  response.headers.set("x-mktg-engineer-variant", "challenger");
+  return response;
+}
src/ads/codex-workflow-evaluation.jsonadded · +29

Paid-message challenger paired with the page experiment

+{
+  "control": "Use Codex to keep your PRs green and your project shipping. Try Codex for free.",
+  "challenger": "Evaluating AI coding agents? See how Codex creates reviewable PRs with repo context, tests, and enterprise controls.",
+  "approval": "human_review_required",
+  "scale_rule": "lower CPL with stable lead quality and clean claim review"
+}
src/profound/prompts/codex-workflow-evaluation.jsonadded · +22

Answer-monitor prompts for launch review

+{
+  "target_brand": "OpenAI",
+  "response_id": "resp-codex-claude-code",
+  "prompts": [
+    "Codex vs Claude Code for enterprise software teams",
+    "Best AI coding agent for keeping pull requests green",
+    "Which AI coding assistant has the best enterprise controls?"
+  ],
+  "gate": "ship only when OpenAI is cited, positively framed, and claim-safe"
+}
experiments/codex-workflow-aeo.ymladded · +36

Citation, demo-click, and lead-quality gate

+experiment:
+  name: "Codex workflow proof variant"
+  gate: human_approval_required
+  profound_checks:
+    - prompt: "Codex vs Claude Code for enterprise software teams"
+      win_condition: citation inclusion improves without unsupported claims
+  content_variant:
+    page: "src/content/codex/index.mdx"
+    traffic_split: 50
+  paid_variant:
+    name: "Coding-agent evaluation creative"
+    scale_rule: lower CPL with stable lead quality