The LLM front door

CX is a homoiconic data-and-code language: one bracketed element syntax for documents, queries, programs and its own AST. It post-dates every model's training data, so this layer is the context an assistant needs to write it correctly. This directory is that context — 13 documents, every code example in them a conformance fixture whose output was re-recorded by the cx that built them, so an assistant that loads them learns the language the binary actually runs.

Three doors to one text

• cx primer — the door that cannot go stale: the installed binary prints the primer it was built with.
• /llms.txt — the llmstxt.org index of this directory, and /llms-full.txt, all of it in one fetch.
• AGENTS.md — the vendor-neutral agent instructions at the root of the front door, which point here.

Start here

The one file to load before writing CX.

• CX primer for LLM assistants — The one file to load before writing CX. The surface taught through runnable examples, a ring decision table, the core idioms, and the anti-patterns that Lisp/Clojure/shell priors produce — each with its real diagnostic — and, near the top, the forms a model arriving from another language reaches for that do not exist, each beside the cx form.llm/primer.md

Building something

The arc from a feature grammar to a deployment, and the question an adopter asks first.

• Playbook: building a production XAP — The full arc for a production feature deployment: authoring and composing feature grammars, derived nouns and deriver principals, the authority model, the *.xap.cxd deployment document and its [runtime] bindings, offline identity bootstrap, the deployment host, and the ux-web hypermedia surface — with what the rulings forbid stated as plainly as what they require.llm/playbook-xap.md
• The customization model: what one tenant may change — The question an adopter asks first and the layer answers in seven places: what a tenant may change, what must change for everyone, how a change reaches a fleet on both the surface and the grammar plane, and why behaviour is not tenant-customizable — the refusals stated as the promise they enforce rather than as friction.llm/model-customization.md

Contributing to CX

The rules for changing CX, each citing its decision and the step that holds it; the facts projected from the registries.

• Contributor front door: the rules, and what to load — The second read after the primer, for changing CX rather than writing it: the rules for the best long-term change, each citing its decision and the step that holds it, the RS-n standing decisions in the ledger's own words, and the reading order that loads the least for each task.llm/contributor.md
• Contributor: architecture — The two rings and the groups above them, the repository map and the pins the front door builds from (both projected from the registry), the registration hooks that keep the core free of product names, and the two-repository modules.llm/contributor-architecture.md
• Contributor: design — a surface before its code — How a surface gets its decision, ring, group, registry row, spec and corpus before any code: the six-artifact order, the ring questions, the row's columns and where every row lives today, projected from registry/modules.cxd.llm/contributor-design.md
• Contributor: implementation — Writing V for CX: one V module per directory, imports downward only, the pub surface as the interface, the registration hooks, the front door's assembled build from the pins, and tooling written in CX.llm/contributor-implementation.md
• Contributor: test — Grading the corpus with cx corpus, choosing steps by the computed selection, the umbrellas and the census trio, the two runners, and the step roster the Makefile runs, projected from TEST_TARGETS.llm/contributor-test.md

Reference

One file per area, loaded only when the task needs it.

• Reference: the CX data language — Elements, attributes, scalars and their auto-typing, collections, raw text, tables, identity anchors, and the format conversions the data reading offers.llm/reference-data-language.md
• Reference: the CX code language — The directive surface — binding, control flow, comprehensions, pattern matching, definitions, pipes, CXPath — and how errors propagate as values.llm/reference-code-language.md
• Reference: the standard library — The bundled module catalog, the [?lib] import form, and the capability each effectful pack requires.llm/reference-stdlib.md
• Reference: the cx command line — The run surface, the convert surface, the subcommand catalog, and the capability grant flags — including the flag-placement rule that silently denies capabilities when broken.llm/reference-cli.md
• Reference: the platform and ecosystem rings — The platform group (store, journal, HTTP, XAP host) and the bindings and ecosystem groups (agent interop, feature distribution, language bindings) — what is reachable and how.llm/reference-platform.md

Generated by scripts/gen_docs/primer_build.cx from docs-src/llm/ and the conformance corpus; this door by scripts/gen_site/llm_index.cx from the same manifest. Never edit a file under llm/ by hand — make docs-check refuses the drift.