<!--
title: Prefer specific identifiers
domain: ai-agents
topic: Naming Conventions
language: TypeScript
source: openai/codex
updated: 2025-04-24
url: https://awesomereviewers.com/reviewers/codex-prefer-specific-identifiers/
-->

Always use specific, descriptive names for identifiers rather than generic terms. Names should clearly indicate their purpose and context, making code more readable and self-documenting. This applies to variables, parameters, types, and files.

Examples:
- Use `mcpServers` instead of `servers` to include context
- Prefer `storeResponses` over `store` to clarify the parameter's purpose
- Name types specifically like `UpdateState` instead of generic `State`
- Use file names that reflect content purpose (e.g., `update-state.json`, `.codex.env`)

This practice reduces cognitive load for other developers, improves maintainability, and helps prevent confusion or misuse of code elements. The additional verbosity is well worth the clarity it provides.
