# Design

## Context

Связанный change arm-core — `use-installed-statements-library`; обновление аннотаций общей схемы одобрено пользователем 23.10.2026. Файл схемы в docs — источник истины для побайтовых копий сервисов.

## Goals / Non-Goals

**Goals:** согласовать descriptions и явно подтвердить отсутствие изменений валидируемой структуры.

**Non-Goals:** изменение версии/ограничений контракта, правка docs/source, запуск миграций, обновление runtime других сервисов.

## Decisions

Обновить только корневой description и description поля service.statements_version по согласованному тексту arm-core. Проверить глубокое равенство JSON до/после без этих двух аннотаций и точное совпадение файлов docs/arm-core. Использовать существующий валидатор примеров и тест сверки копий. Отдельные дельты требований не нужны (`skip_specs: true`), поскольку нормативный формат не меняется.

Контекст получает короткие заметки о переходе arm-core; они не объявляют переход остальных сервисов завершённым.

## Decisions made without discussion

23.10.2026: сохранить schema_version 2.0 при изменении только descriptions. Обоснование — множество валидных входов и структура результата неизменны. Цена ошибки — неверная маркировка релиза; проверяется сравнением JSON без двух изменённых аннотаций. Обновление общей схемы вместо отката локальной копии выбрано пользователем.

## Risks / Trade-offs

[Другие копии схем ещё содержат прежний текст] → перечислить производителей и потребителя в proposal; их копии могут быть синхронизированы отдельными изменениями. [Контекст по другим сервисам не проверялся] → заметки ограничены arm-core.