Practical Doc Bridge paths for humans, agents, PR gates, and MCP — one repository, two audiences.

Documentation

Doc Bridge keeps one repository useful to people and coding agents. Pick the shortest path:

Start

Goal	Page
Install + 60s proof	Getting started
Guided install	Install and run
Machine-first entry	For agents · site route `/for-agents`
PR freshness gate	Gate and CI · Marketplace

Build workflows

Goal	Page
Index + resolve ownership	Index and query · Query
MCP for Cursor / Claude	MCP for agents · MCP
Memory digest → draft docs	Memory pipeline
Every CLI command	CLI map · CLI reference
Config sketches	Examples
Optional chat / RAG	Chat and RAG · Ollama demo
Study and measurement	Study overview and anonymized data · Study protocol v1
Controlled task suite	Study task suite v1
Controlled study runner	Study runner v1
Provider CLI adapter	Study provider CLI v1
Round 1 instrumentation	Instrumentation plan v1 · adjudicated smoke ledger
Longitudinal measurements	Study metrics v1
Study verification	Study verification v1
A/B baseline result	A/B baseline result 2026-08-31 · analysis
Documentation quality audit	Documentation audit v1
Current documentation audit snapshot	Audit round 2026-08-31
Controlled pilot evidence	Pilot round 2026-08-31

How it works

Repository docs
      │
      ▼
ak-docs index  ──►  .doc-bridge/index.json + llms.txt
      │
      ├─► Human guides (Fumadocs / Docusaurus / md)
      ├─► Agent handoff (CLI / MCP)
      └─► PR gate (Marketplace Action)

Index — map ownership from corpus + config
Resolve — deterministic handoffs (startHere, editRoots, checks)
Gate — fail stale context before agents run
Promote — optional memory → draft docs loop

Product vs reference

Start / Guides — get value in minutes
Product — Positioning, Playbook pattern, Recipes
Reference — CLI, Config, Schemas

Machine surfaces: llms.txt · llms-full.txt · raw Markdown

Ecosystem

Part of AgentsKit — next to AgentsKit, Registry, Chat, and Playbook.