<!--
title: Maintain semantic naming consistency
domain: ai-agents
topic: Naming Conventions
language: TypeScript
source: n8n-io/n8n
updated: 2025-07-08
url: https://awesomereviewers.com/reviewers/n8n-maintain-semantic-naming-consistency/
-->

Names should be semantically meaningful and consistent across related concepts in the codebase. This applies to variables, functions, components, and types. When naming:

1. Use consistent suffixes/prefixes for related concepts
2. Choose descriptive verbs for functions
3. Avoid abbreviations unless widely understood
4. Maintain naming patterns across similar features

Example of poor naming consistency:
```typescript
// Inconsistent naming pattern
interface User {
  customer_id: string;  // Uses _id suffix
  group: string;        // Missing _id suffix
}

function enableStreaminOption() {}  // Misspelled, unclear verb
```

Improved version:
```typescript
// Consistent naming pattern
interface User {
  customerId: string;   // Consistent camelCase
  groupId: string;      // Consistent naming pattern
}

function createStreamingOption() {}  // Clear verb, correct spelling
```

This helps maintain code readability and reduces cognitive load when working across different parts of the codebase.
