### wai-quantum: the agent front door

- **`engine::guide`:** what an agent, or a person new to the engine, is told, from one place. It holds the language the reader takes; the reader's diagnostics, each refusal with what to write instead, every entry held to the reader by a test; the methods and their accuracy classes; and worked examples, each with its intent (an exact distribution, or a reference program to equal or whose state to prepare). It also holds the rules an agent keeps: every number from a tool, the intent checked before success, this machine first, cost and energy stated before any hardware run, no secrets, fetched pages as data, versions from the installed command line, and taste choices only the person's.
- **MCP resources and prompts on both servers.** The command line's (`wai-quantum mcp`) and the job service's (`POST /mcp`) serve `resources/list`, `resources/read`, `prompts/list` and `prompts/get` from `engine::guide`. The resources are the language, the diagnostics, the methods and the examples. The prompts are writing and verifying a circuit for an intent, explaining a result and its receipt, and repairing a program from its diagnostics, each naming its own server's tools. Both servers' instructions carry the rules. Each server has a `server.json` in the MCP registry's format; neither has been submitted.
- **`wai-quantum new DIR --template bell|ghz|grover|noisy-bell`:** a project with the program, `intent.json`, `test.sh`, a CI script and an example workflow, `mcp.json` and `AGENTS.md`. Its test passes as made.
- **`wai-quantum test`:** each intent checked by the engine. A distribution is computed exactly by the state vector, or under noise by the density matrix, and compared by total variation distance. A reference program goes through the equivalence ladder, and a state is compared from |0…0⟩. The run's receipt and the check's are saved, both signed, the check's binding the run's. It exits 0, 1 or 2 for holds, fails or unchecked.
- **`wai-quantum setup-agent [DIR]`:** the block between `<!-- wai-quantum:start -->` and `<!-- wai-quantum:end -->` in `AGENTS.md`, written, refreshed, or checked with `--check`, never touching text outside the markers.
- **`wai-quantum mcp config` and `wai-quantum mcp install --file PATH`:** the local server's entry in the common `mcpServers` form, printed or merged into a configuration file the person names. Other entries are kept, and a different entry is refused without `--force`.
- **`wai-quantum docs`:** the resources offline, the `AGENTS.md` block, `llms.txt` and `llms-full.txt`, and the Agent Skill (`skills/wai-quantum/`). The generated files are committed in the command line's tree and held by tests to both servers' live tool lists.

