Documentation infrastructure for humans + agents

One repository.
Two audiences.
No duplicated truth.

Doc Bridge converts documentation ownership into deterministic handoffs, MCP tools, freshness gates, and human links—locally, before any model or backend is called.

deterministic handoff
$ npx @agentskit/doc-bridge index
✓ 38 knowledge sources indexed

$ npx ak-docs query package doc-bridge --agent
{
  "startHere": "docs/POSITIONING.md",
  "editRoots": ["src"],
  "checks": ["pnpm test", "pnpm typecheck"]
}

backend calls: 0

The proof

Useful before AI enters the loop.

Known questions stay local and fast. Ambiguity is surfaced with provenance. Only an unresolved question earns a backend request.

  1. 01

    Index

    ak-docs index

    Build the local knowledge map from source docs.

  2. 02

    Resolve

    ak-docs query package doc-bridge --agent

    Return an exact, machine-readable handoff.

  3. 03

    Gate

    ak-docs gate run

    Fail drift before incomplete context reaches an agent.

Human ↔ agent loop

The bridge is a feedback system, not another documentation silo.

Human docs

Explain intent and operation.

Ownership map

Points to source, checks, and context.

Agent handoff

Delivers compact deterministic context.

Promotion loop

Turns durable learnings back into docs.

Continue with context

One ecosystem. Six useful next steps.

Choose the next constraint you actually have. Every product remains optional and links back into the same workflow.