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.
a/<slug>.htmlFor peopledata/v1/<slug>.jsonFor codeprompt/<slug>.mdFor a coding agentRecords
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
{
"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
# 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
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.