Skip to content

docs: update AGENTS.md to discourage adding code to codex-core#15910

Merged
bolinfest merged 1 commit intomainfrom
pr15910
Mar 26, 2026
Merged

docs: update AGENTS.md to discourage adding code to codex-core#15910
bolinfest merged 1 commit intomainfrom
pr15910

Conversation

@bolinfest
Copy link
Copy Markdown
Collaborator

@bolinfest bolinfest commented Mar 26, 2026

Why

codex-core is already the largest crate in codex-rs, so defaulting to it for new functionality makes it harder to keep the workspace modular. The repo guidance should make it explicit that contributors are expected to look for an existing non-codex-core crate, or introduce a new crate, before growing codex-core further.

What Changed

  • Added a dedicated The \codex-core` cratesection toAGENTS.md`.
  • Documented why codex-core should be treated as a last resort for new functionality.
  • Added concrete guidance for both implementation and review: prefer an existing non-codex-core crate when possible, introduce a new workspace crate when that is the cleaner boundary, and push back on PRs that grow codex-core unnecessarily.

@bolinfest bolinfest requested a review from aibrahim-oai March 26, 2026 21:53
@bolinfest bolinfest merged commit 609019c into main Mar 26, 2026
21 of 22 checks passed
@bolinfest bolinfest deleted the pr15910 branch March 26, 2026 21:56
@github-actions github-actions bot locked and limited conversation to collaborators Mar 26, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants