ENH: update agents.md to better support codex development

[aylward]

Summary by CodeRabbit

• Documentation
  • Restructured contributor guide with explicit role-based sections (Role, Priorities, Behavior, Common Commands) for clearer contribution guidance.
  • Expanded detailed guidance on implementation, testing, documentation, and architecture roles.
  • Enhanced developer prerequisites and universal conventions with detailed tooling, environment instructions, and standardized conventions for axes, world frames, USD export, and test data handling.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 93964cdc-7487-4332-97da-2d73237dea44

📥 Commits

Reviewing files that changed from the base of the PR and between 248db10 and 352d0f1.

📒 Files selected for processing (1)

• AGENTS.md

---

Walkthrough

This PR substantially restructures and expands AGENTS.md into a role-based contributor guide. New top-level sections organize guidance around explicit roles, priorities, and behaviors, while enriched subsections cover data conventions, tooling prerequisites, universal rules, and role-specific implementation, testing, documentation, and architecture expectations.

Changes

Contributor Guide Restructuring

Layer / File(s)	Summary
Role-based contributor guide reorganization and expansion AGENTS.md	AGENTS.md is reorganized with new top-level sections (Role, Priorities, Behavior, Common Commands) and expanded guidance covering developer tooling prerequisites, universal rules (including axes/world frames, USD export conventions, baseline handling, fixture-driven test data), and enriched expectations across implementation, testing, documentation, and architecture roles and file operations.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

A rabbit rewrote the contributor tale,
Organizing roles so none would fail,
With clear commands and conventions bright,
The guide now gleams with structured light! 🐰✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: updating AGENTS.md to better support codex development, which aligns with the substantial restructuring and enhancement of the contributor guide.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 30.62%. Comparing base (248db10) to head (352d0f1).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #55      +/-   ##
==========================================
+ Coverage   30.61%   30.62%   +0.01%     
==========================================
  Files          49       49              
  Lines        6808     6808              
==========================================
+ Hits         2084     2085       +1     
+ Misses       4724     4723       -1     

Flag	Coverage Δ
integration-tests	30.50% <ø> (?)
unittests	30.61% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.