docs: agent pitfalls + token economy rules for Cursor [skip ci]

.cursor/rules/agent-pitfalls.mdc

@@ -0,0 +1,28 @@
+---
+description: Типичные ошибки агентов EventHub — shell, git, docker, scope, токены
+alwaysApply: true
+---
+
+# EventHub: типичные ошибки агентов (избегать)
+
+Полный текст: `EventHubBack/.cursor/rules/agent-pitfalls.mdc`. Кратко:
+
+## Shell
+PS ломает кавычки/`$`/`&&` → **`.sh` + `wsl -e bash /mnt/c/.../script.sh`**. Не Windows `npm`/`rebar3`.
+
+## Git
+Commit: **`git commit -F .tmp-msg.txt`** или `~/.cursor/eventhub/git-commit.sh`.  
+**`git clean -fdx`** — не без backup; **не удалять** `.cursor/`, `.idea/`.  
+Push `master` — только по просьбе пользователя.
+
+## Docker dev
+**Балансировка = traefik (1) + eventhub (1)**, не 3 реплики.  
+Host-порты 8080/8445 → scale eventhub >1 невозможен.  
+«Только бэк» — без сборки admin-ui/front.
+
+## Субагенты
+Промпт: shell через WSL, один репо, итог на русском, см. `agent-pitfalls.mdc`.
+
+## Токены
+Один чат = одна задача; `@` точечно; subagents редко и узко; Ask для вопросов, Agent для правок.  
+Полный §6: `EventHubBack/.cursor/rules/agent-pitfalls.mdc`.

.cursor/rules/agents-russian.mdc

@@ -0,0 +1,27 @@
+---
+description: Ответы субагентов и итоги работы — на русском
+alwaysApply: true
+---
+
+# EventHub: язык ответов агентов
+
+## Правило
+Все **вызванные / фоновые агенты** (Task subagents) пишут пользователю и parent-агенту **на русском**:
+- итоги, вердикты, чеклисты, UX-оценки;
+- комментарии в Gitea (как и раньше — только русский);
+- краткие status-апдейты в конце задачи.
+
+## Допустимо на английском
+- Идентификаторы кода, API paths, commit subject если в репо уже принят EN-стиль сообщений (можно и RU — главное единообразие в рамках задачи);
+- цитаты из логов CI / stack traces без перевода;
+- имена файлов, SHA, URL.
+
+## Родитель-координатор
+Тоже отвечает пользователю по-русски.
+
+## Промпт субагенту (обязательно)
+- «Return summary in Russian»
+- «Shell: WSL + `.sh` only — `shell-wsl-not-powershell.mdc`, `agent-pitfalls.mdc`»
+- «One repo per agent — `one-repo-per-agent.mdc`»
+- «Экономия токенов: §6 agent-pitfalls — узкий scope, без лишних subagents/explore»
+- Не push / не `git clean -fdx` без явного OK пользователя