# runbooks.directory

A specification and catalog of operational runbooks, and the execution contract that
lets an agent be held to one.

## Start here

Index (T2 and above): /v1/index.json
One record: /v1/runbooks/{publisher}/{slug}.json
A pinned version: /v1/runbooks/{publisher}/{slug}/{semver}.json

Each index entry carries a `ref` of the form {publisher}/{slug}@{semver}. Split it to
build the record path; no page needs to be read to find one.

## Before you run anything

Obligations: /agent.txt
Contract: /spec/v1/api.md
Execution contract: /spec/v1/execution-contract.md
Trust ladder: /spec/v1/trust.md
Schema: /spec/v1/schema.json

## What is here

Records at T2 or above: 30
Below T2, on request: /v1/index.untrusted.json

## Everything else this catalog serves

/v1/aliases.json — slugs that used to point somewhere, and where they point now
/v1/gates.json — the last autogate run, written by `pnpm gates` rather than by the build
/v1/hubs.json — the targets, capabilities and topics that cross the five-record threshold
/v1/moderation.json — the review queue's policy, and what is waiting in it
/v1/search-index.json — every record's search text and the synonyms that reach it
/v1/status.json — what this catalog measures about itself, computed at build time
/v1/verifiers.json — the verifiers a T3 attestation may be signed by

## Per record

Export: /r/{publisher}/{slug}/export/{graph.svg,record.json,skill.md,workflow.yaml}
The same record as an Agent Skill, as a workflow, as catalog JSON and as its graph.
No registration, and the same bytes the record page offers.

Source: /r/{publisher}/{slug}/source.md
The document as its author wrote it, which is what content_hash was computed
over. The export above is the record as served and carries two fields the
catalog assigns; this is the document they were assigned to, so the hash can be
recomputed from what you are given.

## Vocabularies

/spec/v1/vocabularies/capability-classes.json — what a capability is asked for, one class per kind of access
/spec/v1/vocabularies/domains.json — the domains a record may be filed under
/spec/v1/vocabularies/targets.json — the systems a record may say it is about

## Schemas

Indexed at /spec/v1/schema.json, and served one file per profile:
/spec/v1/schema/attestation.json
/spec/v1/schema/p0.json
/spec/v1/schema/p1.json
/spec/v1/schema/record.json
/spec/v1/schema/run-report-envelope.json
/spec/v1/schema/run-report.json