0c04127aec
openspec init (config с контекстом docs-репозитория) и change slice-0-skeleton: proposal, design (11 решений без обсуждения, открытые вопросы к человеку), спеки recognition-contract, dev-environment, ci-template, tasks в порядке зависимостей между репозиториями. 06-test-data.md §6: справочники продукта — seed arm-core, не фикстуры. 09-delivery-plan.md: Срез 0 по факту (change'и, compose в docs/dev, контракт копией без общего пакета, seed). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
36 lines
3.2 KiB
YAML
36 lines
3.2 KiB
YAML
schema: spec-driven
|
||
|
||
context: |
|
||
Репозиторий arm-ka-docs — контекст, модель данных (DBML v5.13), правила домена, контракты между сервисами
|
||
(docs/contracts/*.schema.json), макет UI и экспорт ТЗ системы АРМ КА (ДКБ, Россельхозбанк).
|
||
Здесь оформляются СКВОЗНЫЕ изменения: контракт + окружение разработки (docs/dev) + CI-шаблон + изменения
|
||
документов контекста. Код сервисов живёт в соседних репозиториях (../arm-core, ../tabular-parser, ../scan-gateway),
|
||
у каждого свой openspec/ и свой change; сквозной change ссылается на них.
|
||
Источники истины по приоритету: docs/model/data-model-v5.13.dbml → docs/model/entities-v5.13.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'и сервисов заархивированы или явно перенесены в следующий срез"
|