Template
Обновил git процесс
This commit is contained in:
@@ -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.
|
||||
|
||||
|
||||
@@ -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 не вызывает
|
||||
скилл; для завершения внешней синхронизации обратитесь к агенту.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user