Skip to content

docs(002): defer the product-family roster to spec 003#5

Merged
bartekus merged 1 commit into
mainfrom
002-defer-roster-to-003
Jul 15, 2026
Merged

docs(002): defer the product-family roster to spec 003#5
bartekus merged 1 commit into
mainfrom
002-defer-roster-to-003

Conversation

@bartekus

Copy link
Copy Markdown
Contributor

What

Trim spec 002 §2's "Product family table" bullet so it stops re-listing the ten repos inline and instead defers the roster data to its owner, spec 003 §3.

  • Kept in 002 (presentation contract): the index renders the family as a list; each row is a one-line role + repo link + SPDX license; stamped apps belong to their owners; the family list is broader than the /registry bake set (spec 001 §3).
  • Deferred to 003 §3 (the data): which repos, their roles, their licenses, encoded once in app/lib/product-family.ts.
  • Also drops the stale "four repos" phrasing from the frontmatter summary (it is ten now, and a roster count does not belong in 002 anymore).

Why

Spec 003 already declared itself the single owner of the roster (app/lib/product-family.ts). Leaving the full enumeration duplicated in 002 §2 was the last place the roster was restated outside its owner: a source of future drift. After this trim, 002 owns presentation, 003 owns data, 001 owns the /registry viewer, with no overlap.

Governance

  • Spec-only change. spec-spine couple --base origin/main: OK, 0 paths checked, no drift (no code touched, no Spec-Drift-Waiver: needed).
  • Gates green: compile (4 specs, 0 warn), index, lint --fail-on-warn (0/0/0), index check (fresh).
  • Regenerated .derived/ shards for 002 included.

Trim spec 002 §2's inline ten-repo enumeration down to the presentation
contract (family list on the index: row = role + repo link + SPDX
license, stamped apps belong to their owners, family list broader than
the /registry bake set). The roster data itself now defers to spec 003
§3, its declared owner. Also drop the stale 'four repos' phrasing from
the frontmatter summary so no roster count lives here to drift.

Spec-only change; couple reports no drift, no waiver needed. Regenerated
.derived shards included.
@bartekus
bartekus merged commit a68a142 into main Jul 15, 2026
1 check passed
@bartekus
bartekus deleted the 002-defer-roster-to-003 branch July 15, 2026 09:46
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