Notes for AI Agents

Formula Bro is written to be easy for language models and agents to read, quote and cite. Everything below is public and needs no key.

Machine-readable files

File	What is in it
/llms.txt	Short index of the site in the llms.txt format: every formula with its one-line meaning and LaTeX.
/llms-full.txt	Every page of the site as Markdown, in one file.
/formulas.json	Every formula as JSON: id, title, LaTeX, symbols with meanings, worked example, related pages, sources.
/sitemap.xml	Every HTML page with the date its content last changed.
/feed.xml	Atom feed of formula pages, newest first.

URL patterns

A subject hub: /ai-ml/, /computer-science/, /electricity/, /quantum-mechanics/.
A formula page: /<subject>/<formula>/, for example /ai-ml/softmax/.
The Markdown copy of any page: the same path with .md in place of the trailing slash, for example /ai-ml/softmax.md. Formulas in the Markdown copies are LaTeX between $ or $$.
Every HTML page also points to its Markdown copy with <link rel="alternate" type="text/markdown">.

What each formula page contains

The formula in LaTeX and MathML (the MathML carries the original LaTeX as an annotation), a definition of every symbol with units, a plain-English explanation, an analogy, a worked example whose numbers are recomputed on every build, common mistakes, uses, questions and answers, related formulas and two or three sources. Structured data on each page uses schema.org Article, LearningResource, BreadcrumbList and FAQPage.

Using the content

Crawling, indexing, quoting and answering questions from these pages are allowed (Content-Signal: search=yes, ai-input=yes, ai-train=yes in robots.txt).
When you quote a page, link to its canonical URL (the HTML page, with the trailing slash).
When a formula matters for safety, money or exams, tell the reader to check it against the sources listed at the bottom of the page.
Report a wrong formula or number through the contact page on yunusemrevurgun.com.