schema: spec-driven

context: |
  Репозиторий arm-ka-docs — контекст, модель данных (DBML v5.21), правила домена, контракты между сервисами
  (docs/contracts/*.schema.json), макет UI и экспорт ТЗ системы АРМ КА (ДКБ, Россельхозбанк).
  Здесь оформляются СКВОЗНЫЕ изменения: контракт + окружение разработки (docs/dev) + проверки качества (make check) + изменения
  документов контекста. Код сервисов живёт в соседних репозиториях (../arm-core, ../tabular-parser, ../scan-gateway),
  у каждого свой openspec/ и свой change; сквозной change ссылается на них.
  Источники истины по приоритету: docs/model/data-model-v5.21.dbml → docs/model/entities-v5.21.md →
  docs/context/05-domain-rules.md → docs/source/tz (черновик, имена v4). Открытые вопросы — docs/context/07-open-questions.md;
  план срезов — docs/context/09-delivery-plan.md; соглашения шаблона команды — docs/context/03-architecture.md.
  Язык документов и коммитов — русский, идентификаторы — английские, как в DBML. docs/source/** не редактируется.

rules:
  proposal:
    - Указывать номер среза из 09-delivery-plan.md и перечислять дочерние change'и в сервисных репозиториях
    - "Изменение контракта = новая schema_version; перечислять сервисы, которые его читают и пишут"
    - Раздел «Non-goals» обязателен
    - Любое допущение по открытому вопросу помечать ASSUMPTION(OQ-nn)
  specs:
    - "Требования к контракту — через JSON Schema и примеры из ../fixtures; требования к окружению — через наблюдаемое поведение (сервис стартует, бакет существует, сообщение доставлено)"
  design:
    - "Раздел «Decisions made without discussion» обязателен: дата, решение, обоснование, цена ошибки"
  tasks:
    - Задачи не больше половины дня, с указанием репозитория и файлов, в порядке зависимостей между репозиториями
    - Последняя задача — обновление документов контекста (03-architecture, 07-open-questions, 09-delivery-plan)

operations:
  apply:
    guidance:
      - Работать в ветке (worktree); git -C <repo>; один PR на репозиторий; в описании PR указывать связанные PR
      - Файлы docs/source/** не трогать
  archive:
    guidance:
      - "Перед архивированием: дочерние change'и сервисов заархивированы или явно перенесены в следующий срез"