/code-polish

Naming Profile

Load last, after correctness and security checks; optional — skip with --skip-profile naming.

Checks

• NM-001 Generic function names (MEDIUM): names like process/handle hide intent.
• NM-002 Misleading identifiers (MEDIUM): name contradicts actual data shape or behavior.
• NM-003 Boolean ambiguity (LOW): a boolean name conceals the condition it represents.
• NM-004 File/export mismatch (LOW): filename and exported symbol diverge from project conventions.
• NM-005 Constant intent loss (LOW): magic values or value-based constant names.
• NM-006 Misleading filename (LOW): file's actual responsibility diverges from what its name implies (e.g., utils.ts that only formats dates → date-format.ts). Suggest a rename with rationale; flag as MEDIUM when the mismatch is likely to cause incorrect usage or placement of new code.

Guardrail

Only raise naming findings when they materially reduce maintainability in the touched code.