docs: add signpost llms.txt + consolidate agent instructions into AGENTS.md#570
Merged
Conversation
Replace the duplicated Key Rules / Architecture / sandbox content in .github/copilot-instructions.md with a thin pointer to AGENTS.md, the single source of truth. CLAUDE.md already @-imports AGENTS.md; this brings the Copilot instructions to the same convention and drops slightly stale decorator names (@to_array/@to_grid/@to_vector_yx) in favour of AGENTS.md's accurate aa.decorators.* guidance. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Thin front-door llms.txt at the repo root following the llms.txt convention (H1 + blockquote summary, then sections of one-line links). It only points — no source-tree catalogue, no AGENTS.md/docs duplication — routing an LLM by intent: use the API (workspace navigator), learn lensing (HowToLens), read the docs (ReadTheDocs), work on the library (AGENTS.md), or follow the upstream ecosystem repos. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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
1 participant
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
Adds a thin signpost
llms.txtat the repo root and consolidates the remaining duplicated agent instructions into the canonicalAGENTS.md.llms.txt(new, 20 lines)A front-door file following the llms.txt convention (one H1, a blockquote summary, then sections of one-line links). It only points — no source-tree catalogue, no duplication of
AGENTS.mdor the docs — routing an LLM by intent:llms.txt) + HowToLensAGENTS.mdAll links verified live (PyAutoLabs org remotes; workspace
llms.txtpresent onorigin/main; ReadTheDocs URL confirmed from the README +.readthedocs.yaml)..github/copilot-instructions.md(consolidated)Replaced the duplicated Key Rules / Architecture / sandbox blocks with a thin pointer to
AGENTS.md(the single source of truth, matchingCLAUDE.mdwhich already@-imports it). Also drops the slightly stale@to_array/@to_grid/@to_vector_yxdecorator names in favour ofAGENTS.md's accurateaa.decorators.*guidance.Scripts Changed
None — docs only.
API Changes
None.
🤖 Generated with Claude Code