---
url: https://brand.okrado.com/start/humans-and-agents/
title: Use this site as a person or as an agent
description: "Where a designer, a developer and an agent each find the same facts: pages, markdown twins, manifests and tokens."
kind: how-to
owner: hmdmsd
updated: 2026-11-03
review_by: 2027-02-28
audience:
  - designer
  - developer
  - agent
---

# Use this site as a person or as an agent

> Where a designer, a developer and an agent each find the same facts: pages, markdown twins, manifests and tokens.

The same facts reach you three ways. None of them is a copy of another: the pages, the markdown and the manifests are generated from the same sources.

## As a designer or developer

1. Start with [Principles](https://brand.okrado.com/start/principles/), then the [foundations](https://brand.okrado.com/foundations/colour/) you need.
2. Find a component in the [catalogue](https://brand.okrado.com/catalog/) and open its docs page in [Storybook](https://brand.okrado.com/components/).
3. Take values from the [token browser](https://brand.okrado.com/tokens/browser/), never from a screenshot. A token you need that does not exist is a change to `@okrado/brand`, not a local value.

## As an agent

Every page has a markdown twin at its own address plus `.md`, and `/llms.txt` lists them all.

Terminal window

```sh
curl -s https://brand.okrado.com/llms.txt
curl -s https://brand.okrado.com/foundations/colour.md
curl -s https://brand.okrado.com/components/manifests/components.json
```

| You want                   | Read                                                                          |
| -------------------------- | ----------------------------------------------------------------------------- |
| The list of pages          | `/llms.txt`                                                                   |
| A page as clean markdown   | the page URL plus `.md`                                                       |
| Components, props, stories | `/components/manifests/components.json` and `/components/manifests/docs.json` |
| Tokens                     | [`tokens.json`](https://brand.okrado.com/tokens/downloads/) and the CSS files |

Every page also links its twin and `llms.txt` in its `<head>` (`rel="alternate" type="text/markdown"` and `rel="describedby"`), and the front matter says who owns the page and when it is next reviewed.