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`.