d643453dee
- Ссылки на источник истины v5.13/v5.14/v5.15 → v5.17: openspec/config.yaml, KICKOFF-PROMPT, 00-workspace-layout, 08-source-docs-index, заголовок 05-domain-rules, dev/checks.md; спека quality-checks — без привязки к версии (путь — переменная DBML Makefile). - Диаграммы model/diagrams/part01…09 перерисованы по v5.17 (были v5.12): scripts/gen_model_diagrams.py (разбиение DBML на части + dbml-renderer + resvg через npx, версии закреплены), цель make diagrams; описание в 04-data-model-guide, 06-test-data, 08-source-docs-index. - dev/frontend-api-guide.md: КПП (arm-core #52) и DB_SCHEMA (#53) — из §11 в §1, КПП в маршрутах §5.2/§5.3, схеме §5.8 и каталоге ошибок §9 (сверено с кодом 99669cd). - Ссылки на заархивированные change'и (dev/README, dev/checks, api-contract-slice-3b/4), путь к v4 DBML в индексе. - 09-delivery-plan: статусы Срезов 0, 2d, 3b, 4. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012vJkmBGKKqMoEMzvsXG3y2
36 lines
3.3 KiB
YAML
36 lines
3.3 KiB
YAML
schema: spec-driven
|
||
|
||
context: |
|
||
Репозиторий arm-ka-docs — контекст, модель данных (DBML v5.17), правила домена, контракты между сервисами
|
||
(docs/contracts/*.schema.json), макет UI и экспорт ТЗ системы АРМ КА (ДКБ, Россельхозбанк).
|
||
Здесь оформляются СКВОЗНЫЕ изменения: контракт + окружение разработки (docs/dev) + проверки качества (make check) + изменения
|
||
документов контекста. Код сервисов живёт в соседних репозиториях (../arm-core, ../tabular-parser, ../scan-gateway),
|
||
у каждого свой openspec/ и свой change; сквозной change ссылается на них.
|
||
Источники истины по приоритету: docs/model/data-model-v5.17.dbml → docs/model/entities-v5.17.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'и сервисов заархивированы или явно перенесены в следующий срез"
|