Repository navigation
docs(agents): simplify repository guidance - #9969
Conversation
Overall package sizeSelf size: 8.56 MB Dependency sizes| name | version | self size | total size | |------|---------|-----------|------------| | import-in-the-middle | 3.3.3 | 125.43 kB | 445.14 kB | | opentracing | 0.14.7 | 194.81 kB | 194.81 kB | | dc-polyfill | 0.1.11 | 25.74 kB | 25.74 kB |🤖 This report was automatically generated by heaviest-objects-in-the-universe |
|
✅ All CI checks and tests passed. 🎉 All green!🧪 All tests passed 🎯 Code Coverage (details) 🔗 Commit SHA: fb8b3a8 | Docs | View more details | Give us feedback! |
BenchmarksBenchmark execution time: 2026-08-28 21:43:24 Comparing candidate commit fb8b3a8 in PR branch Found 0 performance improvements and 0 performance regressions! Performance is the same for 2301 metrics, 9 unstable metrics.
|
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## master #9969 +/- ##
==========================================
+ Coverage 98.58% 98.59% +0.01%
==========================================
Files 990 992 +2
Lines 149247 149804 +557
Branches 12763 12600 -163
==========================================
+ Hits 147131 147697 +566
+ Misses 2116 2107 -9 Flags with carried forward coverage won't be shown. Click here to find out more. ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 86f1a28d3c
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
86f1a28 to
7cdfd8b
Compare
|
Changes look good to me from IDM POV! |
|
I'm very curous here if we have any measurements around agent performance related to .md agent context changes. Bc otherwise these changes are very based on vibes |
rochdev
left a comment
rochdev
left a comment
There was a problem hiding this comment.
Left a few comments but nothing major, could be addressed later or as a follow-up post-approval.
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 43bb04f3fe
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: e7d4a0f3e4
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
bengl
left a comment
bengl
left a comment
There was a problem hiding this comment.
This needs to come with some sort of check that AGENTS.md is sufficiently streamlined.
7182a5f to
60d1b73
Compare
60d1b73 to
04fd80f
Compare
04fd80f to
ba99631
Compare
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: ba99631f01
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
6 participants
What does this PR do?
Condenses the root
AGENTS.mdfrom a broad engineering handbook into concise repository-wide setup, workflow, testing, safety, backportability, and CI guidance.Moves detailed architecture-review and flaky-test investigation procedures into on-demand project skills, exposes the canonical
.agents/skillscatalog to Claude and Cursor through symlinks, and assigns product-specific CODEOWNERS for those skills.Motivation
The root instructions had grown large enough that every agent task consumed detailed guidance for specialized workflows regardless of relevance. Keeping universal invariants in
AGENTS.mdand loading task-specific skills on demand reduces context usage while preserving important engineering policies.This structure also avoids premature nested
AGENTS.mdfiles when the specialized guidance is task-shaped rather than directory-shaped.Additional Notes
architecture-reviewwith the six-dimension baseline-to-proposal review framework.flaky-test-investigationwith evidence-based classification and optional parallel sub-agent investigation..agents/skillsas the canonical source;.claude/skillsand.cursor/skillsentries are symlinks.git diff --check, skill metadata and line-length checks, newline checks, and symlink/catalog integrity checks.npm run lint:codeowners:ciwas attempted but could not run becausecodeowners-auditis not installed in this worktree..husky/pre-commitis not executable.