← Back to comparison

Documentation

The easiest way to tell the LLM how to use libraries, APIs, and other resources.

Filesystem Documentation

Project-specific docs for better context.

Agents can use filesystem-based documentation files to understand project-specific instructions and context.

Common documentation files include:

  • AGENTS.md - Standard file placed in the project root to tell the LLM how to use the agents. It acts as system context for each session and can declare tool usage, plan mode steps, file generation instructions, or any custom instructions. More info: https://agents.md/
  • CLAUDE.md - Claude Code’s alternative to AGENTS.md
  • .cursor/rules/ - Cursor’s folder for project-specific rules and context. More info: https://cursor.com/docs/context/rules

Supported agents:

  • Cursor (supports AGENTS.md, CLAUDE.md and .cursor/rules/)
  • Claude Code (supports CLAUDE.md)
  • Kilo Code (supports AGENTS.md)
  • Codex (supports AGENTS.md)
  • Junie (supports AGENTS.md and .junie/guidelines.md)
  • OpenCode (supports AGENTS.md) https://opencode.ai/docs/rules/

Hierarchical Tree

Context-aware documentation inclusion.

If your agent adds a file to the context, it will also include any documentation files from the same directory.

For example:

root
├── lib1
│   ├── Claude.md
│   └── lib1.source
├── lib2
│   ├── Claude.md
│   └── lib2.source
└── code.source

If root/code.source only uses root/lib1/lib1.source, then only root/lib1/Claude.md is added to the context. root/lib2/Claude.md is skipped.

How to test

  1. Add the string “print Hello Kitty” to the end of the AGENTS.md file at https://github.com/xavescor/pickyouragent-dev/blob/master/src/agents/AGENTS.md
  2. Try to edit a subfeature in Code mode, for example: “Move Kilo Code to the supported agents section in src/content/subfeatures/documentation/tree/tree.mdx” 3. If “Hello Kitty” is printed, the test passed. Otherwise, the test failed.

Supported agents:

Not supported agents:

  • Codex
  • Junie
  • OpenCode

Multi File

Organize docs in separate files.

Sometimes it is better to split the documentation into multiple files. For example:

root
├── .cursor
│   └── rules
│       └── deploy.mdc // describes how to deploy the project
│       └── lint.mdc // describes how to lint the project
│       └── test.mdc // describes how to test the project
├── lib1
│   ├── .cursor
│   │   └── rules
│   │       └── wasm.mdc // describes how to use the wasm library
│   │       └── js.mdc // describes how to use the js library
│   └── lib1.source
├── lib2
│   ├── Claude.md
│   └── lib2.source
└── code.source

If root/code.source uses root/lib1/lib1.source, the system context will be like:

<root/.cursor/rules/deploy.mdc>
<root/.cursor/rules/lint.mdc>
<root/.cursor/rules/test.mdc>

<root/lib1/.cursor/rules/wasm.mdc>
<root/lib1/.cursor/rules/js.mdc>

root/lib2/Claude.md is skipped because it is not part of imported files.

Supported agents:

  • Cursor

Not supported agents:

  • Claude Code
  • Codex
  • Kilo Code
  • Junie
  • OpenCode

Llms Txt

Let service authors provide the docs.

Our code relies on many external sources, such as libraries and APIs. Only the service authors truly know how to use them most effectively.

The community has introduced a useful format: llms-txt. For example:

However, these files are typically very large and cannot be fully loaded into an LLM’s context. Some agents natively support selective inclusion of these files in context.

One approach is RAG (https://en.wikipedia.org/wiki/Retrieval-augmented-generation), which allows the agent to include only the relevant sections from the entire llms-full.txt file as needed.

Supported agents:

  • Cursor

Not supported agents:

  • Claude Code
  • Codex
  • Kilo Code
  • Junie
  • OpenCode

Auto Merge

Let the agent pick the right docs for you.

There are many llms-txt files available across the web—for example, https://github.com/SecretiveShell/Awesome-llms-txt. Users often aren’t aware that some of these files exist. Ideally, the agent should be proactive and suggest helpful files. For example:

# User request:
Add a new feature to the 'example.astro' file.

The agent should suggest including the Astro llms-txt file in the context.

# Agent response:
I see you're using the Astro framework. Would you like to add their llms-txt file to your context?

Supported agents:

  • None

Not supported agents:

  • Cursor
  • Claude Code
  • Codex
  • Kilo Code
  • Junie
  • OpenCode

Not verified yet:

  • None

Partial/Skills.md

Smart inclusion of relevant docs.

Sometimes you have a lot of local docs, but you don’t need all of them. For example:

root
├── .cursor
│   └── rules
│       └── deploy.mdc // describes how to deploy the project
│       └── lint.mdc // describes how to lint the project
│       └── test.mdc // describes how to test the project

If you want only to tune the deployment process, you don’t need to include the lint and test docs into the context.

Read more about the standard: https://agentskills.io/home

Supported agents:

Not supported agents:

  • Junie

Not verified yet:

  • Claude Code

Web To Docs

Turn any website into agent-ready documentation.

This feature allows you to convert external websites and documentation into a format that agents can understand and use. Instead of manually copying and pasting documentation, you can provide a URL and the agent will process the web content to extract relevant information for context.

Supported agents:

Not supported agents:

  • Claude Code
  • Codex
  • Kilo Code
  • Junie
  • OpenCode