diff --git a/AGENTS.md b/AGENTS.md index 4824e6216be4..d24104b1435c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -136,6 +136,7 @@ All code must adhere to the repository's style guides. The `format` command hand - **Kotlin**: Android Kotlin style, formatted with `ktfmt`. - **Objective-C**: Google style, formatted with `clang-format`. - **Swift**: Google style, formatted with `swift-format`. +- **Comments**: Avoid adding redundant or trivial comments that simply restate what the code itself does (e.g., repeating method calls in English). Comments should explain the *why* behind complex or non-obvious logic, or serve as public API documentation. ## Version and CHANGELOG updates