Raw: https://promptreports.ai/docs/machine.md

# Machine-readable files

Each file an agent can fetch, what it holds and whether it exists today.

| Path | What it holds | State |
|---|---|---|
| `/llms.txt` | A short map for agents: what PromptReports is, and links to the docs, the use cases and the MCP server. | Built |
| `/llms-full.txt` | Every docs page and every use case in one text file. | Built |
| `/docs/<page>.md` | The Markdown twin of every docs page. | Built |
| `/use-cases/index.json` | Every workflow: id, title, state, products, plan URL. | Built |
| `/use-cases/<id>/openspec.md` | The plan for one workflow. | Built |
| `/openapi.json (api.promptreports.ai)` | The REST API. | Proposed |
| `/.well-known/oauth-protected-resource (mcp.promptreports.ai)` | Where MCP clients find the authorization server. | Proposed |
| `/family.json` | Every product and join, with its state and evidence. | Built |

## llms.txt, with the docs added

```
# PromptReports

> PromptReports LLC builds and runs software products. Each one keeps a
> record you can check: what an AI agent did, what a team promised, where a
> claim came from.

## Docs

- [Quickstart](https://promptreports.ai/docs/quickstart.md): connect, get a token, run
- [Concepts](https://promptreports.ai/docs/concepts.md): workflow, run, step, approval
- [MCP](https://promptreports.ai/docs/mcp.md): https://mcp.promptreports.ai/mcp
- [Use cases](https://promptreports.ai/use-cases/index.json): every workflow and its plan

## Products

- [RepoOps](https://repoops.ai): Trace a production error to the agent session behind it.
- [PromptCompute](https://promptcompute.ai): A person approves what touches the world.
...
```