# A guide for coding agents

October 12, 2026 · Docs

[Coding agents](https://developer.layout.link/reference/coding-agents) is a new guide for handing a Layout integration to a coding agent. It names the one step a person does first (sign up and make a CLI token), what the agent runs from there, the rules it must follow, and a prompt to start it with. `llms.txt` now points an agent to it first.

## What changed

- **One name for your secret.** Every reference example now reads the secret from `LAYOUT_SECRET_KEY`, the variable the CLI already reads, instead of `LAYOUT_SECRET`. The quickstart no longer asks for the client id, which no step uses.
- **Going to production.** [Going to production](https://developer.layout.link/reference/environments#going-to-production) said swapping in the `sk_live_` secret was the whole migration. It now also covers the production signing secret, what answers differently in production (phone numbers, test restaurants, confirms), and keeping `sk_live_` and development webhook endpoints away from production.
- **Calling person routes from the CLI.** The [Call the API](https://developer.layout.link/reference/cli#call-the-api) example sent `GET /v1/places` with your key, which answers `401`. Places, menus, item images and carts take a person's build grant or access token in `--token`.
- **The listen secret.** `layout listen` signs with a new secret on every run. The CLI reference now says to give your server that run's secret each time.
- **Sandbox confirms.** A sign-in test account's confirm over REST answers `placing`, as every REST confirm does. The page said `placed`.
- **The retired order route.** `POST /v1/orders` is marked `deprecated` in [openapi.json](https://developer.layout.link/openapi.json), so a client generated from it flags `createOrder`, which always answers `410`. Build with `POST /v1/carts`.
- **Markdown copies.** The Markdown version of every page, and `llms-full.txt`, now show characters such as `•` and `×` instead of their HTML codes.

## What to do

Nothing. If you generated a client from `openapi.json` and it calls `createOrder`, move that call to [Carts](https://developer.layout.link/reference/carts); it has answered `410` since the route was retired.

## Breaking changes

None. The API did not change; the pages now describe what it already does.