Document Codex PR readiness permission

[justin808]

Adds a repo-local AGENTS.md instruction so future Codex sessions may mark
draft PRs ready once the work is complete and checks/review-app verification
are clean.

This is a documentation-only agent instruction update.

---

Note

Low Risk
Documentation-only agent policy with no runtime, security, or application code changes.

Overview
Adds a new AGENTS.md with repo-local instructions for Codex on pull request readiness.

Codex may run gh pr ready without asking again when the requested work is done, required checks and review-app verification pass (or non-blocking skips are documented), and there are no unresolved blocking review comments or user-requested changes. If checks fail, review-app verification is broken, or blocking feedback remains, the PR stays draft and Codex should report the blocker.

^{Reviewed by Cursor Bugbot for commit 3e5af57. Bugbot is set up for automated code reviews on this repo. Configure here.}

[coderabbitai]

Warning

Review limit reached

@justin808, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 51 minutes and 48 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 15127152-e0b7-4b2c-8cdc-73768c3159c0

📥 Commits

Reviewing files that changed from the base of the PR and between 623c9f5 and 3e5af57.

📒 Files selected for processing (1)

• AGENTS.md

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch jg-codex/allow-codex-pr-ready-20260602

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[greptile-apps]

Greptile Summary

This PR adds a new AGENTS.md file that grants Codex pre-approved permission to mark draft pull requests ready for review under a defined set of conditions, eliminating the need to prompt the user each time.

• Codex may run gh pr ready autonomously when work is complete, all required checks/review-app verification pass (or skips are documented), and no blocking review comments remain unresolved.
• If any condition is unmet, Codex must leave the PR as draft and surface the blocker instead of proceeding.

Confidence Score: 5/5

Documentation-only addition of AGENTS.md; no executable code is touched and the instructions are self-contained.

The change is a single new markdown file with no code, no dependencies, and no runtime impact. The conditions Codex must satisfy before marking a PR ready are explicit and the fallback behavior is clearly specified.

No files require special attention.

Important Files Changed

Filename	Overview
AGENTS.md	New file documenting pre-approved Codex permission to mark draft PRs ready; prose is clear and the conditions/fallback behavior are well-defined.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A([Codex finishes requested work]) --> B{Work complete?}
    B -- No --> Z([Leave as draft, report blocker])
    B -- Yes --> C{Required checks &\nreview-app passing\nor skips documented?}
    C -- No --> Z
    C -- Yes --> D{Blocking review comments\nor user-requested\nchanges unresolved?}
    D -- Yes --> Z
    D -- No --> E([Run: gh pr ready])

Loading

_{Reviews (1): Last reviewed commit: "Document Codex PR readiness permission" | Re-trigger Greptile}