# naming

> Checks every identifier, file, and folder for banned words, case, length, and word count.

Checks every identifier, file, and folder for banned words, case, length, and word count.

## Checks

| Check                                                             | Stage    | Level | What it does                                                                                        |
| ----------------------------------------------------------------- | -------- | ----- | --------------------------------------------------------------------------------------------------- |
| [`naming/identifiers`](/reference/checks/naming/identifiers/)     | `commit` | `all` | Checks every identifier against the naming settings: banned words, case, length, and word count.    |
| [`naming/paths`](/reference/checks/naming/paths/)                 | `commit` | `all` | Checks every file stem and folder name against the case rules of its language and the banned words. |
| [`naming/allowed-names`](/reference/checks/naming/allowed-names/) | `commit` | `all` | Reports allowed names that no source file uses.                                                     |

## Settings

| Setting                                                                 | What it sets                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`naming.max_characters`](/reference/gspot-toml/#naming.max_characters) | The most characters one identifier may have.                                                                                                                                                                                                                                                                                                                                |
| [`naming.max_words`](/reference/gspot-toml/#naming.max_words)           | The most words one identifier may have.                                                                                                                                                                                                                                                                                                                                     |
| [`naming.cases`](/reference/gspot-toml/#naming.cases)                   | The case patterns that one identifier category accepts: camel, pascal, kebab, snake, upper-snake, pascal-extension (String+Format.swift), or timestamp-snake (20260103120000\_create\_users.sql). Ruff checks the case of Python classes, functions, and parameters, and SwiftLint checks Swift types, variables, parameters, and enum cases; this setting covers the rest. |
| [`naming.banned_words`](/reference/gspot-toml/#naming.banned_words)     | Words this repository bans in identifiers, beyond the shipped groups.                                                                                                                                                                                                                                                                                                       |
| [`naming.override`](/reference/gspot-toml/#namingoverride)              | Naming rules for repository-relative paths, in order; each record has its reason.                                                                                                                                                                                                                                                                                           |

## Selected when

Always selected.

## Rules for coding agents

| Rule file                                              | Installed when |
| ------------------------------------------------------ | -------------- |
| `.gspot/configurations/general/naming/rules/NAMING.md` | Always         |