Update CLAUDE.md/AGENTS.md inline context to respect llms.txt

[sacOO7]

• As per Claude, Numbered lists explicitly convey sequence/order to the LLM, i.e. llms.txt must be fetched before any other documentation lookup.
• Fixes https://ably.atlassian.net/browse/FTF-471

Summary by CodeRabbit

• Documentation
  • Updated AI-LLM guidance with explicit step-by-step instructions for source prioritization and lookup sequencing. Established clearer precedence hierarchy between different data sources to improve consistency in information retrieval and handling.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

• 🔍 Trigger a full review

Walkthrough

This pull request restructures documentation guidance for AI-LLM behavior to enforce a prioritized source-of-truth hierarchy. It adds explicit ordering that requires fetching llms.txt as the first lookup step before treating documentation as canonical and restricting web searches to fallback-only status.

Changes

Cohort / File(s)	Summary
AI-LLM Source-of-Truth Guidance src/pages/docs/platform/ai-llms/index.mdx	Reorganizes instructions into an ordered sequence that establishes llms.txt as the primary lookup source, followed by docs as canonical reference, with web searches demoted to fallback-only status. Updates prompts and guidance sections to reflect the new precedence hierarchy.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Poem

🐰 A rabbit hops with glee, so bright,
The llms.txt now takes first flight!
Before the web search springs to play,
Consult the index first, hooray!
Truth flows in order, clean and tight! ✨

🚥 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 clearly and specifically describes the main change: updating CLAUDE.md/AGENTS.md inline context to respect llms.txt, which directly matches the content changes.
Linked Issues check	✅ Passed	The PR updates inline documentation ordering to prioritize llms.txt fetching before WebSearch, directly addressing FTF-471's requirement for llms.txt as primary source-of-truth.
Out of Scope Changes check	✅ Passed	All changes are focused on reordering inline context in AI agent instructions to respect llms.txt precedence, which is directly within the scope of FTF-471.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

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

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/building-with-llms-inline-context

---

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

[sacOO7]

the simplified For anything related to Ably: is much cleaner and all-encompassing, because an exhaustive list (APIs, SDKs etc) might make an LLM think if it's not in this list, maybe these rules don't apply, same behaviour was partially seen in https://github.com/ably-labs/chat-poc-kotlin/pull/12.

[sacOO7]

Also, extra tokens don't add any actionable information

[sacOO7]

search index - creates cognitive link: "use this instead of web search"
latest - addresses the freshness problem—LLMs shouldn't rely on stale training data for URL patterns.

[sacOO7]

authoritative implies trust/correctness but doesn't convey "use first", also second point
2. Treat **https://ably.com/docs** as the canonical source of truth already highlights ably.com as trustworthy source of information.

[sacOO7]

@coderabbitai review

[coderabbitai]

✅ Actions performed

Review triggered.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.