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

WORKFLOW.md

@@ -94,6 +94,19 @@ rebar3 ct --suite=api_admins_SUITE
 
 Agent: `~/.cursor/eventhub/compile-back.sh`, `run-api-tests.sh`; см. `~/.cursor/eventhub/OTP-REBAR.md`.
 
+### Экономия токенов (Agent)
+
+| Принцип | Как |
+|---------|-----|
+| Один чат — одна задача | Новый issue → новый чат (§5); после «готово» не продолжать тред |
+| Узкий scope в запросе | «Репо, issue, только X, не Y, done = …» |
+| Меньше tool turns | `.sh` с первого раза; не PS retry; targeted eunit/lint |
+| Subagents редко | Узкий промпт, один репо, без копии всей переписки |
+| Режим | Ask/Plan для обсуждения; Agent для кода и shell |
+| Повторяемое | Скрипты в `~/.cursor/eventhub/`, не заново в чате |
+
+Канон: `EventHubBack/.cursor/rules/agent-pitfalls.mdc` §6.
+
 ### Git-коммиты из WSL (Agent и разработчик)
 
 Коммиты из **Agent Shell / PowerShell** ломаются: Cursor подставляет `--trailer "Co-authored-by: Cursor <cursoragent@cursor.com>"`, а PowerShell падает на `<`.
@@ -364,6 +377,7 @@ error rate > 1% **или** mean request > 500 ms (hold ≥2 мин в фазе)
 - Код фичи — в репозитории-владельце; `EventHubSpec` — для документации и процесса.
 - **Один агент — один репо** (не смешивать Front/Back/Spec/FrontAdmin в одной сессии): `.cursor/rules/one-repo-per-agent.mdc`.
 - **Типовые ошибки агентов** (PS, git clean, docker scale, scope): `EventHubBack/.cursor/rules/agent-pitfalls.mdc`; в промпт субагента включать shell + pitfalls.
+- **Экономия токенов:** один чат — одна задача; узкий scope; subagents редко; Ask vs Agent — см. `agent-pitfalls.mdc` §6 и §2.1 выше.
 - Метки во всех репозиториях держать одинаковыми (`sync-labels.ps1`).
 - Секреты и токены не коммитить; Gitea token — только в env / `~/.cursor/secrets/`.
 - **Git commit/push — через WSL** (`~/.cursor/eventhub/git-commit.sh`, `git-push.sh`); **push — только после подтверждения пользователя** (см. §2.1).
@@ -380,6 +394,7 @@ error rate > 1% **или** mean request > 500 ms (hold ≥2 мин в фазе)
 | Дата | Изменение |
 |------|-----------|
 | 2026-07-27 | Spec sync Back#61: `specialist_id` на POST event; commercial без active sub → 402; trial только `start_trial` |
+| 2026-07-27 | `agent-pitfalls.mdc` §6: экономия токенов (чат, scope, subagents, режимы) |
 | 2026-07-27 | `agent-pitfalls.mdc`: типовые сбои PS/git/docker/scope; промпт субагентам |
 | 2026-07-27 | Spec sync: booking `expired` (Back#60) + Front#31 UX (desktop chrome, empty bookings, agenda copy, Discover covers, nickname, invites badge) |
 | 2026-07-27 | Spec#12: booking-requests + Bookings IA + image_url; правило one-repo-per-agent |