# Agents

Give coding agents the documentation and project conventions they need to build with Zyzz.

## Give Agents Context

Complete [Getting Started](/docs/introduction/getting-started), then start a coding task with the documentation and the project's existing setup:

Read zyzz.style and inspect the project.

Include the requested change and ask the agent to read the existing config, build integration, components, and project instructions. Use the configured helpers and tokens, and preserve documented preview and unsupported limitations.

### Fetch Documentation

The site serves readable Markdown at documentation URLs ending in `.md`. Fetch a page directly when an agent needs its text:

```sh
# One page as Markdown
curl https://zyzz.style/docs/introduction/agents.md

# The documentation index, which the home page also returns to agents
curl https://zyzz.style/llms.txt
```

[llms.txt](https://zyzz.style/llms.txt) links the Markdown of every guide and API page, grouped as in the sidebar. [llms-full.txt](https://zyzz.style/llms-full.txt) holds all pages in one file. The home page returns the index to agents and to `Accept` headers that prefer Markdown or plain text.

Copy the owning config and build setup alongside examples, since token names and compilation targets are project-specific.

## Add Project Instructions

Record the project's conventions in its agent instruction file, such as `AGENTS.md`. Adapt the import path and checks to the actual repository:

```md title="AGENTS.md"
## Zyzz

- Import style and variants from the project's zyzz.config.ts helpers.
- Reuse configured tokens. Use !custom only for intentional CSS literals.
- Put module-level style definitions in namespace styles at the file's bottom.
- Spread applied style props onto the platform's normal elements.
- Preserve the existing compiler integration and CSS delivery.
- Run the project's type checks and build after style changes.
- Verify layout, interaction states, and color schemes in the rendered app.
```

These instructions apply the project's conventions to future tasks. They do not require a dedicated Zyzz agent server.
