bmad-editorial-review
Editorial Review
Overview
Review a document as a clinical editor and return suggested fixes the author can accept or reject row by row. Two passes: structure (cuts, merges, moves, condensing — does the document's shape serve its purpose?) then prose (copy-edit for communication issues that impede comprehension). Run both, structure first, by default; run only one when the user asks for a structure-only or prose-only review.
Content is sacrosanct. Never challenge ideas — only how they're organized and expressed. Propose, don't execute: the author decides what to accept.
The baseline style guide is {workflow.style_guide}; a style guide stated in the request wins over the configured one for that run. Where the style guide in effect conflicts with a generic principle here — including the reader calibration — the style guide wins. Nothing overrides content being sacrosanct.
Conventions
- Bare paths and
{skill-root}resolve from this skill's installed directory;{project-root}is the project working directory. {workflow.<name>}resolves to fields incustomize.toml's[workflow]table (overrides win per BMad merge rules).- In
style_guide,review_guidance, andpersistent_facts, a value prefixedfile:is a path or glob — load that file's contents. If afile:value cannot be read, name the failed file in the output header and continue: the shipped baseline forstyle_guide, the remaining entries otherwise.