[Docs] Rewrite AGENTS.md as coding-agent task-routing guide - #9186
Draft
lucaspimentel wants to merge 4 commits into
Draft
[Docs] Rewrite AGENTS.md as coding-agent task-routing guide#9186lucaspimentel wants to merge 4 commits into
lucaspimentel wants to merge 4 commits into
Conversation
BuildAndRunNativeUnitTests was renamed to RunNativeUnitTests in #5614
lucaspimentel
force-pushed
the
lpimentel/improve-agents-guide
branch
2 times, most recently
from
September 8, 2026 14:11
d17a81b to
a132e96
Compare
LLM ValidationLLM Validation Gate — dotnet-tracer-agent✅ PASS
AnalysisChanged instruction file(s): No safety or blocking-case regressions across 5 case(s). Overall pairwise win-rate 54% [51%–58%], quality +1.9 — see the verdict above for whether that clears the noise band. Results
Cases
Per-dimension scores, token usage, latency, and estimated cost are in the CI job logs. |
This comment was marked as off-topic.
This comment was marked as off-topic.
The AGENTS.md numbered workflow covers scoped edits, regression tests, and test-run reporting, which only apply when files change. Saying "non-trivial work" pulled that checklist into questions that change nothing, where a verification report is not a useful response.
Add the Verify snapshot workflow (received/verified files, UpdateSnapshots) and the Xunit.Combinatorial data attribute to the testing guidance, and add the span metadata assertion rules plus span documentation regeneration to the integration checklist. 🤖
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary of changes
Rewrites
AGENTS.md(317 → 211 lines) as a concise coding-agent operating guide and task-routing reference:docs/development/guides.Also fixes a stale Nuke target name in the build command examples:
BuildAndRunNativeUnitTests→RunNativeUnitTests(renamed in #5614, so the old command failed with an unknown-target error).Reason for change
The previous AGENTS.md had drifted from the repository: it duplicated information that now lives in the
docs/development/guides and was too long to be effective as an agent entry point. The stale target name made the documented unit-test commands fail.Implementation details
Documentation-only change;
AGENTS.mdonly.Test coverage
Not applicable; no code changes.
Other details