<!--
title: Use descriptive names
domain: ai-agents
topic: Naming Conventions
language: TypeScript
source: cloudflare/agents
updated: 2025-08-18
url: https://awesomereviewers.com/reviewers/agents-use-descriptive-names/
-->

Choose clear, descriptive names for variables, methods, types, and parameters that unambiguously convey their purpose and avoid conflicts. Prefer full words over abbreviations and ensure names are specific enough to prevent clashes with inherited or similar functionality.

Examples of improvements:
- Use `options` instead of `opts` for better clarity
- Use `TransportType` instead of `Protocol` when the term "protocol" is overloaded in the domain
- Use `onMcpError` instead of `onError` to avoid conflicts with base class methods

This practice reduces cognitive load, prevents naming conflicts during inheritance or composition, and makes code more maintainable by clearly expressing intent through naming.
