Cursor rule

1---
2name: meaningful-identifiers
3description: Naming guidance for callback parameters and local variables in TypeScript. Use when writing or refactoring loops, array callbacks (map/filter/find/reduce), or local accumulators.
4license: AGPL-3.0
5metadata:
6  triggers:
7    type: domain
8    enforcement: suggest
9    priority: low
10    keywords:
11      - naming
12      - rename
13      - identifier
14      - variable name
15---
16 
17# Meaningful identifiers
18 
19Callback parameters and local variables must describe the value they hold.
20 
21## Rules
22 
23- Name array callback params after the element's domain type:
24  `batches.map((batch) => …)`, `bins.filter((bin) => …)`,
25  `checkpoints.find((checkpoint) => …)`. Never reuse `right`/`left`/`column`
26  for values that are not sort operands or table columns.
27- Name `reduce` accumulators after what they accumulate: `sum`/`total` for a
28  running total, not `step`.
29- Name percentile/ratio arguments for the quantity they represent
30  (`percentileRank`, `multiplier`), not an unrelated domain noun.
31 
32## Leave correct uses untouched
33 
34- Sort comparators: `(left, right) => left - right`.
35- `(column) => column.key` over a real `.columns` array.
36- `for (const row of …Rows)` where the items are genuinely rows.
37