# Axx

> Axx (github.com/nimbusxr/axx, "axxeptance") is a human-readable acceptance testing framework for the agentic era.

- Every page is also available as Markdown: append `.md` to its path (for example `https://axx.nimbusxr.us/tutorials/quickstart.md`).
- Never invent step text. Search the step index (`/references/step-index/`) or run `axx steps search "<intent>"`, then validate with `axx validate`.
- Agent skills: `/.well-known/agent-skills/index.json`. JSON Schema for axx.yaml: `/schemas/v0/axx.schema.json`.
- Axx is pre-release (v0.x): interfaces may change before v1.0.0.

## Documentation Sets

- [Abridged documentation](https://axx.nimbusxr.us/llms-small.txt): a compact version of the documentation for Axx, with non-essential content removed
- [Complete documentation](https://axx.nimbusxr.us/llms-full.txt): the full documentation for Axx
- [Tutorials](https://axx.nimbusxr.us/_llms-txt/tutorials.txt): quickstart, a first suite, and testing with a coding agent
- [Guides](https://axx.nimbusxr.us/_llms-txt/guides.txt): task guides: services, apps, CI, OpenAPI, mocks, SQL, MongoDB, Kafka, logs, cloud services (AWS, Google Cloud, Azure), test data, packs, custom steps, debugging, agents
- [References](https://axx.nimbusxr.us/_llms-txt/references.txt): generated step, CLI and error-code reference, axx.yaml, JSON output and exit codes
- [Explanations](https://axx.nimbusxr.us/_llms-txt/explanations.txt): why Axx, how it works: black-box testing, isolation, step design, OpenAPI, agents

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation