design/confusable-params
The same concept spelled differently across tools (hotel_id vs hotelId vs id) makes the model carry a per-tool spelling table and produces cross-tool argument bleed. One concept, one name, everywhere.
- Category
- design
- Default severity
- warn
- Weight
- 3
- Max deduction
- 12
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.