Внедрить единый issue-first Engineering Workflow #27

Closed
opened 2026-10-12 08:32:41 +03:00 by codex-bot · 6 comments
Owner

Контекст и результат

В пяти checkout WealthLedger правила веток, Issue, коммитов и PR разрознены; локальный процесс проверок и release уже существуют. Внедрить один пропорциональный issue-first workflow в root, frontend, backend, docs и specs без нового workflow-движка и без изменения стандартных OpenSpec skills. deploy находится вне workspace: описать границу применения, не менять его вслепую.

Критерии готовности

  • Один канонический маршрут Request → Issue → Analysis → lightweight/SDD → Branch → Implementation → Validation → PR → Review → Merge → Close с явными исключениями release/hotfix и cross-repo ссылками.
  • В каждом затронутом checkout агент до edits находит/создаёт соответствующий Issue, проверяет AC и выбирает корректную ветку; чтение разрешено без Issue.
  • Компактные Issue/PR templates, Conventional Commits с Issue reference и соответствующие CI checks переиспользуют существующий commitlint.
  • Указаны действительные уровни enforcement и пробелы Gitea; не добавлены скрипты, зависимости и тяжёлые hooks.
  • Существующие gates и OpenSpec approval lifecycle не нарушены; безопасные позитивные/негативные сценарии проверены.

Связанные задачи

main #24 — завершённая оптимизация проверок (не заменяет эту задачу); specs #1 — отдельное уточнение нормативной SDD lifecycle spec. Один coordinating Issue достаточен для согласованной поставки процесса; ссылки на него укажем во всех рабочих ветках/PR.

Тип: chore/process. Приоритет: medium. Исполнитель: hermes-agent.

## Контекст и результат В пяти checkout WealthLedger правила веток, Issue, коммитов и PR разрознены; локальный процесс проверок и release уже существуют. Внедрить один пропорциональный issue-first workflow в root, frontend, backend, docs и specs без нового workflow-движка и без изменения стандартных OpenSpec skills. `deploy` находится вне workspace: описать границу применения, не менять его вслепую. ## Критерии готовности - [ ] Один канонический маршрут Request → Issue → Analysis → lightweight/SDD → Branch → Implementation → Validation → PR → Review → Merge → Close с явными исключениями release/hotfix и cross-repo ссылками. - [ ] В каждом затронутом checkout агент до edits находит/создаёт соответствующий Issue, проверяет AC и выбирает корректную ветку; чтение разрешено без Issue. - [ ] Компактные Issue/PR templates, Conventional Commits с Issue reference и соответствующие CI checks переиспользуют существующий commitlint. - [ ] Указаны действительные уровни enforcement и пробелы Gitea; не добавлены скрипты, зависимости и тяжёлые hooks. - [ ] Существующие gates и OpenSpec approval lifecycle не нарушены; безопасные позитивные/негативные сценарии проверены. ## Связанные задачи [main #24](https://git.personal.ksv741.ru/WealthLedger/main/issues/24) — завершённая оптимизация проверок (не заменяет эту задачу); [specs #1](https://git.personal.ksv741.ru/WealthLedger/specs/issues/1) — отдельное уточнение нормативной SDD lifecycle spec. Один coordinating Issue достаточен для согласованной поставки процесса; ссылки на него укажем во всех рабочих ветках/PR. Тип: chore/process. Приоритет: medium. Исполнитель: hermes-agent.
codex-bot added the
Priority
Medium
3
Kind/Process
labels 2026-10-12 08:32:41 +03:00
codex-bot self-assigned this 2026-10-12 08:32:41 +03:00
Author
Owner

Discovery: пять независимых checkout в workspace и отдельный Gitea repo deploy (без checkout). Существующие commitlint/CI/локальные hooks и release lifecycle переиспользованы; шаблоны и минимальные правила подготовлены в пяти локальных ветках chore/27-engineering-workflow. Проверены docs npm run verify, specs npm run verify, node --check/git diff --check и положительные/отрицательные commitlint примеры; CI Gitea и branch protection на итоговом HEAD проверяются после публикации PR. Настройки branch protection не изменялись: у текущего API-клиента отсутствует право/метод на чтение и запись этих правил, перед merge нужен аудит владельца. Issue остаётся открытой до принятия всех PR.

Discovery: пять независимых checkout в workspace и отдельный Gitea repo `deploy` (без checkout). Существующие commitlint/CI/локальные hooks и release lifecycle переиспользованы; шаблоны и минимальные правила подготовлены в пяти локальных ветках `chore/27-engineering-workflow`. Проверены docs `npm run verify`, specs `npm run verify`, `node --check`/`git diff --check` и положительные/отрицательные commitlint примеры; CI Gitea и branch protection на итоговом HEAD проверяются после публикации PR. Настройки branch protection не изменялись: у текущего API-клиента отсутствует право/метод на чтение и запись этих правил, перед merge нужен аудит владельца. Issue остаётся открытой до принятия всех PR.
hermes-agent added this to the WealthLedger — Delivery Board project 2026-10-12 09:13:11 +03:00
hermes-agent added this to the Инженерная основа и поставка milestone 2026-10-12 09:13:19 +03:00
Author
Owner

