agent-workflows

Reviews the words of a human-read document — the README, the prose in docs/, or any text written for a person rather than an agent — for whether the phrasing fits its reader: leads with the point, stays brief, carries the right tone, and says the true complete thing and only that. The words half of the human-read doc review (reviewing-typography handles the look). Use when such a doc is written or updated and is about to reach a reader. Judgment over checklist; floor, not ceiling.

Reviews how a human-read document looks — the README, the prose and tables in docs/, or any human-read document — for visual hierarchy, Gestalt proximity, restraint, and walls of text, so a reader can find the point at a glance. The look half of the human-read doc review (reviewing-phrasing handles the words). Use when such a doc is written or restructured. Judgment over checklist; floor, not ceiling.

Reviews any workflow artifact — the commands, skills, and project docs that are the tooling (READMEs, stories, CLAUDE.md, and the like) — against a few goal questions: one clear job, complete, a goal not a frozen spec, fits the project, right for its reader, and (for producers) paired with a review. Its pairing question flags any producer shipped without a paired review. It judges whether an artifact does its job; how a human-read doc (the README, docs/ prose) looks and reads goes to the typography + phrasing review. Floor, not ceiling.