Document portable UI design packages and Storybook workflow
This commit is contained in:
@@ -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 оценивает все четыре области:
|
||||
|
||||
Reference in New Issue
Block a user