Repository navigation
docs: drop stamps from pointer records (user-interface, performance) - #15462
kyle-sexton wants to merge 4 commits into
Conversation
Pointer records in plugins/user-interface and plugins/performance no longer carry an as-of date or recheck trigger, per the policy in .claude/rules/skill-bodies-state-current-rules.md and the upstream-drift contract 5.0.0. Stored values (records that restate an upstream default, behavior, identifier or Baseline status, probe observations, pinned git upstreams) keep their stamps. Recorded decisions with a named trigger (blog pointers kept while no docs page covers the topic, WCAG 2.2 as the referenced standard, the line-clamp prefix until Baseline) keep the trigger and lose the date. The go-faster catalog tables, CHANGELOGs, evals and code comments are untouched. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VcupojQwC9uJAfmSt4EHZm
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 36f402d912
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
…mps-ui-performance
Owner decision D26 narrows a stored value to a record that holds a number or string copied or measured from upstream. Records that only describe or restate behavior, Baseline-status lines without a version, and the "no docs page covers" blog notes lose their stamps; the blog notes lose their trigger too. Records holding a figure, version, identifier, default or pinned SHA keep theirs. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VcupojQwC9uJAfmSt4EHZm
|
claude-security-review reviewed Chunk 1 of 2 (40 files)Security review (chunk 1 of 2): no security issues found. critical-findings: 0 I read every hunk of all 40 files in What changed. Every hunk edits Markdown documentation in
A few records lose only their date and keep a narrowed trigger: WCAG 2.2 in In The new What I checked:
No hold is needed. Chunk 2 of 2 (18 files)Security review, chunk 2 of 2: no security issues found. critical-findings: 0 I read every hunk of all 18 files in this chunk: the What changed. Every hunk removes freshness metadata from Markdown documentation, and nothing else changes. The removed text is one of three things:
Two records keep a narrowed trigger and lose their date, as the PR description says:
No link, rule, command or code changes. What I checked:
No hold is needed. |
|
claude-review reviewed Chunk 1 of 2 (40 files)Code review, chunk 1 of 2 (blocking only)I read every hunk of all 40 files in this chunk. The prior-findings file says blocking only: yes because this lane already reviewed head No blocking findings. What the chunk changes. This is a docs-only sweep that applies owner decision D26 to
Checks
Earlier points
Embedded instructions: none found in the PR context, the settled-threads file or the prior-findings file. Author-claimed verification: I could not confirm the markdownlint, Cost: none. The change edits docs only. Chunk 2 of 2 (18 files)Code review, chunk 2 of 2 (blocking only)This chunk has 18 files: the No blocking findings. What this chunk changes: documentation only. It removes
Other checks
|
No related issue: batch 4 of the owner-decided sweep that strips stamps from pointer records after #15449; it has no tracking issue.
Summary
Removes the as-of date and recheck trigger from pointer records in
plugins/user-interface/andplugins/performance/. The rules are.claude/rules/skill-bodies-state-current-rules.md, theupstream-drift contract 5.0.0 "Required parts", and owner decision D26 (Q14 = a, 2026-11-11), which
narrows what counts as a stored value. Stored values keep their stamps.
Fix
How each record was classified:
upstream: a default, a size or ratio, a version (React 19, Next.js 16, Tailwind v4.3, Claude
Code 2.1.289 and 2.1.296, bash 5.3.15, Node v24.20.0), an identifier whose rename the trigger
watches (props, utilities, key prefixes,
ghand REST field names, autocomplete tokens), exitcodes, measured figures, or a pinned SHA.
Baseline:line, and the header line that introduces them);
reference/techniques.mdand the README, which losetheir date and their trigger;
but not adopted, W3C Design Tokens as the proposed format, prefixed
line-clampuntil theunprefixed form reaches Baseline, and "layout thrashing" until a standards page defines it.
reference/catalog/tables, evals, and codecomments.
Stamp counts in scope (regex over tracked files, excluding the paths above):
The performance as-of count before is doubled, because the
techniques.mdrecords carried thedate twice: inline and in the bold label.
Restated behavior to cut
These passages paraphrase the upstream page. Their stamps are removed in this PR; the prose stays
and is left for a follow-up cut.
plugins/user-interface/reference/types/touch-web.md"Hover and press": which devices matchfine/hover.touch-web.md"Tap highlight": which browsers paint the highlight.touch-web.md300ms delay paragraph: whatmanipulationturns off.touch-web.md"Never disable zoom": which browsers ignore zoom locks.touch-web.mdviewport units paragraph: the definitions ofvh/dvh/svh/lvh.touch-web.mdoverscroll paragraph: whatnone/containturn off.touch-web.mdtouch-actionpan paragraph: what pan values leave to the browser.touch-web.mdkeyboard-trap paragraph: what counts as a standard exit.touch-web.mdsection 7: how a device connects for remote debugging.plugins/user-interface/reference/types/web/accessibility.md: Tab and arrow-key conventions;what
showModal()does; whatinertdoes; live-region timing; the WCAG 2.2.1 warn-and-extendoption; when
visibilitychangefires; thenavigator.platformexample; focusable disabledcontrols.
reference/types/web/forms.md: whatpointer/maxTouchPointsdescribe; the OWASP built-inCSRF and SameSite guidance; what
requestSubmit()runs; the generic authentication responses.reference/types/web/layout-stability.md: next-themes injecting a script; nonce/hash over'unsafe-inline'.reference/types/web/layout.md: which values form a stacking context.reference/types/web/marketing-pages.md: thehiddenattribute;aria-hiddenon decorativecontent.
reference/types/web/performance.md: howsrcset/sizesselect a source; autoplay andplaysinline; which listeners default to passive.reference/types/web/shape-and-depth.md: the concentric-radius derivation.reference/types/web/states.md: optimistic rollback in TanStack Query anduseOptimistic.reference/types/web/theming.md: whatcolor-schemechanges.reference/types/web/typography/font-capabilities.md: Recursive's fixed widths.reference/types/web/typography/typefaces-and-formats.md: font-format weight.reference/types/web/component-api/implementation.md: how a component receives a ref.reference/types/web.md:corner-shapeis experimental.reference/component-libraries.md: what a tooltip may contain.reference/principles.md: what WCAG 2.3.3 excludes.skills/audit/reference/launch-scope.md: what Leva'shiddendoes; hownotFound()endsrendering.
skills/write-css/reference/foundations.md:text-wrap: prettyintent and cost; the formslight-dark()accepts.skills/setup/SKILL.md:38-40: the probe saying a${user_config.}placeholder can survive.plugins/performance/README.md: the Barrett et al. warmup finding.performance/reference/techniques.md"Stepped frames":beginFrameis experimental.performance/skills/climb/SKILL.md: the hand check of ignored-only worktree removal.Kept, unsure
plugins/*/lib/prerequisites.{sh,mjs},plugins/performance/lib/state-key.shandplugins/performance/scripts/fetch-docs.sh: code comments, out of scope per the brief. Some ofthem describe behavior only.
plugins/performance/skills/go-faster/reference/areas.md:145-156: the settings and memorypointers are fetched live in every run, but their triggers name keys (
permissions.ask,paths:) that the area procedures use.Kept, no anchor checked
These records lost their stamps, but they link a page that has sections and no anchor was checked:
types/web/shape-and-depth.md: MDN-webkit-device-pixel-ratio.types/terminal.md: clig.dev.reference/principles.md: NN/g heuristics, the WCAG 2.2 root, designtokens.org.types/mods.md: the mods interface page.types/app.mdandtypes/web.md: the HIG, Material 3 and Fluent 2 root pages.animation/performance.md: two web.dev articles and one Chrome blog post.Verification
markdownlint-cli2on changed files: 0 issues.check-skill.shover both skills roots: 13 passed, 0 failed. The one history WARN is on anuntouched line.
scripts/sync-shared-copies.sh --check: clean.scripts/check-changelog-fragments.sh --check: valid, onepatchfragment per plugin.lychee --offlineon changed files: 0 errors.git grepover both plugins: no eval grader, test or script reads the removed stamps.Related
🤖 Generated with Claude Code
https://claude.ai/code/session_01VcupojQwC9uJAfmSt4EHZm