Machine-readable by default

Write once.
Read without translation.

One canonical source for people and agents. Human context, raw Markdown, and a stable discovery contract stay in sync.

discovery

GET /.well-known/agent-docs.json

{
  "version": "1",
  "format": "markdown",
  "indexUrl": "/docs/index.json"
}

Stable interface

01Canonical Markdown

02Structured catalog

03Stable routes

Start with the source

Document catalog

Every card opens the exact Markdown an agent receives.

Orientation

Understand the interfaces and retrieve the catalog.

Contract

Write documents that remain useful to both readers.

Operations

Add, validate, and deploy a document safely.

Catalog metadata is published at /docs/index.json.

One source, two readers

SourceMarkdown

DiscoveryJSON index

ReadersPeople + agents