Template
Добавлены ADR
This commit is contained in:
@@ -151,6 +151,38 @@ Scenario в таких операциях не создаётся. В delta со
|
||||
фиксируется в FR вместе с соответствием текущим outcome, trace-статусам и exit codes.
|
||||
Форматирование спецификации само по себе не реализует этот контракт в приложении.
|
||||
|
||||
## Архитектурные решения (ADR)
|
||||
|
||||
Храни ADR проекта в `openspec/context/adr/` и называй файлы
|
||||
`ADR-<номер>-<краткое-описание>.md`, например
|
||||
`ADR-0001-use-postgresql.md`. Используй четырёхзначную последовательную
|
||||
нумерацию: новый номер на единицу больше максимального номера в каталоге.
|
||||
Номер не переиспользуется, даже если решение отклонено или заменено. Краткое
|
||||
описание в имени файла пиши в `kebab-case`.
|
||||
|
||||
Создавай ADR для долгосрочных архитектурных решений с последствиями для
|
||||
будущих изменений: выбора между значимыми вариантами, общих ограничений,
|
||||
границ компонентов и решений, которые иначе пришлось бы повторно принимать.
|
||||
Не создавай ADR для каждого change, деталей реализации, уже полностью заданных
|
||||
спецификацией, или временных задач.
|
||||
|
||||
В ADR фиксируй контекст и проблему, факторы решения, рассмотренные варианты,
|
||||
выбранное решение и его последствия. Используй статусы `Proposed`, `Accepted`,
|
||||
`Rejected` и `Superseded`. Предложенный ADR становится действующим только после
|
||||
явного принятия владельцем решения. Отклонённые и заменённые ADR сохраняй как
|
||||
историю. Не меняй принятое решение задним числом: при пересмотре создай новый
|
||||
ADR со ссылкой на заменяемый и обнови его статус на `Superseded`. В новом ADR
|
||||
укажи заменяемый ID в `supersedes`, а в прежнем — новый ID в `superseded-by`.
|
||||
|
||||
Перед проектированием и реализацией агент читает применимые принятые ADR.
|
||||
Изменение должно ссылаться на относящиеся к нему ADR в `design.md`. При
|
||||
противоречии между запросом и принятым ADR агент явно сообщает о конфликте и
|
||||
получает решение пользователя, а не обходит ADR молча. Агент может подготовить
|
||||
ADR со статусом `Proposed`, но не принимает его самостоятельно.
|
||||
|
||||
Шаблон нового решения находится в
|
||||
[`templates/adr.md`](templates/adr.md).
|
||||
|
||||
## Проверки
|
||||
|
||||
```sh
|
||||
|
||||
Reference in New Issue
Block a user