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

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, Playbook, and AKOS.