Doc Bridge — agent routing skill

Use this skill in Cursor, Claude Code, or Codex so agents resolve ownership before editing packages.

When to trigger

• User asks to change code under packages/*, apps/*, or any monorepo module
• Task mentions auth, billing, API, schema, or a package name
• Before creating or moving files in an unfamiliar area of the repo

Required workflow

1. Resolve handoff first — call MCP tool handoff.resolve with the package id, or run:

   ak-docs query ownership <id> --agent

2. Read startHere — open the agent doc path from the handoff
3. Edit only editRoots — do not touch sibling packages
4. Run checks from the handoff before claiming done
5. Bridge to humans — if bridge.humanDoc is missing, tell the user and suggest ak-docs bootstrap agent-docs; if humanDoc is set, link it in your summary

MCP setup (one-time)

ak-docs mcp install --cursor

Or paste into .cursor/mcp.json:

{
  "mcpServers": {
    "ak-docs": {
      "command": "npx",
      "args": ["ak-docs", "mcp"],
      "cwd": "/absolute/path/to/repo"
    }
  }
}

Cursor rule (paste into .cursor/rules/doc-bridge.mdc)

---
description: Resolve doc-bridge handoff before editing packages
globs: packages/**/*
---

Before editing any file under packages/ or apps/:

1. Call MCP `handoff.resolve` for the owning package id
2. Read `startHere` from the handoff
3. Only modify paths under `editRoots`
4. Run every command in `checks` before finishing
5. If humanDoc is missing, surface `ak-docs bootstrap agent-docs` to the user

Quick consult (no LLM)

ak-docs ask "auth is broken in staging"
ak-docs doctor --text