Document portable UI design packages and Storybook workflow

This commit is contained in:
2026-09-07 22:48:16 +03:00
parent 024e240303
commit ac6c1ecc60
6 changed files with 97 additions and 9 deletions
+49
View File
@@ -107,6 +107,55 @@ bounded reads, fingerprint bindings, handoff, evidence reuse и batching.
commands и session adapters необязательны. Числовые token budgets и telemetry
не являются условием delivery.
## UI/UX-пакет Design
UI/UX относится к существующему canonical Design и его единому approval.
Design определяет applicability: `new/changed`, `reuse` либо `N/A` с конкретной
причиной. Применимый scope описывает затронутые экраны, состояния, взаимодействия
и responsive behavior; reuse указывает точную версию решения, используемую часть
и отличия. Неизменяемая область и обоснованный N/A не требуют нового макета.
Основное переносимое представление — Markdown в Design. Необходимые PNG/SVG
exports хранятся в `visuals/` того же canonical change. Design фиксирует revision
пакета и для каждого материала — identity, относительный путь, назначение
(экран/состояние) и SHA-256 raw bytes отдельного файла. Встроенный Markdown
входит в обычный Design fingerprint без собственного self-referential hash.
SVG самодостаточен: без scripts, исполняемых handlers и внешних fonts/assets.
Внешний editor, preview или текущая Storybook-витрина может быть reference;
согласованный результат доступен из canonical пакета без внешнего runtime,
аккаунта или изменяемого URL. Reuse из другого change указывает точный immutable
архивный пакет и применимые материалы, а не `latest`. При переносе вызывающего
change reuse source сохраняет store ID и путь от canonical OpenSpec root;
пути материалов остаются относительными к исходному пакету. Пакет доступен
после archive вместе с Design; относительная структура и identities
материалов сохраняются.
Approval относится ко всему представленному Design package. Его revision
и digest обнаруживают изменения, но сами не подтверждают решение владельца.
Существующие approval и PASS bindings включают перечисленные attachments
и reuse inputs по [context authority](agent-token-efficiency.md#fingerprints).
Смысловая замена материала или правила возвращается к Design; затронутые
requirements — к Delta Specs, intent — к Proposal с обычным cascade approvals.
Missing material, digest mismatch, неоднозначный пакет и external-only source
блокируют зависимую работу до восстановления точных согласованных bytes либо
решения на ответственной planning boundary. Восстановление не разрешает
дорисовывать отсутствующее решение по памяти. Validation остаётся read-only:
расхождение реализации с однозначным пакетом даёт `FAIL`, противоречие или
неоднозначность planning — `SPEC_ISSUE`. Reviewer сопоставляет экраны, состояния,
interactions и responsive behavior. Structural success, screenshots и наличие
Storybook не означают semantic PASS; отдельный visual checker или approval
engine не вводится.
Правило применяется к новым changes и ещё не утверждённому Design. Уже approved
Design и changes в Implementation/Validation сохраняют согласованный scope:
owner-requested migration проходит нужную planning boundary без автоматического
retrofit, reapproval или нового PASS. Historical archives и чужие state не
переписываются. Доступность каталога и процесса даёт готовность к отдельному
пилоту; его успешность подтверждает только фактически пройденный небольшой
UI change, выбранный владельцем и получивший собственные planning approvals.
## Delivery Map и multi-repository delivery
Design каждого change оценивает все четыре области: