critique-docs

# critique-docs Reviews a markdown documentation page or page tree against the Diataxis framework: whether each page keeps to the mode it commits to (tutorial, how-to, reference, or explanation), whether the tree's heading structure, page linking, and navigation listings hold together the way a Diataxis tree assumes. **Artifact claim (v0.1, narrow):** markdown documentation pages and page trees only. This skill does not critique a live rendered documentation site's behavior, non-markdown source formats, or the technical correctness of code samples inside a page; it critiques the page and tree structure and the mode each page keeps to, exactly as `references/DIATAXIS.md`'s nine criteria define. ## Contract Every finding this skill emits conforms to `contract/critique-contract.schema.json`. See `docs/reference/critique-contract.md` for the field contracts a schema cannot check on its own: location navigable unaided, evidence quoted or measured rather than characterized, violation naming the breach, fix actionable and specific. ## Protocol Follow these four passes in order. Do not skip ahead to severity or fixes while still sweeping. 1. **Inventory.** Map the artifact's structure: every page in the tree (or the single page, if that is the artifact), each page's declared or apparent Diataxis mode, its heading sequence, its outbound links, and any navigation or index listings it carries. No judgments yet, no findings yet. This pass exists so the sweep in step 2 does...