doc: update AGENTS.md for clarity and less tokens

[BridgeAR]

This adds a few improvements around handling types as well as how to write the code (using optional chaining and no for-in) while minimizing the document size. That way we use less tokens just for the reading this and overall gain better code output.

[github-actions]

Overall package size

Self size: 4.42 MB
Deduped: 5.24 MB
No deduping: 5.24 MB

Dependency sizes

| name | version | self size | total size | |------|---------|-----------|------------| | import-in-the-middle | 2.0.0 | 68.46 kB | 797.03 kB | | dc-polyfill | 0.1.10 | 26.73 kB | 26.73 kB |

_{🤖 This report was automatically generated by heaviest-objects-in-the-universe}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 86.12%. Comparing base (cb8bc8d) to head (427c323).
⚠️ Report is 3 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #7285   +/-   ##
=======================================
  Coverage   86.12%   86.12%           
=======================================
  Files         513      513           
  Lines       22106    22106           
=======================================
  Hits        19039    19039           
  Misses       3067     3067           

☔ 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.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[pr-commenter]

Benchmarks

Benchmark execution time: 2026-01-20 16:36:49

Comparing candidate commit 427c323 in PR branch BridgeAR/2026-01-20-improve-agents-md with baseline commit cb8bc8d in branch master.

Found 0 performance improvements and 0 performance regressions! Performance is the same for 233 metrics, 27 unstable metrics.

[sabrenner]

looks good to me, i think this cuts down on context fed to agents succinctly! just added a few comments/questions, but not blocking, i think the cut down here does its job