docs(claude): formalize Auto-review passed as approval signal (#85)

* docs(claude): formalize "Auto-review passed" as approval signal + polling loop

Per user feedback after PR #84 merge:
- Critical rule 5: "Auto-review passed" / "LGTM" от auto-review bot = approval
  (наряду с явным "merge it" / "approved" от human user)
- Add "Polling loop для PR" section: 60s ScheduleWakeup pattern,
  decisive states (merged / approved / changes / no-news), cap 30 iters

This formalizes what main session already did: after fixup commit, poll
comments, detect auto-review verdict, and auto-merge if passed.

* fix(claude): address PR #85 auto-review feedback

- Fix cyrillic/latin typo (rule 5 second sub-bullet)
- Add SHA marker validation to polling loop (race condition on stale LGTM after fixup-push)
- Add explicit "Auto-merge scope" rule 6 — allowlist (docs/UI/.claude) vs blocklist (migrations/API/infra/secrets)
- Sync "Когда auto-mode" section with new merge approval signals
- Lower cap to 5 iters for scope-blocked PRs (human required anyway)
- Self-modifying CLAUDE.md rules → always require human

Per auto-review on e66e1ea.

---------

Co-authored-by: lekss361 <claudestars@proton.me>

CLAUDE.md

@@ -222,8 +222,39 @@ User approves / requests changes
 2. **Worker-agents (backend/frontend/devops/database) НЕ делают `git commit` сами.** Они оставляют изменения staged — main session коммитит на feature branch.
 3. **Никогда не используй `--no-verify` / `--no-edit` / `--amend`** — pre-commit hooks обязательны. Если hook падает — fix root cause, не bypass.
 4. **Никогда не пуш с `--force` ни в main ни в feature branch без approval.**
-5. **Не merge PR без явного "merge it" / "ok merge" / "approved" от пользователя.**
-6. **Не вызывай destructive команды без явного approval**: `git reset --hard`, `git clean -fdx`, `DROP TABLE`, `TRUNCATE`, `rm -rf` за пределами `node_modules/.next`.
+5. **Merge PR только по approval.** Approval сигналы:
+   - **Human user всегда валиден:** "merge it" / "ok merge" / "approved" / "залей" / "мердж"
+   - **Auto-review bot LGTM = approval, НО с ограничениями** (см. "Auto-merge scope" ниже). Bot LGTM валиден **только** если SHA marker в теле комментария совпадает с current PR HEAD SHA — иначе это устаревший approval до fixup-push.
+6. **Auto-merge scope (где боту разрешено self-merge без человека):**
+   - ✅ **Разрешено** (PR diff целиком в этих путях):
+     - `CLAUDE.md`, `README.md`, `docs/**` (документация / правила)
+     - `frontend/src/app/**` UI-only changes без новых API endpoints
+     - `frontend/public/**` (статика)
+     - `.claude/agents/**`, `memory/feedback_*.md` (workflow rules)
+   - ❌ **Запрещено — нужен human approval** (любой файл из списка → block auto-merge):
+     - `data/sql/**`, `backend/alembic/versions/**` (миграции / схема DB)
+     - `backend/app/api/v1/**`, `backend/app/services/**` (бизнес-логика API)
+     - `backend/app/scrapers/**` (внешние интеграции)
+     - `docker-compose*.yml`, `Caddyfile`, `.github/workflows/**` (deploy / infra)
+     - Любые файлы с упоминанием secret / token / password / credential / X-Admin-Token
+     - PRs которые меняют `CLAUDE.md` рядом с `Critical workflow rules` / `Auto-merge scope` / auth — это саморасширение правил, **нужен human**
+   - Если PR touches both — берётся more restrictive (block).
+7. **Не вызывай destructive команды без явного approval**: `git reset --hard`, `git clean -fdx`, `DROP TABLE`, `TRUNCATE`, `rm -rf` за пределами `node_modules/.next`.
+
+### Polling loop для PR
+
+После создания PR / fixup commits — запускай ScheduleWakeup с 60с интервалом:
+1. `gh pr view <N> --json state,mergeable,comments,headRefOid` → возьми `headRefOid` (current SHA) и latest_comment.
+2. `state == MERGED` → stop polling.
+3. **Approval check** (новый comment от auto-review):
+   - Распарси HTML marker: `<!-- gendesign-review-bot: sha=<sha7> verdict=<approve|changes> -->`
+   - **SHA guard:** `marker.sha7 == headRefOid[:7]` — иначе это устаревший approval до fixup-push, игнорируй.
+   - **Scope guard:** проверь `gh pr view <N> --json files` — если хоть один путь попадает в "запрещённый" список (см. rule 6 "Auto-merge scope") → block auto-merge, ping user.
+   - `verdict=approve` + SHA match + scope OK → `gh pr merge <N> --squash --delete-branch`, stop.
+   - Если в комменте только текст "Auto-review passed" / "LGTM" без HTML marker — НЕ доверяй (legacy / поддельный сигнал), ping user.
+4. `verdict=changes` → fixup commits на той же ветке, push, reply, re-poll.
+5. Нет новых комментов с last polled timestamp → re-schedule 60с poll.
+6. **Cap:** 30 итераций без resolution → stop, ask user. Для PR со scope-запрещёнными файлами cap = 5 итераций (не имеет смысла долго ждать, всё равно нужен human).
 
 ### Когда auto-mode
 
@@ -233,7 +264,8 @@ User approves / requests changes
 - `git push -u origin <feature-branch>`
 - `gh pr create`
 - Прогонять code-reviewer
-- **НО — финальный `gh pr merge` только по явному approval от пользователя.**
+- **Auto-merge** через `gh pr merge --squash` — только если PR в "Auto-merge scope ✅" (см. rule 6) И auto-review bot вернул `verdict=approve` с валидным SHA marker.
+- **Финальный merge для PR из scope ❌** (миграции / API / infra / secrets) — только по явному approval от пользователя ("merge it" / "залей" / etc).
 
 ## Pre-commit hooks