Skip to content

refactor(design-docs): dissolve product/ into ui/ — visible-surface records (RIG-2577 T8) - #824

Closed
rigel-mintaka wants to merge 1 commit into
compass-repo/rig-2577-t8-serverfrom
compass-repo/rig-2577-t8-ui
Closed

refactor(design-docs): dissolve product/ into ui/ — visible-surface records (RIG-2577 T8)#824
rigel-mintaka wants to merge 1 commit into
compass-repo/rig-2577-t8-serverfrom
compass-repo/rig-2577-t8-ui

Conversation

@rigel-mintaka

@rigel-mintaka rigel-mintaka commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

This PR is part of a stack containing 4 PRs:

  1. main
  2. refactor(design-docs): dissolve product/ into meta/ — process/method records (RIG-2577 T8) #820
  3. refactor(design-docs): dissolve product/ into agent/ — agent behavior & lifecycle records (RIG-2577 T8) #821
  4. refactor(design-docs): dissolve product/ into server/ — server domain-model & write-path records (RIG-2577 T8) #823
  5. "refactor(design-docs): dissolve product/ into ui/ — visible-surface records (RIG-2577 T8)" (this PR)

Move the product's visible-surface records (shell, board, sidebar, keyboard,
rendering, design system) out of the dissolving product/ bucket into the ruled
top-level ui/ bucket (RIG-2577 §Approach 2). 26 records: the frozen roster's 24
ui-block records (minus the native family, deferred — see below) plus the 2
post-freeze drift records Matt ratified into ui/ on 2026-08-31
(compass-coaching-tooltips, compass-leader-chords).

DEFERRED to T10 (per RIG-2577 §T8/T10 + Matt's 2026-08-31 ratification): the
native-app family stays under the transitional product/ root while it settles —
compass-native-app, compass-native-client-mode, compass-native-client-only,
compass-native-packaging, compass-tauri-shell.md, compass-multi-window,
compass-stack-cross-process-teardown, and compass-gtk4-migration. After this PR,
product/ holds exactly these 8 records.

ui/ is already a governed root; records stay governed across the move, no Status
normalization needed.

Same-PR link integrity (RIG-2577 Global Constraints):

  • DECISIONS.md Record cells re-pointed product// -> ui// (284 rows
    unchanged; pure relocation, no decision changed). Deferred-native cells stay
    product/-qualified (they didn't move) — still governed.
  • Cross-bucket body links: server/compass-zulip-threading-model's 2 outbound
    links to now-ui records (threading-ui, slack-thread-rendering) re-pointed to
    ../../ui/.
  • External citation sweep: gate test fixtures (design-ledger-gate, sea-ref-gate),
    BadgeGlyph.test.tsx comment, and inter-record prose re-pointed to ui/.

Verified: design-ledger-gate OK (284 rows, 120 headers); eng-docs gather 73/73;
gate-suite tests 81/81 + 22/22; BadgeGlyph 17/17 (--conditions browser); deferred
native records intact + still governed; no dangling product/ refs to moved records.

Ledger-impact: records relocated within governance, no decision changed

Co-authored-by: Matt Wilkinson matt@rigel.build

…ecords (RIG-2577 T8)

Move the product's visible-surface records (shell, board, sidebar, keyboard,
rendering, design system) out of the dissolving product/ bucket into the ruled
top-level ui/ bucket (RIG-2577 §Approach 2). 26 records: the frozen roster's 24
ui-block records (minus the native family, deferred — see below) plus the 2
post-freeze drift records Matt ratified into ui/ on 2026-08-31
(compass-coaching-tooltips, compass-leader-chords).

DEFERRED to T10 (per RIG-2577 §T8/T10 + Matt's 2026-08-31 ratification): the
native-app family stays under the transitional product/ root while it settles —
compass-native-app, compass-native-client-mode, compass-native-client-only,
compass-native-packaging, compass-tauri-shell.md, compass-multi-window,
compass-stack-cross-process-teardown, and compass-gtk4-migration. After this PR,
product/ holds exactly these 8 records.

ui/ is already a governed root; records stay governed across the move, no Status
normalization needed.

Same-PR link integrity (RIG-2577 Global Constraints):
- DECISIONS.md Record cells re-pointed product/<r>/ -> ui/<r>/ (284 rows
  unchanged; pure relocation, no decision changed). Deferred-native cells stay
  product/-qualified (they didn't move) — still governed.
- Cross-bucket body links: server/compass-zulip-threading-model's 2 outbound
  links to now-ui records (threading-ui, slack-thread-rendering) re-pointed to
  ../../ui/.
- External citation sweep: gate test fixtures (design-ledger-gate, sea-ref-gate),
  BadgeGlyph.test.tsx comment, and inter-record prose re-pointed to ui/.

Verified: design-ledger-gate OK (284 rows, 120 headers); eng-docs gather 73/73;
gate-suite tests 81/81 + 22/22; BadgeGlyph 17/17 (--conditions browser); deferred
native records intact + still governed; no dangling product/ refs to moved records.

Ledger-impact: records relocated within governance, no decision changed

Co-authored-by: Matt Wilkinson <matt@rigel.build>
@linear-code

linear-code Bot commented Aug 31, 2026

Copy link
Copy Markdown

RIG-2577

@github-actions

Copy link
Copy Markdown

Compass engineering docs preview: https://compass-repo-rig-2577-t8-ui.compass-eng-docs.pages.dev

Deployed from compass-repo/rig-2577-t8-ui at 685f7a9.

Changed pages:

@rigel-mintaka

Copy link
Copy Markdown
Contributor Author

Superseded by #825 — the T8 product/-dissolution work (agent/ + server/ + ui/) collapsed into a single PR per Matt's request (meta/ landed as #820). #825 carries the same moves plus the four link/citation stragglers a review pass surfaced. Closing.

@rigel-mintaka
rigel-mintaka deleted the compass-repo/rig-2577-t8-ui branch September 1, 2026 00:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant