Обновил git процесс

This commit is contained in:
2026-10-18 20:17:26 +03:00
parent e2e2d0bcc2
commit b5558ec008
10 changed files with 185 additions and 34 deletions
+30 -2
View File
@@ -21,6 +21,33 @@
- Не принимай Proposed ADR самостоятельно. При конфликте запроса с принятым ADR
явно сообщи о нём и запроси решение владельца.
## Git-процесс OpenSpec Change
- Для каждой задачи используй одну feature-ветку от целевой ветки репозитория:
`feature/<task-code>-<task-name>`. Код бери из связанной задачи, имя —
короткий ASCII slug в нижнем регистре с дефисами. Не переименовывай уже
используемую ветку вслед за переименованием задачи.
- Используй эту ветку для двух последовательных PR в одну целевую ветку.
Обычный push разрешён только в feature-ветку; прямой push в целевую ветку,
force push и изменение чужих веток запрещены.
- Первый PR содержит только артефакты планирования OpenSpec: proposal, delta
specs либо отметку `skip_specs: true`, design, tasks и связанные метаданные.
Не начинай и не публикуй реализацию до ручного слияния первого PR и
отдельной команды владельца.
- После открытия первого PR остановись. Владелец отдельно ревьюит и вручную
сливает его, сохраняя feature-ветку. Одобрение или слияние сами по себе
не разрешают продолжать: дождись явной команды владельца в этом чате.
- После команды проверь в Git, что первый PR действительно слит в целевую
ветку. Если он ещё не слит, сообщи об этом и жди. После подтверждения
обнови ту же feature-ветку из целевой и продолжай реализацию в ней.
- Второй PR содержит реализацию, применимые проверки, документацию и
обновлённые задачи OpenSpec; добавь ссылку на задачу и первый PR. Для него
требуется отдельное актуальное ревью и успешные обязательные проверки.
Оба PR вручную сливает владелец.
- После запроса правок продолжай только по явной команде владельца. Закрытый
без слияния PR останавливает процесс до отдельного решения владельца.
Автоматическое слияние и продолжение по событиям Git не используются.
## Task Management
Для всех OpenSpec Changes используй скилл `task-tracker`.
@@ -39,8 +66,9 @@ Lifecycle:
- При существенном изменении change синхронизируй существующую задачу.
- После каждого рабочего сеанса Apply синхронизируй фактическое время.
- Перед archive выполни финальную синхронизацию; после успешной архивации
закрой связанную задачу и создай коммит с изменениями change и русским
описанием в 4–7 слов. При ошибке archive задачу не закрывай и коммит не создавай.
закрой связанную задачу и создай коммит с изменениями change. Начинай сообщение
коммита с ключа связанной задачи, затем кратко опиши изменения по-русски:
`CON-27 Правка тестов`. При ошибке archive задачу не закрывай и коммит не создавай.
- При повторном запросе или незавершённой синхронизации возобнови работу
с существующей связью, включая архивные changes.
+10 -2
View File
@@ -8,7 +8,8 @@ OpenSpec `use-case-driven`. Схема не устанавливает их ав
В комплект входят:
- `AGENTS.md` — навигация по контексту, правила OpenSpec и вызовы `task-tracker`;
- `AGENTS.md` — навигация по контексту, правила OpenSpec и Git-процесс
с двумя PR, вызовы `task-tracker`;
- `openspec/config.yaml` — выбор схемы и начальный контекст OpenSpec;
- `openspec/context/index.md` — карта постоянных документов проекта;
- `openspec/context/adr/README.md` — правила ведения ADR;
@@ -19,6 +20,12 @@ OpenSpec `use-case-driven`. Схема не устанавливает их ав
требования из `openspec/specs/`. Перед архитектурными изменениями читайте
применимые принятые ADR.
Git-процесс из `AGENTS.md` использует одну feature-ветку для двух PR:
сначала PR с планированием OpenSpec, затем после ручного слияния и явной
команды владельца — PR с реализацией. При переносе шаблона в существующий
проект объедините этот раздел с проектными правилами ветвления и защиты
целевой ветки.
`ADR-template.md` соответствует
`openspec/schemas/use-case-driven/templates/adr.md` в этом репозитории. При
изменении исходного шаблона обновляйте его копию здесь.
@@ -43,7 +50,8 @@ Task tracker configuration:
[инструкции корневого README](../../README.md#подключение-из-домашней-директории).
Создание или привязка, содержательные обновления, учёт времени, закрытие задачи
и коммит после успешного archive выполняются по Lifecycle из `AGENTS.md`.
Сообщение коммита должно быть на русском языке и состоять из 4–7 слов. Эти правила не нужно
Сообщение коммита начинайте с ключа связанной задачи, затем кратко описывайте
изменения по-русски: `CON-27 Правка тестов`. Эти правила не нужно
добавлять в схему или `config.yaml`. Запуск OpenSpec CLI вне Codex не вызывает
скилл; для завершения внешней синхронизации обратитесь к агенту.