Skip to content

docs: add AI agent instructions (AGENTS.md, AGENT_INSTRUCTIONS.md, llms.txt) - #542

Merged
alorma merged 2 commits into
mainfrom
claude/agents-instructions-cp3fhn
Oct 17, 2026
Merged

alorma merged 2 commits into
mainfrom
claude/agents-instructions-cp3fhn

Conversation

@alorma

@alorma alorma commented Oct 17, 2026

Copy link
Copy Markdown
Owner

Description

Makes the repo easy to use for AI agents (Claude, Codex, Copilot, Cursor, ...), with separate entry points for people who use the library and people who contribute to it.

Type of Change

  • Documentation update

Changes Made

  • AGENTS.md: former CLAUDE.md content (contributor guidance), with a header pointing consumers to the new guide. CLAUDE.md now just imports it with @AGENTS.md.
  • docs/AGENT_INSTRUCTIONS.md: guide for integrating the library. Covers module choice (standard vs expressive), dependencies, component signatures taken from the source, minimal examples, groups/enabled state and common mistakes.
  • llms.txt: index for LLMs.
  • README.md: new "For AI agents" section.
  • .github/pull_request_template.md and ARCHITECTURE.md: references updated from CLAUDE.md to AGENTS.md.

Testing

Documentation only; nothing was compiled or run. Signatures were copied from the module sources.

Note: the README documents a textStyles parameter that no component currently has. The new guide deliberately omits it; the README could be fixed separately.

Checklist

  • I have updated the documentation (README, KDoc, etc.) if needed

Generated by Claude Code

Move contributor guidance to AGENTS.md (CLAUDE.md now imports it), add
docs/AGENT_INSTRUCTIONS.md for consumers and llms.txt as an index.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DsCpFqZQrQCCmrjaKRM9wm
@alorma
alorma merged commit 09b91e7 into main Oct 17, 2026
3 checks passed
@alorma
alorma deleted the claude/agents-instructions-cp3fhn branch October 17, 2026 17:02
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.

2 participants