ci-git-workflow.md

---

title: Git and CI Workflow impact: HIGH impactDescription: Ensures clean history and smooth CI pipeline tags: ci, git, workflow, conventional-commits

Паспорт документа

• Статус документа: living standard
• Актуально на: 28 марта 2026 года
• Владелец: backend/platform-команда
• Пересмотр: при изменении инженерной практики, CI/CD, архитектурных правил или локального workflow
• Область применения: внутренние rule/reference-card документы для инженерной команды
• Связанные документы:
  • Индекс Agents
  • Команды разработки
  • Инженерные принципы

Git and CI Workflow

Impact: HIGH

Branch Naming

feat/add-course-search
fix/lead-form-validation
refactor/catalog-service
chore/update-prisma

Commit Messages

Используй conventional commits, но описание пиши на русском языке и в результативной форме:

feat(catalog): добавлен фильтр subject в поиск курсов
fix(auth): корректно обработан истёкший refresh token
refactor(seller): валидация вынесена в shared schema
test(item): добавлены unit-тесты для ItemService
chore(deps): Next.js обновлён до 15.x
docs(api): добавлены Swagger-декораторы в catalog controller

Правило:

• type(scope) можно оставлять в латинице;
• основной текст commit message должен быть по-русски;
• основной текст должен описывать уже выполненный результат, а не планируемое действие;
• squash merge message для main тоже должен быть на русском языке.

Workflow

1. Create feature branch from main
2. Make small, focused commits
3. Run pnpm type-check && pnpm lint && pnpm test before pushing
4. Open draft PR
5. Self-review the diff
6. Mark as ready for review
7. Squash merge to main

Rules

• Never force push to main
• Never push directly to main — always use PRs
• Squash merge PRs for clean history
• Delete branches after merge
• Keep commits atomic — one logical change per commit