Ветки chore/27-engineering-workflow отправлены; PR в develop: main #28, frontend #66, backend #76, docs #36, specs #32. Все PR связаны с этой Issue; она остаётся открытой до review, CI и merge всех пяти. Локально docs/specs verify, commitlint, syntax и diff checks выполнены. Состояние CI контролируется в PR; branch protection всё ещё требует проверки владельца.

Ветки `chore/27-engineering-workflow` отправлены; PR в `develop`: [main #28](https://git.personal.ksv741.ru/WealthLedger/main/pulls/28), [frontend #66](https://git.personal.ksv741.ru/WealthLedger/frontend/pulls/66), [backend #76](https://git.personal.ksv741.ru/WealthLedger/backend/pulls/76), [docs #36](https://git.personal.ksv741.ru/WealthLedger/docs/pulls/36), [specs #32](https://git.personal.ksv741.ru/WealthLedger/specs/pulls/32). Все PR связаны с этой Issue; она остаётся открытой до review, CI и merge всех пяти. Локально docs/specs verify, commitlint, syntax и diff checks выполнены. Состояние CI контролируется в PR; branch protection всё ещё требует проверки владельца.
codex-bot removed their assignment 2026-10-12 09:32:21 +03:00
hermes-agent was assigned by codex-bot 2026-10-12 09:32:21 +03:00
Author
Owner

Metadata PR #28, frontend #66, backend #76, docs #36, specs #32: assignee hermes-agent, labels Kind/Process + Priority/Medium, соответствующий repo milestone «Инженерная основа и поставка» и org project «WealthLedger — Delivery Board» назначены и проверены через Gitea API. Этап доски ещё нужно перенести из «Бэклог» в «На проверке»: публичный Gitea API 1.27.3 не публикует project-column routes; поиск доступного authenticated UI/маршрута продолжается.

Metadata PR #28, frontend #66, backend #76, docs #36, specs #32: assignee `hermes-agent`, labels `Kind/Process` + `Priority/Medium`, соответствующий repo milestone «Инженерная основа и поставка» и org project «WealthLedger — Delivery Board» назначены и проверены через Gitea API. Этап доски ещё нужно перенести из «Бэклог» в «На проверке»: публичный Gitea API 1.27.3 не публикует project-column routes; поиск доступного authenticated UI/маршрута продолжается.
Author
Owner

В main#28 дописано правило: назначаемые Issue/PR → hermes-agent; PR наследует type/priority и подходящий milestone, добавляется в Delivery Board и при review переносится в «На проверке». Commit 59e0831 опубликован, CI для нового HEAD перезапускается. Все шесть записей (Issue + 5 PR) теперь содержат labels, assignee, milestone и проект. Перенос колонки остаётся в работе: API 1.27.3 предоставляет projects на Issue, но не маршрут колонок; web-интерфейс доступен только анонимно.

В `main#28` дописано правило: назначаемые Issue/PR → `hermes-agent`; PR наследует type/priority и подходящий milestone, добавляется в Delivery Board и при review переносится в «На проверке». Commit `59e0831` опубликован, CI для нового HEAD перезапускается. Все шесть записей (Issue + 5 PR) теперь содержат labels, assignee, milestone и проект. Перенос колонки остаётся в работе: API 1.27.3 предоставляет `projects` на Issue, но не маршрут колонок; web-интерфейс доступен только анонимно.
Author
Owner

Ограничение для этапа доски подтверждено: org Delivery Board (ID 1) хранит эти шесть карточек в колонке «Бэклог» (ID 1), целевая «На проверке» — ID 4. API Gitea 1.27.3 не содержит project-column endpoints, а web POST /WealthLedger/-/projects/1/4/move требует browser-session/CSRF и перенаправляет token API на login. Без доступной authenticated browser session карточки нельзя безопасно переместить; владелец должен перетащить main#27 и пять PR в «На проверке». Остальные поля проставлены и проверены.

Ограничение для этапа доски подтверждено: org Delivery Board (ID 1) хранит эти шесть карточек в колонке «Бэклог» (ID 1), целевая «На проверке» — ID 4. API Gitea 1.27.3 не содержит project-column endpoints, а web `POST /WealthLedger/-/projects/1/4/move` требует browser-session/CSRF и перенаправляет token API на login. Без доступной authenticated browser session карточки нельзя безопасно переместить; владелец должен перетащить main#27 и пять PR в «На проверке». Остальные поля проставлены и проверены.
Author
Owner

Все пять PR смержены в develop:

CI на итоговых HEAD был зелёным. Issue закрывается.

Примечание: два ручных пункта владельца остались вне автоматизации — проверка branch protection (нет прав у API-клиента) и перемещение карточек Delivery Board из «Бэклог» в «На проверке» (API Gitea 1.27.3 не поддерживает project-columns).

Все пять PR смержены в `develop`: - WealthLedger/main#28 - WealthLedger/frontend#66 - WealthLedger/backend#76 - WealthLedger/docs#36 - WealthLedger/specs#32 CI на итоговых HEAD был зелёным. Issue закрывается. Примечание: два ручных пункта владельца остались вне автоматизации — проверка branch protection (нет прав у API-клиента) и перемещение карточек Delivery Board из «Бэклог» в «На проверке» (API Gitea 1.27.3 не поддерживает project-columns).
ksv741 moved this to Готово in WealthLedger — Delivery Board on 2026-10-12 11:04:29 +03:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: WealthLedger/main#27