Skip to content

AGENTS.md: Add retrieval-led reasoning note, simplify doc links#489

Merged
jahooma merged 2 commits intomainfrom
jahooma/agents-read-docs
Mar 31, 2026
Merged

AGENTS.md: Add retrieval-led reasoning note, simplify doc links#489
jahooma merged 2 commits intomainfrom
jahooma/agents-read-docs

Conversation

@jahooma
Copy link
Copy Markdown
Contributor

@jahooma jahooma commented Mar 31, 2026

Summary

  • Added a note instructing agents to prefer retrieval-led reasoning over pre-training-led reasoning and to always read relevant docs before implementing changes
  • Simplified the docs table of contents by removing markdown links (plain paths are sufficient)

Test plan

  • Verify agents read docs before making changes in areas covered by the docs

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Parses agent traces for Read tool calls targeting docs/, AGENTS.md, and
CLAUDE.md. Reports per-feature and aggregate doc read counts in both
console output and the JSON results file.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@jahooma jahooma merged commit c43fbdd into main Mar 31, 2026
34 checks passed
@jahooma jahooma deleted the jahooma/agents-read-docs branch March 31, 2026 19:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant