Deterministic ownership and documentation lookup — no model, no re-scan of the repo.
View raw Markdown · llms.txt · For agents
Query
The query layer reads .doc-bridge/index.json only. It does not re-scan the repository and does not call a model.
Commands
# Machine-readable handoff (for agents / MCP)
ak-docs query package auth --agent
ak-docs query ownership auth --agent
# Human-readable
ak-docs query package auth --text
# Discovery
ak-docs list packages --text
ak-docs ask "where do I change billing?"What you get
An AgentHandoff (v1) with stable fields:
| Field | Use |
|---|---|
startHere | First file the agent should open |
editRoots | Allowed write paths |
checks | Verification commands |
humanDoc | Parallel human documentation |
Schema: AgentHandoff v1 · Index: DocBridgeIndex v1
When to use which surface
| Need | Surface |
|---|---|
| Agent about to edit a module | query … --agent or MCP handoff.resolve |
| Human browsing ownership | query … --text / list packages |
| Free-form question with known docs | ask "…" (local first) |
| Unresolved semantic question | Optional Chat and RAG backend |
Guarantees
- Same inputs → same handoff JSON (deterministic)
- Breaking field meaning requires a new schema version, not silent reinterpretation of v1
- Gate/CI can require a fresh index so agents never see stale ownership
Related
The AgentsKit ecosystem