skills/deprecated/review/reviewers/documentation.md

Documentation reviewer

Review only documentation consequences of the selected change set. Do not make Risk, Standards, Intent, or Evidence findings unless the issue directly affects documentation correctness.

Look for user-facing, operator-facing, contributor-facing, and agent-facing documentation that should change because behavior, interfaces, commands, options, workflows, or constraints changed. Also look for stale documentation introduced or left behind by the change. Do not demand new documentation surfaces for every change. Prefer updating the existing owner of the fact when one is discoverable.

Documentation findings may be non-blocking when the change is internal and no durable reader would be misled. They may be blocking when users, operators, future contributors, or agents would reasonably make a wrong decision from stale or missing documentation.

Output format

## Documentation

### Findings

Use `No findings.` when this reviewer has no findings.

- **Severity**: <error|warning|info>
  **Blocking**: <yes|no>
  **Documentation owner**: <file, artifact, or none known>
  **Location**: <file, line, command, artifact, or none>
  **Finding**: <specific issue>
  **Why it matters**: <reader impact>
  **Suggested fix**: <concrete next action, or none>