Review a WAD

§ 1Purpose

Get a human architecture review of the rendered book, and record the reviewed revision that anchors the change workflow.

§ 2Prerequisites

• The WAD checks and renders
• A reviewer

§ 3Flowchart

§ 4Steps

wcl wdoc serve wdoc/book/main.wcl --comment — the reviewer clicks any block to leave a note (notes land in a comments.wcl sidecar, no rebuild). An agent waiting on the review blocks with wcl wdoc review <entry> until the reviewer hits “Send to agent”. Mechanics are the wdoc wskill's — this process only adds the WAD-specific step below.

Every comment resolves as a data edit (or a kinds/extension edit) — never a page edit. wcl wdoc comments <entry> resolve <id> as each lands; loop until clean.

Commit, and record the revision — a tag (wad-reviewed-2026-07) or the sha noted in the WAD's README. This is the --from baseline every future wcl wad spec diffs against; a review that doesn't pin a revision anchors nothing.