codex - 💡(How to fix) Fix GROUNDING.MD - grounding during software development enforcing agents to follow community-supported domain knowledge [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openai/codex#20202Fetched 2026-04-30 06:32:06
View on GitHub
Comments
0
Participants
1
Timeline
5
Reactions
0
Author
Participants
Timeline (top)
labeled ×3unlabeled ×2
RAW_BUFFERClick to expand / collapse

What variant of Codex are you using?

CLI

What feature would you like to see?

We are suggesting Codex "knows" what a GROUNDING.md file is and gives it context priority over AGENTS.md, SKILLS.md, etc. natively. We have demonstrated in other agent scaffolds that system prompt can do this (most of the time), but we would love to get it baked in. There is a preprint "letter" describing it, https://arxiv.org/abs/2604.21744 , but the GROUNDING.md provides an invariant enforcement layer using community-supported domain knowledge, giving users confidence their software isn't breaking any rules (Hard Constraints). When they do attempt to break a HC, the agent stops the user and tells them why not. We see more of these GROUNDING.md files being generated, beyond our proof of principle with proteomics.

Additional information

No response

extent analysis

TL;DR

Implement native support for GROUNDING.md files in Codex to prioritize their context over other files like AGENTS.md and SKILLS.md.

Guidance

  • Review the preprint "letter" at https://arxiv.org/abs/2604.21744 to understand the concept and benefits of GROUNDING.md files.
  • Consider developing a custom solution using system prompts to achieve similar functionality, as demonstrated in other agent scaffolds.
  • Explore the possibility of integrating community-supported domain knowledge into Codex to provide an invariant enforcement layer.
  • Discuss with the development team the feasibility of prioritizing GROUNDING.md files natively in Codex.

Notes

The implementation details are unclear, and it is uncertain whether native support for GROUNDING.md files is currently possible in Codex.

Recommendation

Apply workaround: Implement a custom solution using system prompts, as it has been demonstrated to work in other agent scaffolds, while waiting for potential native support in future updates.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING