Machine reading
For agents
What an agent can read on this site and in which format: llms.txt, llms-full.txt, each page’s .md twin, the vocabularies as JSON and the pliegos as text.
What there is, and in which format
| Address | Type | What it is |
|---|---|---|
/llms.txt | text/plain | The index for models: what Tórculo is and where everything is. |
/llms-full.txt | text/plain | All of the site’s text, together. |
/en/cheat-sheet.md | text/markdown | The language on one page. |
/en/ten-minutes.md | text/markdown | The first pliego in ten minutes. |
/spec/vocabularios.json | application/json | The 98 closed vocabularies, generated from the parser. |
/spec/diagnosticos.json | application/json | The stable diagnostic codes. |
/pliegos/dirigido.mesa | text/vnd.torculo.mesa | Every gallery pliego, as text. |
Rules for writing pliegos
- Write the pliego in words: the language admits no numbers for time, position or colour; the engine sets them.
- Use only words from the closed vocabularies; a word outside them is an error with a code (E0xx), not an extension.
- Every video has a soundtrack: MÚSICA, AMBIENTE, effects with
sonido:, ESPACIO and MEZCLA. - To extend, by layers: #TALLER and #MANO, then the bestiary (
PYTHON piezas.py), then WGSL passes. Never silently. - Every page of this site also answers in Markdown: the same address ending in
.md.
Content negotiation
Any page on https://torculo.joseluissaorin.com answers in Markdown when asked with Accept: text/markdown or by curl, wget or HTTPie; ?format=html forces HTML. The Tórculo repository is private for now: this site is its only public face.