Developers

Every Aesthetic is also published as files: a JSON record for code and a Markdown guide for coding agents, with each rule’s basis and sources intact. They are static files. There is no API, no endpoint and no key: fetch a file or download it.

One record per AestheticThe research, written once
The pagea/<slug>.htmlFor people
The recorddata/v1/<slug>.jsonFor code
The agent guideprompt/<slug>.mdFor a coding agent
Each Aesthetic's record is written once and published three ways: the page you read, a JSON file for code, and a Markdown guide for a coding agent. The JSON and the guide are the two to build on.

Records

Use these when your code needs the distinctions: which rules are established, which are our reading, and which sources support or dispute each one.

One JSON file per Aesthetic, at data/v1/<slug>.json. 73 files, listed in data/v1/index.json. That is the whole corpus; the public collection on this site shows 28 of them. 19 index entries carry a hold field: cultural_review for the 17 waiting for cultural review, on_hold for the 2 on hold while we decide how they fit the collection. Their files stay fetchable, but no other record’s relations point at them. Every file follows one versioned contract, aesthetary.record/1.0, and every claim carries a label from data/v1/vocabulary.json.

data/v1/swiss-style.json88 KBDownload

data/v1/swiss-style.json, excerpt
{
  "contract": "aesthetary.record/1.0",
  "record_spec": "1.1.0",
  "slug": "swiss-style",
  "name": "Swiss Style",
  "research": {
    "line": "partly_sourced",
    "text": "Partly sourced",
    "sentence": "39 sources attached."
  },
  "claims": [
    {
      "id": "typeface-class",
      "text": "Set type in a neutral grotesque. The constraint is the class, not a particular typeface: Akzidenz-Grotesk, Univers, Folio and Neue Haas Grotesk/Helvetica were all in use.",
      "role": "rule",
      "area": "typography",
      "basis": "documentary",
      "support": {
        "state": "observed_instances",
        "for": [
          "27D7CC8XB2P23RTWQ7C7MZ989T",
          "6MW5YYXFWYJ9N6NN8SQS0139K3",
          "3R8W6YP0GEV1AP0RNEZ4XCAZFN",
          "6BZR71FJJRHDGSM5S95C27MKNH",
          "19RCMYFWNKC88RZ2D2A7G6X248"
        ],
        "against": [],
        "contested": false
      },
      "label": {
        "kind": "seen",
        "text": "Seen in the work"
      },
      "strength": [
        {
          "signal": "necessary",
          "set_by": "synthesis",
          "label": {
            "text": "Necessary · our ranking"
          }
        }
      ],
      "derives_from": []
    }
  ],
  "sources": [
    {
      "id": "27D7CC8XB2P23RTWQ7C7MZ989T",
      "kind": "source",
      "title": "Josef Müller-Brockmann",
      "url": "https://www.thegraphicdesignschool.com/design-history/joseph-mueller-brockmann/",
      "status": "verified",
      "retrieval": "retrieved"
    }
  ]
}

An excerpt: the header fields, then the first of 56 claims and the first of 40 sources, exactly as they appear in the file.

Also: data/v1/index.json (the list to loop over) · data/v1/vocabulary.json (what each label means)

Agent guides

Paste one into a coding agent before you ask it to design or build in that visual language.

One Markdown file per Aesthetic, at prompt/<slug>.md. 54 files. The 19 waiting for cultural review or on hold don’t get one yet; their JSON records are above. Each says what is established, what is our interpretation, and what nobody has established, so the agent treats the three differently.

prompt/swiss-style.md42 KBDownload

prompt/swiss-style.md, the opening
# Swiss Style — style guide for coding agents

> Generated from the Aesthetary record for **Swiss Style**.
> Research: **Partly sourced** · Build guidance: 38 rules recorded.
> 39 sources attached.

## How to use this

Paste this file into your agent as context before asking it to design or build something in this visual language. It states what is established, what is our interpretation, and what nobody has established. Treat all three differently.

**The most important section is "Not researched yet".** Its purpose is to stop you and your agent inventing rules that sound right and are not recorded anywhere.

Kits

A zip for three Aesthetics: the record and the agent guide together, and for Swiss Style its design grammar, tokens and reference plates as well.

kit/fashion-editorial.zip15 KBDownload

kit/quiet-luxury.zip21 KBDownload

kit/swiss-style.zip579 KBDownload

The site’s own indexes

These are the files this site’s search and Mix load. They are shaped for the site and carry no version, unlike the records, so build on the records.

search-index.json
559 entries: 28 Aesthetics, 8 stages, 105 skills, 233 resources, 10 help, 12 site pattern, 7 page pattern, 4 who it’s for, 123 glossary, 29 element. What the search box searches.
mix-data.json
28 Aesthetics with their rules by area. What Mix loads.

Reusing them

No license for the records, guides or kits has been published yet. The sources each record cites keep their own terms. See Licensing and attribution, and how the machine layer is built.