> ## Documentation Index
> Fetch the complete documentation index at: https://mda.sno.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# llms.mda — Site-Level AI Guidance

> Example of using MDA as a replacement for llms.txt, providing richer site-level context for LLM crawlers and agents.

# 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

```ai-script theme={null}
{
  "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[^intro][^spec].

[^intro]: `{"rel-type": "child", "doc-id": "MDA-INTRO-001", "rel-desc": "Introduction and motivation"}`

[^spec]: `{"rel-type": "child", "doc-id": "MDA-SPEC-001", "rel-desc": "Full specification document"}`