<!--
title: Maintain consistent naming
domain: ai-agents
topic: Naming Conventions
language: Markdown
source: google-gemini/gemini-cli
updated: 2025-07-28
url: https://awesomereviewers.com/reviewers/gemini-cli-maintain-consistent-naming/
-->

Ensure naming consistency across all contexts where an identifier appears - configuration files, code enums, documentation, and user interfaces. Names should be semantically clear and distinguish between related but different entities.

When the same concept appears in multiple places, use identical naming:
- Configuration keys should match their corresponding code constants
- Documentation examples should reflect actual implementation names
- User-facing strings should align with internal representations

Prefer simple, unambiguous names that avoid unnecessary complexity:

```json
// Good: Consistent across config and code
"selectedAuthType": "oauth" // matches AuthType.OAUTH in code

// Bad: Inconsistent naming
"selectedAuthType": "oauth-personal" // while code uses AuthType.LOGIN_WITH_GOOGLE
```

For related but distinct entities, use clear semantic distinctions:
- "Claude" (the LLM) vs "Claude Code" (the application)
- "gemini" (API service) vs "gemini-api" (authentication method)

When naming conflicts arise, implement graceful resolution strategies that preserve the original simple names for the most common cases while providing clear alternatives for conflicts.
