From 2ee854eaa5efc9f5d3952825f13cb0905fcde2c9 Mon Sep 17 00:00:00 2001
From: pakrym-oai <pakrym@openai.com>
Date: Fri, 12 Jun 2026 13:00:21 -0700
Subject: [PATCH] [codex] Add crate API surface review rule (#27939)

## Why

Review guidance should explicitly discourage widening crate APIs for
testing convenience. Keeping those boundaries narrow reduces accidental
coupling and prevents one-off test utilities from becoming durable
public surface area.

## What

- Add a crate API surface rule to `AGENTS.md`.
- Ask reviewers to keep crate APIs small and avoid proliferating
test-only helpers.

## Test plan

- Not run (documentation-only change).
---
 AGENTS.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/AGENTS.md b/AGENTS.md
index 0118ef77b..016b80205 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -81,6 +81,10 @@ Likewise, when reviewing code, do not hesitate to push back on PRs that would un
 
 ## Code Review Rules
 
+### Crate API surface
+
+Keep crate API surfaces as small as possible. Avoid proliferating test-only helpers.
+
 ### Model visible context
 
 Codex maintains a context (history of messages) that is sent to the model in inference requests.