docs-audiencelisted

# docs-audience — Audience Targeting Analysis ## Workflow 1. **Connect to Docsbook** — run `list_workspaces` to find the workspace, then `get_doc_graph` to get all pages. Reindex if graph is empty or stale. 2. **Identify stated audience** — before flagging vocabulary issues, read each page's stated prerequisites, "who this is for" sections, and content type signals. 3. **Apply checklist** — check audience declaration, vocabulary and jargon, beginner-page conventions, expert-page conventions, and mixed-audience red flags. 4. **Produce report** — return one JSON issue object per finding, sorted by severity. Group issues by page. ## Guardrails - Do not edit any documentation files — surface findings only. - Flag jargon only when it is undefined *and* the stated prerequisites do not cover it. Precise technical terms are not a problem if the audience is declared correctly. - A single page may legitimately serve both beginner and expert sections if they are clearly separated with headers — flag as mixed-audience only when no separation exists. - Ask the user to confirm the primary audience and assumed knowledge level before deep-diving. ## MCP Tools | Tool | Purpose | |------|---------| | `mcp__docsbook__list_workspaces` | Find workspace | | `mcp__docsbook__get_doc_graph` | Page list and structure | | `mcp__docsbook__read_doc_sections` | Read content for vocabulary analysis | | `mcp__docsbook__reindex_doc_graph` | Refresh graph if empty or stale | ## Checklist ### Audience