Salvage review of the recovered design-system superset (SALVAGE.md) #208

Closed
opened 2026-10-10 18:13:05 +00:00 by peterswimm · 2 comments
Owner

Inventory the recovered design-system superset against the live system, and decide what, if anything, is worth bringing back. This is a review document only. It makes no brand, token, logo or component changes; anything worth salvaging gets its own PR later, with Keff's and leadership's sign-off.

Background

The authored design system imported from the claude.ai Design project on 2026-06-28 was believed lost after the 2026-06-27 cut-over. It turned up as an unpushed local branch and is now on main, read-only, at archive/design-system-superset-20260628/ (#202, #204), with tag archive/design-system-superset-20260628 → f5c7411. The archive is inert: nothing builds from it, and generator/tests/unit/test_archive_inert.py enforces that. Its values are stale: primary #CC5C37 against today's #C05734, and DM Mono, which was dropped on 2026-09-11.

Deliverable

archive/design-system-superset-20260628/SALVAGE.md, delivered by PR. For each group, mark every item candidate / superseded / out of scope, with a one-line reason:

Group Compare against Expected call
tokens/*.css, themes/*.css dist/<product>/skin.css value-diff table; mostly superseded
guidelines/*.card.html (14: brand, colour, type, spacing, radius, motion cards) docs/brand-guide.html, dist/<product>/artifact.html candidates for brand-guide content
assets/icons (12), assets/illustrations (6) Brand/source/icons/ + udg/config/assets.yml candidate only if the provenance issue says hand-drawn; otherwise out of scope
components/{brand,display,feedback,forms,navigation} (ModeTag, SafetyBadge, StatusPill, Avatar, Badge, Card, Tag, Dialog, Tooltip, Button, Checkbox, IconButton, Input, Select, Switch, Tabs) components/ (the var(--*)-only bundle) candidates to port as var()-only CSS; the JSX itself is out of scope
ui_kits/*, _ds_bundle.js, themes/registry.js n/a out of scope (application code; repo rule)
SKILL.md, DESIGN-SYSTEM.md the CLAUDE.md aesthetic block mine for wording only

Done when

  • SALVAGE.md covers every file group above, and every item has a call and a reason.
  • The icons and illustrations section cites Keff's answer on the provenance issue. If there's no answer yet, that section is left "pending provenance".
  • No files outside SALVAGE.md change; just check and python -m pytest generator/tests/ pass.
  • Opened as a PR and not merged without review.
Inventory the recovered design-system superset against the live system, and decide what, if anything, is worth bringing back. **This is a review document only.** It makes no brand, token, logo or component changes; anything worth salvaging gets its own PR later, with Keff's and leadership's sign-off. ## Background The authored design system imported from the claude.ai Design project on 2026-06-28 was believed lost after the 2026-06-27 cut-over. It turned up as an unpushed local branch and is now on `main`, read-only, at `archive/design-system-superset-20260628/` (#202, #204), with tag `archive/design-system-superset-20260628` → `f5c7411`. The archive is inert: nothing builds from it, and `generator/tests/unit/test_archive_inert.py` enforces that. Its values are stale: primary `#CC5C37` against today's `#C05734`, and DM Mono, which was dropped on 2026-09-11. ## Deliverable `archive/design-system-superset-20260628/SALVAGE.md`, delivered by PR. For each group, mark every item **candidate / superseded / out of scope**, with a one-line reason: | Group | Compare against | Expected call | |---|---|---| | `tokens/*.css`, `themes/*.css` | `dist/<product>/skin.css` | value-diff table; mostly superseded | | `guidelines/*.card.html` (14: brand, colour, type, spacing, radius, motion cards) | `docs/brand-guide.html`, `dist/<product>/artifact.html` | candidates for brand-guide content | | `assets/icons` (12), `assets/illustrations` (6) | `Brand/source/icons/` + `udg/config/assets.yml` | **candidate only if the provenance issue says hand-drawn**; otherwise out of scope | | `components/{brand,display,feedback,forms,navigation}` (ModeTag, SafetyBadge, StatusPill, Avatar, Badge, Card, Tag, Dialog, Tooltip, Button, Checkbox, IconButton, Input, Select, Switch, Tabs) | `components/` (the `var(--*)`-only bundle) | candidates to port as `var()`-only CSS; the JSX itself is out of scope | | `ui_kits/*`, `_ds_bundle.js`, `themes/registry.js` | n/a | out of scope (application code; repo rule) | | `SKILL.md`, `DESIGN-SYSTEM.md` | the CLAUDE.md aesthetic block | mine for wording only | ## Done when - [ ] `SALVAGE.md` covers every file group above, and every item has a call and a reason. - [ ] The icons and illustrations section cites Keff's answer on the provenance issue. If there's no answer yet, that section is left "pending provenance". - [ ] No files outside `SALVAGE.md` change; `just check` and `python -m pytest generator/tests/` pass. - [ ] Opened as a PR and not merged without review.
Author
Owner

Wish: c8c945de. The icons and illustrations section waits on Keff's provenance answer in #207. Related: #202, #204 (the archive).

Wish: `c8c945de`. The icons and illustrations section waits on Keff's provenance answer in #207. Related: #202, #204 (the archive).
Author
Owner

Review is up in #209: archive/SALVAGE-design-system-superset-20260628.md. It sits beside the archived folder instead of inside it, so the folder stays a byte-exact copy of f5c7411. The icons and illustrations section is marked pending until #207 is answered. just check and all 343 generator tests pass. Not merged; it needs review.

Review is up in #209: `archive/SALVAGE-design-system-superset-20260628.md`. It sits beside the archived folder instead of inside it, so the folder stays a byte-exact copy of `f5c7411`. The icons and illustrations section is marked pending until #207 is answered. `just check` and all 343 generator tests pass. Not merged; it needs review.
Sign in to join this conversation.
No description provided.