Use with AI agents

Every page of this site ships inside the published package, as plain markdown at node_modules/@wych/react/docs. Point at it from your AGENTS.md or CLAUDE.md.

## @wych/react

This project uses `@wych/react`, a feature runtime for React built on
Effect: pure reducers, commands as data, headless tests.

The docs are local, as markdown:

    node_modules/@wych/react/docs

Read `index.md` first. Then `reference/` for the API you are using,
`how-to/` for a recipe, `explanation/` for why the model works this way.
Do not invent APIs: every export is listed under `reference/`.

Prove async logic with `feature.run` in a test file; see
`how-to/test-a-feature-without-react.md`.

Read them over HTTP

Two routes serve the same content over HTTP.

# One line per page, with links.
curl https://wych.build/llms.txt

# Every page concatenated into one document.
curl https://wych.build/llms-full.txt

The layout

The tree follows Diátaxis. The directory says what a page is for, which is the cheapest signal an agent can use to pick one.

docs/
  index.md          # the section map
  tutorial/         # lessons, numbered in reading order
  how-to/           # recipes for a task you already have
  reference/        # one page per API area
  explanation/      # why the model is shaped this way

Send an agent to reference/ for a signature and how-to/ for a working file set. The model is the one page worth reading before writing any feature.