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
@@ -42,6 +42,13 @@ instructions, выполните доступную native structural прове
Design и Delta Specs для exact `Covers`; второй context mapping не нужен.
Approval и bounded progression соблюдают governance policy.
Для Design определите
[UI/UX applicability и пакет](engineering-governance.md#uiux-пакет-design).
Прочитайте его применимые материалы, проверьте сохранённые пути, revision,
доступность и SHA-256 exports обычными файловыми операциями. Представьте весь
пакет в одном Design approval; native structural validation не проверяет
произвольные attachments или качество визуального решения автоматически.
Новые changes используют project-local schema `wealth-ledger-sdd` из
`specs/openspec/schemas/wealth-ledger-sdd` и граф
`proposal → specs → design → tasks → apply`. `config.yaml` хранит default schema
@@ -73,6 +80,10 @@ outcome. Remaining implementation work даёт checkpoint; вся заверш
[approval binding](agent-token-efficiency.md#fingerprints), а semantic issue
возвращается к ответственной planning boundary.
При применимом UI/UX scope восстановите именно согласованный пакет из Design
до зависимой реализации. Missing material, digest mismatch и external-only
reference не компенсируются историей чата или текущим внешним макетом.
Validation читает approved planning artifacts и implementation scope, проверяет
свежесть сохранённых gate outcomes и выполняет отсутствующие affected gates.
Глобальный gate нельзя считать проверенным по более узкому fingerprint: binding
@@ -92,6 +103,12 @@ scenarios и применимыми edge cases; фиксирует `PASS`, `FAIL
требуется: observed verdict и binding передаются в текущем handoff и затем
в canonical Completion Evidence.
Для UI/UX reviewer читает пакет той же revision и сопоставляет применимые
экраны, состояния, взаимодействия и responsive behavior. Однозначное отклонение
реализации — `FAIL`; противоречие либо неоднозначность пакета — `SPEC_ISSUE`.
Review не исправляет интерфейс или Design package и не подменяется наличием
stories, screenshots или успешной сборкой.
## Semantic sync перед archive
Перед terminal mutation сверяйте все deltas с текущей main baseline. Native
@@ -157,7 +174,10 @@ validation main specs. Он не даёт terminal status и не расширя
`--yes` автоматизирует prompt, не снимает safeguards. `--no-validate` и
`--skip-specs` не являются обходом failed gate, stale PASS или semantic conflict.
5. Проверьте наблюдённый archive path, сохранение Completion Evidence и ожидаемый
diff sync/move. Изменённые archive/main-spec outputs проходят native strict
diff sync/move. Для применимого Design package проверьте сохранение
относительной структуры Design/visuals, доступность каждого материала,
совпадение SHA-256 и exact immutable reuse references после переноса.
Утрата или замена материала блокирует завершение. Изменённые archive/main-spec outputs проходят native strict
проверку; это проверка новых completion outputs, не повторная Validation
неизменившейся реализации. Зафиксируйте разрешённые archive/sync/evidence
изменения и сообщите созданный commit ID отдельно от evidence, чтобы избежать