From b4275766290bfd2fd4efde8e32f3d7af4566111c Mon Sep 17 00:00:00 2001
From: dbastrikin <dbastrikin@adapty.io>
Date: Sun, 15 Mar 2026 18:58:00 +0200
Subject: [PATCH] Update CLAUDE.md.

---
 CLAUDE.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 2b76010..2633f8a 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -50,3 +50,32 @@ LEFT JOIN cuisine_translations ct ON ct.cuisine_slug = c.slug AND ct.lang = $lan
 
 When adding a new entity with text fields, always create a `{table}_translations`
 companion table and use LEFT JOIN COALESCE in all read queries.
+
+## Naming
+
+**No abbreviated variable names.** Variables must use full descriptive names.
+Single- or two-letter names are only allowed when the abbreviation *is* the full description
+(e.g., a loop index `i`, a matrix coordinate `x`).
+
+### Examples
+
+| Avoid | Use instead |
+|-------|-------------|
+| `err` | `parseError`, `writeError`, `dbError`, `validationError` |
+| `ctx` | `requestContext`, `handlerContext`, `queryContext` |
+| `s`   | `service`, `server` |
+| `r`   | `request`, `repository` |
+| `w`   | `writer`, `responseWriter` |
+| `h`   | `handler` |
+| `req` | `request` |
+| `res` | `response`, `result` |
+| `msg` | `message` |
+| `cfg` | `config` |
+| `db`  | `database` |
+| `tx`  | `transaction` |
+| `buf` | `buffer` |
+| `tmp` | `temp`, or a descriptive name |
+
+This rule applies to all languages in this repo (Go and Dart).
+In Go, name variables to avoid shadowing the `error` built-in and the `context` package —
+use descriptive prefixes: `parseError`, `requestContext`, etc.