diff --git a/docs/CONVENTIONS.md b/docs/CONVENTIONS.md
index 05c847d..baa3c60 100644
--- a/docs/CONVENTIONS.md
+++ b/docs/CONVENTIONS.md
@@ -18,6 +18,10 @@ Follow the doctrine in `../AyCode.Core/docs/CONVENTIONS.md#framework-first-place
 - **Services:** `Ac{Domain}ServiceBase` for abstract bases. Platform-specific implementations in consuming projects.
 - **ViewModels:** In `AyCode.Blazor.Models/ViewModels/` — suffixed with `ViewModel` or kept as plain model classes.
 
+## XML Documentation
+
+`<summary>` — brief, developer-facing, readable in VS IntelliSense tooltip. NO implementation details, NO wire-format / byte-level / perf specifics — those live in `docs/TOPIC/*.md`. Add `<example>` only when usage is non-obvious; otherwise omit.
+
 ## Component Patterns
 
 - **DevExpress 25.1.3 exclusively** — never mix with other Blazor component libraries.