design/crud-mirror

A get/create/update/delete family over one noun is the fingerprint of an OpenAPI-autogenerated surface: it mirrors your REST API, not your users' intents. Agents work in workflows, not endpoints — consolidate around tasks.

Category
design
Default severity
warn
Weight
4
Max deduction
16

Why this category matters

The interesting half. Whether the surface is shaped around your users' intents or around your REST endpoints.

A rule deducts weight points from its category for each non-info finding, capped at maxDeduction. The composite is the mean of the six category scores — so a single noisy rule can never sink a whole surface on its own. Read the full scoring model.

Other design rules

Back to the full rule catalogue · Browse audited servers