Документировать WSL и git-коммиты через терминал WSL

WORKFLOW.md

@@ -50,13 +50,40 @@
 
 | Репозиторий | Минимум |
 |-------------|---------|
-| EventHubBack | `make test` / `make eunit` / целевые API-тесты |
+| EventHubBack | `make test` / `make eunit` / целевые API-тесты (см. §2.1 WSL) |
 | EventHubFrontAdmin | `npm run lint`, `npm run build` |
 | EventHubSpec | ревью текста, ссылки на код |
 
 ---
 
-## 3. Спецификация (после успешных тестов)
+## 2.1. Локальная разработка (WSL)
+
+Окружение: **WSL + asdf** (Erlang/OTP 28, rebar3). PowerShell/Windows — только IDE; сборка и тесты — в WSL.
+
+```bash
+cd /mnt/c/Users/alexc/IdeaProjects/eventHub/EventHubBack
+bash scripts/wsl-ext4-dirs.sh          # один раз: logs/data на ext4
+bash scripts/fix-rebar-unit-symlink.sh # перед CT, если rebar сломал unit/api
+rebar3 as test eunit
+rebar3 ct --suite=api_admins_SUITE
+```
+
+### Git-коммиты — только из WSL-терминала
+
+Коммиты из **Agent Shell / PowerShell** ломаются: Cursor подставляет `--trailer "Co-authored-by: Cursor <cursoragent@cursor.com>"`, а PowerShell падает на `<`.
+
+**Правило:** `git add` / `git commit` / `git push` — в WSL (`bash -lic` или встроенный терминал WSL), не через Agent.
+
+```bash
+cd /mnt/c/Users/alexc/IdeaProjects/eventHub/EventHubBack   # или EventHubSpec
+git status
+git add <files>
+git commit -m "сообщение. Refs EventHub/EventHubBack#N"
+```
+
+Attribution в Cursor (Settings → Agent → Attribution) можно выключить, но WSL-терминал надёжнее.
+
+---
 
 Если изменение затрагивает **поведение, API, модель данных или роли**:
 
@@ -97,6 +124,7 @@
 - Код фичи — в репозитории-владельце; `EventHubSpec` — для документации и процесса.
 - Метки во всех репозиториях держать одинаковыми (`sync-labels.ps1`).
 - Секреты и токены не коммитить; Gitea token — только в env / `~/.cursor/secrets/`.
+- **Git commit/push — из WSL-терминала**, не из Agent Shell (см. §2.1).
 
 ---
 
@@ -104,5 +132,6 @@
 
 | Дата | Изменение |
 |------|-----------|
+| 2026-07-07 | §2.1: WSL-окружение, git-коммиты только из WSL-терминала |
 | 2026-07-07 | Правило: варианты решения и утверждение перед реализацией |
 | 2026-07-07 | Первая версия: Gitea workflow, gate тестирования, sync спеки |