| name | github-workflow |
| description | Use when working with massCode issues, branches, commits, pull requests, or merge preparation in GitHub. |
github-workflow
Issue
Если работа идёт по issue, читать его через gh:
gh issue view <number> -R massCodeIO/massCode
Если issue описывает bug, не считай его автоматически подтверждённым.
Сначала:
- понять ожидаемое поведение;
- проверить текущее поведение в коде или воспроизвести проблему;
- подтвердить bug или явно зафиксировать, что он не подтверждается;
- только после этого переходить к ветке, фиксу и PR.
Если bug не воспроизводится или issue описан неясно:
- не начинать слепую реализацию;
- сначала сообщить, что проблема не подтверждена, и уточнить условия или шаги воспроизведения.
Branch
Создавай ветку от main с префиксом по типу изменения (feat/, fix/, chore/, refactor/) и коротким описанием. Если работа идёт по issue — уместно добавить номер в конец.
git checkout main && git pull
git checkout -b feat/<short-description> main
PR
Заголовок PR — conventional commits:
type: description
Перед созданием PR предложи заголовок пользователю на подтверждение.
Если PR закрывает существующий issue, в описании добавляй:
closes #123
Перед PR убедись, что релевантные проверки и тесты для затронутой области действительно прогнаны.
Создание:
gh pr create \
--base main \
--head <branch-name> \
--title "type: description" \
--body "closes #<issue_number>" \
--assignee @me
Если issue нет — в --body кратко опиши суть изменений без служебного AI-хвоста.
После создания PR предложи пользователю смерджить его в main:
gh pr merge <pr_number> -R massCodeIO/massCode --squash --delete-branch
После merge синхронизируй локальную ветку:
git checkout main && git pull
git branch -d <branch-name>
Commit
- Только однострочный заголовок conventional commit.
- Используй подходящий scope для коммитов и PR (
feat(notes):, 'fix(math):).
- Без тела, без
Co-Authored-By.
