# Bugbot review rules

## OpenAPI documentation quality

When a PR adds or changes operations/paths, parameters, or schema properties in `openapi.yaml`,
check that:

- each new or changed operation has a `summary`, a `description`, and at least one response `example`
- each new schema property has a `description`


Flag any additions that are missing these, listing the specific paths or fields.