<!--
title: Ensure semantic naming clarity
domain: ai-agents
topic: Naming Conventions
language: Rust
source: smallcloudai/refact
updated: 2025-05-22
url: https://awesomereviewers.com/reviewers/refact-ensure-semantic-naming-clarity/
-->

Names should clearly communicate their actual behavior and preserve sufficient context for meaningful identification. For functions with conditional behavior, use descriptive suffixes like `_if_needed` or `_maybe` to indicate optionality. For paths and identifiers, maintain enough context to ensure usability - avoid over-shortening that removes essential information.

Examples:
- Instead of `wait_for_indexing()` for conditional waiting, use `wait_for_indexing_if_needed()`
- Instead of shortening `/home/user/work/dir1/file.ext` to just `file.ext`, preserve context as `dir1/file.ext`

This ensures that names serve as clear documentation of intent and maintain practical usability for developers and tools.
