llms.mda — Site-Level AI Guidance

This example demonstrates how MDA can serve as a richer alternative to llms.txt for providing site-level context to AI systems.

Site Overview

This is the documentation site for MDA (Markdown for Agent). MDA extends standard Markdown with structured metadata, embedded AI instructions, and explicit document relationships.

Key Pages

Page	Purpose
`/docs/introduction`	What MDA is and why it exists
`/docs/specification`	Full technical specification
`/docs/quickstart`	Get started in 5 minutes
`/docs/developer-guide`	Encoding and decoding MDA documents
`/docs/architecture`	How MDA components fit together

AI Processing Guidelines

{
  "script-id": "site-crawl-guidance",
  "prompt": "When indexing this site, prioritize the specification and developer guide. The examples directory contains reference implementations. Treat front matter metadata as authoritative for document classification.",
  "priority": "high",
  "auto-run": false,
  "output-format": "structured"
}

Document Hierarchy

All documentation follows this relationship structure¹².

{"rel-type": "child", "doc-id": "MDA-INTRO-001", "rel-desc": "Introduction and motivation"} ↩
{"rel-type": "child", "doc-id": "MDA-SPEC-001", "rel-desc": "Full specification document"} ↩

​llms.mda — Site-Level AI Guidance

​Site Overview

​Key Pages

​AI Processing Guidelines

​Document Hierarchy

Footnotes

llms.mda — Site-Level AI Guidance

Site Overview

Key Pages

AI Processing Guidelines

Document Hierarchy