From eaf7ede8414f0df972f9ae7ab9e223a6350b5462 Mon Sep 17 00:00:00 2001 From: Sergey Krylov Date: Mon, 12 Oct 2026 09:20:54 +0300 Subject: [PATCH 1/3] chore: align docs engineering workflow (WealthLedger/main#27) --- .gitea/ISSUE_TEMPLATE/bug.md | 15 +++++++++++++++ .gitea/ISSUE_TEMPLATE/engineering.md | 13 +++++++++++++ .gitea/ISSUE_TEMPLATE/feature.md | 15 +++++++++++++++ .gitea/ISSUE_TEMPLATE/refactor.md | 15 +++++++++++++++ .gitea/PULL_REQUEST_TEMPLATE.md | 19 +++++++++++++++++++ AGENTS.md | 7 +++++-- README.md | 6 ++++-- commitlint.config.cjs | 6 +++++- 8 files changed, 91 insertions(+), 5 deletions(-) create mode 100644 .gitea/ISSUE_TEMPLATE/bug.md create mode 100644 .gitea/ISSUE_TEMPLATE/engineering.md create mode 100644 .gitea/ISSUE_TEMPLATE/feature.md create mode 100644 .gitea/ISSUE_TEMPLATE/refactor.md create mode 100644 .gitea/PULL_REQUEST_TEMPLATE.md diff --git a/.gitea/ISSUE_TEMPLATE/bug.md b/.gitea/ISSUE_TEMPLATE/bug.md new file mode 100644 index 0000000..ef84f40 --- /dev/null +++ b/.gitea/ISSUE_TEMPLATE/bug.md @@ -0,0 +1,15 @@ +--- +name: Bug Report +about: Неверное поведение +--- +# Bug Report + +## Проблема и шаги воспроизведения + +## Факт / ожидание + +## Acceptance Criteria + +- [ ] + +## Окружение / ссылки (если применимо) diff --git a/.gitea/ISSUE_TEMPLATE/engineering.md b/.gitea/ISSUE_TEMPLATE/engineering.md new file mode 100644 index 0000000..b443763 --- /dev/null +++ b/.gitea/ISSUE_TEMPLATE/engineering.md @@ -0,0 +1,13 @@ +--- +name: Engineering Task +about: CI, тесты, документация, процесс и прочее +--- +# Engineering Task + +## Контекст и результат + +## Scope / связанные Issues (если есть) + +## Acceptance Criteria + +- [ ] diff --git a/.gitea/ISSUE_TEMPLATE/feature.md b/.gitea/ISSUE_TEMPLATE/feature.md new file mode 100644 index 0000000..07fc8f1 --- /dev/null +++ b/.gitea/ISSUE_TEMPLATE/feature.md @@ -0,0 +1,15 @@ +--- +name: Feature Request +about: Новое наблюдаемое поведение +--- +# Feature Request + +## Зачем и какой результат + +## Ожидаемое поведение + +## Acceptance Criteria + +- [ ] + +## Зависимости / связанные Issues (если есть) diff --git a/.gitea/ISSUE_TEMPLATE/refactor.md b/.gitea/ISSUE_TEMPLATE/refactor.md new file mode 100644 index 0000000..f128dc1 --- /dev/null +++ b/.gitea/ISSUE_TEMPLATE/refactor.md @@ -0,0 +1,15 @@ +--- +name: Refactoring / Technical Debt +about: Улучшение без нового поведения +--- +# Refactoring / Technical Debt + +## Проблема и результат + +## Сохраняемые инварианты / границы + +## Acceptance Criteria + +- [ ] + +## Зависимости / ссылки (если есть) diff --git a/.gitea/PULL_REQUEST_TEMPLATE.md b/.gitea/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..b749661 --- /dev/null +++ b/.gitea/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,19 @@ +# Pull Request + +## Summary + +Краткий результат работы описывается здесь. + +## Linked Issue + +Refs `` (заменить ссылкой на реальную Issue). + +## Changes + +Затронутые части и изменения. + +## Verification + +- Команда / результат / ограничения: + +## Breaking Changes (если есть) diff --git a/AGENTS.md b/AGENTS.md index d16b722..b73edb9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -3,6 +3,8 @@ Перед изменением прочитай [README](README.md) и [CONTRIBUTING](CONTRIBUTING.md), затем только затронутую тему. Docs объясняет систему; требования принадлежат основным спецификациям, реализация и coding conventions — соседним репозиториям. +До edits найди/создай подходящую Gitea Issue, проверь AC и ветку; чтение +допускается без Issue. Общий маршрут — [Engineering Workflow](https://git.personal.ksv741.ru/WealthLedger/main/src/branch/develop/.ai/conventions/engineering-workflow.md). Проверь существенные факты по локальным тематическим страницам и ADR; внешние источники используй как справочные свидетельства, когда они доступны. @@ -20,7 +22,8 @@ ## Ветки и релизы -Работа — в отдельной ветке от `develop`, затем PR в `develop`; в `main` напрямую +Работа — в issue-linked ветке от `develop`, затем PR в `develop`; в `main` напрямую не пушить. Release/hotfix и синхронизация веток — по [README](README.md#релизы). -Commits и заголовки PR — Conventional Commits; для спецификаций допустим `spec:`. +Commits и заголовки PR — Conventional Commits со ссылкой на Issue (кроме release); +для спецификаций допустим `spec:`. Перед подготовкой релиза прочитай местный README; версии вручную не повышать. diff --git a/README.md b/README.md index 8bb90f6..4be690d 100644 --- a/README.md +++ b/README.md @@ -72,9 +72,11 @@ WealthLedger помогает частному инвестору понимат ## Релизы Репозиторий выпускается независимо. `develop` — интеграция, `main` — принятые -релизы. Работа: `codex/` от актуального `develop`, PR в `develop`. +релизы. Обычная работа: issue-linked ветка от актуального `develop`, PR в `develop`; +общие правила — в Engineering Workflow по ссылке из AGENTS. Обычные PR допускают squash; release и обратная синхронизация сохраняют историю. -Commits и PR titles — Conventional Commits, включая `spec:`. Версии вручную не повышай. +Commits и PR titles — Conventional Commits со ссылкой на Issue (кроме release), +включая `spec:`. Версии вручную не повышай. 1. Получи `main`, `develop` и теги: `git fetch origin --tags`. Убедись, что `develop` содержит последний релиз. Создай `release/` от проверенного diff --git a/commitlint.config.cjs b/commitlint.config.cjs index 4aa31e2..2a6c08b 100644 --- a/commitlint.config.cjs +++ b/commitlint.config.cjs @@ -1,4 +1,8 @@ module.exports = { extends: ["@commitlint/config-conventional"], - rules: { "type-enum": [2, "always", ["feat", "fix", "perf", "docs", "spec", "refactor", "build", "ci", "test", "style", "chore", "revert"]] }, + ignores: [(message) => /^chore\(release\): \d+\.\d+\.\d+/.test(message)], + rules: { + "type-enum": [2, "always", ["feat", "fix", "perf", "docs", "spec", "refactor", "build", "ci", "test", "style", "chore", "revert"]], + "references-empty": [2, "never"], + }, }; From 602eb43294509274cbd9003be31f726b6e275a1e Mon Sep 17 00:00:00 2001 From: Sergey Krylov Date: Mon, 12 Oct 2026 10:21:16 +0300 Subject: [PATCH 2/3] fix: align docs commitlint workflow (WealthLedger/main#27) --- AGENTS.md | 3 ++- commitlint.config.cjs | 6 +++++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index b73edb9..e0b908c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,7 +4,8 @@ затем только затронутую тему. Docs объясняет систему; требования принадлежат основным спецификациям, реализация и coding conventions — соседним репозиториям. До edits найди/создай подходящую Gitea Issue, проверь AC и ветку; чтение -допускается без Issue. Общий маршрут — [Engineering Workflow](https://git.personal.ksv741.ru/WealthLedger/main/src/branch/develop/.ai/conventions/engineering-workflow.md). +допускается без Issue. Общий маршрут — [Engineering Workflow](https://git.personal.ksv741.ru/WealthLedger/main/src/commit/59e0831ad28d6990416e651f55d783b8d2ac98c2/.ai/conventions/engineering-workflow.md) +(main#28; после merge — актуальная версия `develop`). Проверь существенные факты по локальным тематическим страницам и ADR; внешние источники используй как справочные свидетельства, когда они доступны. diff --git a/commitlint.config.cjs b/commitlint.config.cjs index 2a6c08b..512700c 100644 --- a/commitlint.config.cjs +++ b/commitlint.config.cjs @@ -1,6 +1,10 @@ module.exports = { extends: ["@commitlint/config-conventional"], - ignores: [(message) => /^chore\(release\): \d+\.\d+\.\d+/.test(message)], + defaultIgnores: false, + ignores: [ + message => /^chore\(release\): \d+\.\d+\.\d+$/.test(message.trim()), + message => /^Merge pull request ['"].+['"] \(#\d+\) from .+ into .+$/.test(message.trim()), + ], rules: { "type-enum": [2, "always", ["feat", "fix", "perf", "docs", "spec", "refactor", "build", "ci", "test", "style", "chore", "revert"]], "references-empty": [2, "never"], From c24e4b990aaeffd02e05f7de21942579e452cecf Mon Sep 17 00:00:00 2001 From: Sergey Krylov Date: Mon, 12 Oct 2026 10:22:13 +0300 Subject: [PATCH 3/3] docs: pin docs workflow reference (WealthLedger/main#27) --- AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index e0b908c..b960170 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,7 +4,7 @@ затем только затронутую тему. Docs объясняет систему; требования принадлежат основным спецификациям, реализация и coding conventions — соседним репозиториям. До edits найди/создай подходящую Gitea Issue, проверь AC и ветку; чтение -допускается без Issue. Общий маршрут — [Engineering Workflow](https://git.personal.ksv741.ru/WealthLedger/main/src/commit/59e0831ad28d6990416e651f55d783b8d2ac98c2/.ai/conventions/engineering-workflow.md) +допускается без Issue. Общий маршрут — [Engineering Workflow](https://git.personal.ksv741.ru/WealthLedger/main/src/commit/03b3b59e6ff2ba391f9dfc42a039a96d0d84c1c9/.ai/conventions/engineering-workflow.md) (main#28; после merge — актуальная версия `develop`). Проверь существенные факты по локальным тематическим страницам и ADR;