Добавлены ADR

This commit is contained in:
2026-10-11 09:46:32 +03:00
parent 6c6a843571
commit aed0eea1ec
4 changed files with 99 additions and 3 deletions
@@ -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