Design-system drift check

How to classify differences across prototype, Figma, bloom-nx, production UI kit, Storybook, and shipped app surfaces.

Compare the relevant surfaces, then decide which one should move. Do not silently normalize everything to the prototype or to production.

Classifications

  • Intentional evolution.
  • Acceptable product one-off.
  • Prototype-only divergence.
  • Implementation bug.
  • Design-system gap.
  • Stale Figma.
  • Stale prototype docs.
  • Stale Storybook/package docs.
  • Package-authority conflict.
  • Unknown.

Action routing

  • App bug: product repo.
  • Production component gap: production UI kit and Storybook/package docs.
  • Candidate pattern: bloom-design-ops and promotion packet.
  • Stale Figma: update reviewed design trail.
  • Stale prototype: update route docs, ledger, or mark superseded.