Skip to content

docs(explainer,readme): the page says what Groundwork does, including the proof - #68

Merged
Tradebaas merged 1 commit into
mainfrom
docs/the-page-says-what-groundwork-does
Aug 1, 2026
Merged

docs(explainer,readme): the page says what Groundwork does, including the proof#68
Tradebaas merged 1 commit into
mainfrom
docs/the-page-says-what-groundwork-does

Conversation

@Tradebaas

Copy link
Copy Markdown
Owner

What changed and why

Both front doors were audited against the repo instead of against memory: all 21 skill cards
checked against each skill's own description:, the gate cards against the registry, plus the
six reason tabs, the lifecycle phases, the "what lives where" table and the requirements. Three
mismatches, all in the same direction of harm: the page claimed less than the framework does.

The copy route was missing entirely. Every push already unpacks a fresh copy, walks it to a
first guarded commit and throws it away again. That is the exact claim both documents open with,
and neither mentioned it in any wording, in the release where it shipped. It is a gate card now,
placed next to the self-test card whose logic it extends, and one sentence in the README beside
the same idea. Both are careful about what they promise: the build turns red on the commit that
broke the route. Neither says a merge is blocked, because drill is not a required status check
(gate and trace are).

code-review was wrong, not merely thin. The card said "two axes". True before the security
axis landed in PR #24, and it survived the rebuild that made this page English. It now names the
gate-weakening scan, the two always-on axes and the conditional security axis, which is the thing
a reader on the "Safe" tab is being promised elsewhere on the same page.

comply listed four regimes where the register carries nine. It now also names the product
and cyber security duties, and says the dates are verified against the official source.

Everything else matched: 21 cards for 21 skills, every named skill exists, the nine gate cards
describe real gates, and the three counts on the page are derived by explainer-stats rather
than typed.

Verified by

node checks/check.mjs green, and the page exercised in headless Chrome rather than read as
source:

  • 10 gate cards render (was 9), every icon path resolves, none empty
  • the new card sits between Self-test and And the rest, and the two-column grid lands on
    five even rows instead of four plus an orphan
  • 21 skill cards render; both corrected texts wrap inside their card without overflow
  • derived counts unchanged and still matching the repo: 21 skills, 21 checks, 19 decisions

Screenshot check was done on a scratch copy with the scroll-reveal forced visible and the
sections above hidden, because a static shot of the real file only captures the hero. The DOM
assertions above ran against the unmodified file.

Not verifiable here: how the section looks on a real phone. The grid collapses to one column
under 680px by an existing media query that this change does not touch.

… the proof

Audited both front doors against the repo rather than against memory: all 21 skill cards, the
gate cards, the six reason tabs, the lifecycle phases and the "what lives where" table. Three
things did not match, and the direction of the mismatch matters: two understated what is there,
and the third left out the strongest thing in v0.2.0 entirely.

The copy route was the omission. Every push already unpacks a fresh copy, walks it to a first
guarded commit and throws it away again, which is exactly the claim both documents open with,
and neither mentioned it in any wording. It is a gate card now, next to the self-test card whose
logic it extends, and one sentence in the README beside the same idea. Both say the build turns
red on the commit that broke the route, and neither says the merge is blocked, because the drill
is not a required status check: gate and trace are.

code-review was wrong, not merely thin. The card said "two axes", which was true before the
security axis landed and survived the rebuild that made this page English. It now names the
gate-weakening scan, the two always-on axes and the conditional security axis, which is the one a
reader on the Safe tab is being promised elsewhere on the same page. comply listed four regimes
where the register carries nine, so the card now names the product and cyber security duties too
and says the dates are verified against the source.

Verified in the rendered page, not in the source: ten gate cards, every icon resolving, the grid
landing on five even rows instead of four and an orphan, and both corrected skill cards wrapping
inside their card. Counts on the page are derived and unchanged: 21 skills, 21 checks, 19
decisions.

Traces-to: SC-11
@Tradebaas
Tradebaas merged commit b94ae5f into main Aug 1, 2026
6 checks passed
@Tradebaas
Tradebaas deleted the docs/the-page-says-what-groundwork-does branch August 1, 2026 14:22
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