Summary
Add the AI-agent memory-file layer recommended by the emerging cross-tool standards:
AGENTS.md — a universal, cross-tool agent brief (the open AGENTS.md standard, read by Claude Code, Cursor, Copilot, Gemini CLI, Aider, etc.). Holds the shared project context: stack, commands, standards, testing, architecture, safety.
CLAUDE.md — slimmed so shared content is single-sourced: it @imports AGENTS.md and keeps only Claude-specific material (operating index, docs/_base/ imports, Safety lists, Learnings). Stays within its 150-line budget.
llms.txt + llms-full.txt — repo-root files following the llms.txt spec: llms.txt is an H2-sectioned navigable index of the docs tree; llms-full.txt inlines the core docs for full-context LLM consumption.
Rationale
The repo currently has only CLAUDE.md, which is Claude-only. AGENTS.md is the Linux-Foundation-backed open standard that any agent reads; adding it makes the repo's context portable across tools without duplicating instructions. llms.txt gives any LLM a clean, markup-free map of the documentation.
Out of scope / notes
- Two local
.claude/skills/ skills (managing-agent-memory, managing-llms-txt) generate and maintain these files, but .claude/ is gitignored — those are local-only and not part of this PR.
- No Cursor/Copilot symlinks — single-maintainer repo; AGENTS.md only.
Acceptance
Summary
Add the AI-agent memory-file layer recommended by the emerging cross-tool standards:
AGENTS.md— a universal, cross-tool agent brief (the open AGENTS.md standard, read by Claude Code, Cursor, Copilot, Gemini CLI, Aider, etc.). Holds the shared project context: stack, commands, standards, testing, architecture, safety.CLAUDE.md— slimmed so shared content is single-sourced: it@importsAGENTS.mdand keeps only Claude-specific material (operating index,docs/_base/imports, Safety lists, Learnings). Stays within its 150-line budget.llms.txt+llms-full.txt— repo-root files following the llms.txt spec:llms.txtis an H2-sectioned navigable index of the docs tree;llms-full.txtinlines the core docs for full-context LLM consumption.Rationale
The repo currently has only
CLAUDE.md, which is Claude-only.AGENTS.mdis the Linux-Foundation-backed open standard that any agent reads; adding it makes the repo's context portable across tools without duplicating instructions.llms.txtgives any LLM a clean, markup-free map of the documentation.Out of scope / notes
.claude/skills/skills (managing-agent-memory,managing-llms-txt) generate and maintain these files, but.claude/is gitignored — those are local-only and not part of this PR.Acceptance
AGENTS.mdcreated with accurate, repo-verified commandsCLAUDE.md@importsAGENTS.md, no duplicated content, ≤150 linesllms.txt+llms-full.txtfollow the spec format