gendesign/.claude/rules/git-pr.md

paths
.claude/** .github/** .forgejo/**

Git + PR workflow

Этот файл — manual reference из CLAUDE.md (auto-loaded для .claude/** и .github/** файлов). Если работаешь с code в backend/frontend — также явно открой этот файл при PR-related операциях.

Branch + PR (MANDATORY)

1. git fetch forgejo && git checkout -b feat/<scope> forgejo/main   # или fix/ refactor/ docs/ chore/ perf/
2. [worker делает код, staged]
3. code-reviewer subagent на staged changes (pre-push)
4. main session: git commit -m "feat(scope): ..."
5. git push -u forgejo feat/<scope>
6. mcp__forgejo__create_pull_request (или curl POST $REPO/pulls)
7. Вернуть PR URL пользователю (https://git.gendsgn.ru/lekss361/gendesign/pulls/<N>)
8. СРАЗУ Skill loop polling (см. Polling loop)

Никаких direct push в main. Только через PR merge через Forgejo. gh CLI bypassed (2026-05-16) — все PR-операции через mcp__forgejo__* или curl + $FORGEJO_TOKEN.

Commit messages

• Conventional: feat(scope): ... / fix(scope): ... / refactor/docs/chore/perf
• Imperative: "fix crash" не "fixed crash"
• Body — почему, не что (что видно в diff)
• NO Co-Authored-By: Claude ... — никогда (~/.claude/CLAUDE.md rule)
• Workers оставляют staged — main session коммитит
• No auto-commit: написать commit message в чат, user решает когда коммитить

PR body template

## Summary
- bullet

## Test plan
- [ ] smoke test

Closes #N

Всегда Closes #N если есть issue. Комментарий на issue при PR create: "Working on this in PR #M".

Polling loop

После mcp__forgejo__create_pull_request — СРАЗУ Skill loop (self-paced, 90-120s) или background Bash poll:

1. mcp__forgejo__get_pull_request (или curl -sH "$H" "$REPO/pulls/<N>") → читай state, mergeable, head.sha
2. state == merged → stop polling
3. Новый review/comment: mcp__forgejo__list_pr_reviews / list_issue_comments. Парсь marker <!-- gendesign-review-bot: sha=<sha7> verdict=<approve|changes> -->
   • SHA guard: marker.sha7 == head.sha[:7] — иначе устаревший approval до fixup-push, игнорируй
   • Scope guard (см. ниже): если blocked paths → ping user, не auto-merge
   • verdict=approve + SHA match + scope OK → mcp__forgejo__merge_pull_request (squash + delete branch)
   • verdict=changes → fixup commits + push в forgejo feat/<scope> + re-poll
4. Нет новых comments → re-schedule 60s
5. Cap: 30 iter без resolution → stop, ping user. Blocked-scope cap = 5.

Auto-merge scope

✅ Разрешено (PR diff целиком в этих путях — bot merge без human):

• CLAUDE.md, README.md, docs/**
• frontend/src/app/** UI-only без новых endpoints
• frontend/public/**
• .claude/agents/**, .claude/rules/**, memory/feedback_*.md

❌ Блокировано (любой файл из списка → human approval):

• data/sql/**, backend/alembic/versions/**
• backend/app/api/v1/**, backend/app/services/**, backend/app/scrapers/**
• docker-compose*.yml, Caddyfile, .github/workflows/**
• Любой файл с упоминанием secret / token / password / credential
• PR меняет Critical workflow rules или Auto-merge scope в CLAUDE.md
• PR меняет Auto-merge scope / blocked-list в любом .claude/rules/*.md (self-extending rules → нужен human)

Touches both → more restrictive (block).

Sequential PRs

Одна задача → один PR → merge → следующая. Параллельно ТОЛЬКО если scope'ы строго orthogonal (разные файлы).

Опасные файлы для конфликтов: backend/app/api/v1/parcels.py, frontend/src/types/site-finder.ts, OverviewTab/LandTab/MarketTab.

Split big issues

Issues ≥ 1.5 day → 3-4 sub-PRs: Foundation → Schema → Workers → Integration. Каждый ~200-500 lines. PR N+1 только после merge PR N.

Review workflow (no conflict)

• Pre-push (локально): spawn code-reviewer subagent на staged changes → lint pass (security, correctness, conventions). Блокирует push при 🔴 критикал.
• Post-push (внешнее окно Claude): делает review после PR create, постит комменты от lekss361. Main session НЕ дублирует — только acting on review comments (fixup commits).

Запреты

• ❌ git push forgejo main / direct push в main
• ❌ mcp__forgejo__merge_pull_request без approval (human "merge it" или bot verdict=approve + SHA match)
• ❌ gh pr * — bypassed 2026-05-16, используй Forgejo MCP или curl + $FORGEJO_TOKEN
• ❌ --no-verify / --amend / --no-edit / --force без явного approval
• ❌ @claude в PR comments — plain text only (feedback_no_claude_mentions)
• ❌ Параллельные PR на одни файлы (feedback_sequential_prs)