Skip to content

docs: link maturity scorecard docs#91483

Merged
RomneyDa merged 1 commit into
mainfrom
dallin/maturity-test-docs
Jun 24, 2026
Merged

docs: link maturity scorecard docs#91483
RomneyDa merged 1 commit into
mainfrom
dallin/maturity-test-docs

Conversation

@RomneyDa

@RomneyDa RomneyDa commented Jun 8, 2026

Copy link
Copy Markdown
Member

What Problem This Solves

PR #91483 had drifted into maturity docs navigation that now conflicts with the generated maturity scorecard pages on main. This update keeps the useful scorecard cross-links and removes the stale /reference/maturity-tests route, top-tab navigation, and renderer-output change.

Why This Change Was Made

  • rebase the PR branch onto current main
  • keep the generated docs/maturity/scorecard.md and docs/maturity/taxonomy.md pages as the maturity docs reader path
  • remove the now-conflicting reference/maturity-tests page and all links to it
  • keep QA/testing docs pointed directly at the maturity scorecard
  • keep labeler ownership aligned with docs/maturity/**
  • point docs/AGENTS.md at the real maturity sources, generator script, local render/check commands, and GitHub Actions workflows that render or dispatch generated scorecard docs

User Impact

Docs readers get direct links to the maturity scorecard from QA and testing docs without a duplicate maturity explainer route. Agents editing docs get the right source files, generator command, and workflow owners for maturity scorecard changes. No runtime behavior, QA score values, taxonomy source data, generated maturity docs, or release evidence artifacts change in this PR.

Evidence

  • pnpm docs:list | rg -i 'maturity|AGENTS'
  • pnpm docs:check-mdx
  • git diff --check origin/main...HEAD
  • pnpm docs:check-links
  • pnpm docs:check-i18n-glossary
  • pnpm maturity:check
  • .agents/skills/autoreview/scripts/autoreview --mode branch --base origin/main

@openclaw-barnacle openclaw-barnacle Bot added docs Improvements or additions to documentation extensions: qa-lab size: XS maintainer Maintainer-authored PR labels Jun 8, 2026
@clawsweeper

clawsweeper Bot commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

Codex review: needs maintainer review before merge. Reviewed June 23, 2026, 9:52 PM ET / 01:52 UTC.

Summary
The PR adds maturity scorecard cross-links, docs editing guidance for generated maturity pages, and one labeler glob for docs/maturity ownership.

PR surface: Docs +11, Config +1. Total +12 across 4 files.

Reproducibility: not applicable. this is a docs and labeler metadata PR, not a user bug report. Source inspection confirms the new links target existing maturity pages and the new source-path guidance matches the renderer/workflow inputs.

Review metrics: 1 noteworthy metric.

  • Labeler ownership scope: 1 glob added. The PR changes future label automation by adding docs/maturity/** under the extensions: qa-lab label.

Merge readiness
Overall: 🐚 platinum hermit
Proof: 🌊 off-meta tidepool
Patch quality: 🐚 platinum hermit
Result: ready for maintainer review.

Overall follows the weaker of proof and patch quality, so missing proof can cap an otherwise strong patch.

Rank-up moves:

  • Confirm docs/maturity/** should carry the extensions: qa-lab label before marking the draft ready.

Risk before merge

  • [P1] Merging changes label-sync behavior: future docs/maturity/** changes will receive the extensions: qa-lab label, so maintainers should confirm that ownership signal is intentional.
  • [P1] This PR is still a draft and carries the protected maintainer label, so maintainer action is required before merge even though the branch is now clean.

Maintainer options:

  1. Confirm QA Lab Label Ownership
    Land as-is if maintainers want maturity docs changes to route through the extensions: qa-lab label and review path.
  2. Narrow The Labeler Mapping
    Before merge, move docs/maturity/** to a docs-only or release-docs label if qa-lab should not own generated maturity docs changes.

Next step before merge

  • [P2] No ClawSweeper work lane is recommended because the PR is maintainer-authored, draft, and protected-label; the remaining action is maintainer or author readiness, not automated repair.

Security
Cleared: Cleared: the diff only adds docs links, docs editing guidance, and one labeler glob; no dependency, secret, permission, or executable supply-chain change was found.

Review details

Best possible solution:

Keep this PR open for maintainer handling; if the qa-lab label ownership is intentional, the narrowed docs-link approach is the right layer to land once the draft is ready.

Do we have a high-confidence way to reproduce the issue?

Not applicable: this is a docs and labeler metadata PR, not a user bug report. Source inspection confirms the new links target existing maturity pages and the new source-path guidance matches the renderer/workflow inputs.

Is this the best way to solve the issue?

Yes: after the renderer/workflow landed separately, the narrow maintainable docs solution is to link the existing scorecard pages and document that generated maturity docs come from taxonomy.yaml and qa/maturity-scores.yaml.

AGENTS.md: found and applied where relevant.

Codex review notes: model internal, reasoning high; reviewed against da15cf48bf48.

Label changes

Label changes:

  • add rating: 🐚 platinum hermit: Overall readiness is 🐚 platinum hermit; proof is 🌊 off-meta tidepool and patch quality is 🐚 platinum hermit.
  • add status: 👀 ready for maintainer look: ClawSweeper has no concrete contributor-facing blocker left for this PR. Not applicable: Not applicable: this is a maintainer-authored docs/labeler PR, and the external-contributor real behavior proof gate does not apply.
  • remove rating: 🦪 silver shellfish: Current PR rating is rating: 🐚 platinum hermit, so this older rating label is no longer current.
  • remove status: ⏳ waiting on author: Current PR status label is status: 👀 ready for maintainer look.

Label justifications:

  • P3: This is low-priority docs and labeler-maintenance work with no runtime behavior change.
  • merge-risk: 🚨 automation: The diff changes labeler ownership so future maturity docs edits will be labeled as extensions: qa-lab work.
  • rating: 🐚 platinum hermit: Overall readiness is 🐚 platinum hermit; proof is 🌊 off-meta tidepool and patch quality is 🐚 platinum hermit.
  • status: 👀 ready for maintainer look: ClawSweeper has no concrete contributor-facing blocker left for this PR. Not applicable: Not applicable: this is a maintainer-authored docs/labeler PR, and the external-contributor real behavior proof gate does not apply.
Evidence reviewed

PR surface:

Docs +11, Config +1. Total +12 across 4 files.

View PR surface stats
Area Files Added Removed Net
Source 0 0 0 0
Tests 0 0 0 0
Docs 3 11 0 +11
Config 1 1 0 +1
Generated 0 0 0 0
Other 0 0 0 0
Total 4 12 0 +12

What I checked:

  • Repository policy read: Root AGENTS.md and docs/AGENTS.md were read fully; docs link rules and protected maintainer PR handling apply to this review. (AGENTS.md:1, da15cf48bf48)
  • Live PR state: GitHub reports this PR is open, draft, maintainer-labeled, and mergeable/clean at head 3674ec4. (3674ec478ebd)
  • Current narrowed diff: The PR currently changes only .github/labeler.yml, docs/AGENTS.md, docs/concepts/qa-e2e-automation.md, and docs/help/testing.md. (3674ec478ebd)
  • Target docs routes exist: Current main registers maturity/scorecard and maturity/taxonomy in docs/docs.json, so the new root-relative links point at existing pages. Public docs: docs/docs.json. (docs/docs.json:1863, da15cf48bf48)
  • Generated scorecard page exists: Current main has docs/maturity/scorecard.md with the Maturity scorecard page frontmatter and heading. Public docs: docs/maturity/scorecard.md. (docs/maturity/scorecard.md:1, da15cf48bf48)
  • Renderer source paths match PR guidance: Current main's renderer defaults to taxonomy.yaml and qa/maturity-scores.yaml, matching the PR's new docs editing guidance. (scripts/qa/render-maturity-docs.ts:30, da15cf48bf48)

Likely related people:

  • RomneyDa: Authored the current PR plus merged maturity scorecard renderer and claw-score skill PRs that this docs slice depends on. (role: recent maturity scorecard contributor; confidence: high; commits: 3674ec478ebd, 6e725ec1478b, 846591b55427; files: docs/AGENTS.md, docs/concepts/qa-e2e-automation.md, docs/help/testing.md)
  • kevinslin: Authored the merged taxonomy snapshot PR that introduced taxonomy.yaml and initial maturity score data used by the scorecard docs flow. (role: taxonomy source contributor; confidence: medium; commits: a54f50a41ba0; files: taxonomy.yaml, docs/maturity-scores.yaml)
What the crustacean ranks mean
  • 🦀 challenger crab: rare, exceptional readiness with strong proof, clean implementation, and convincing validation.
  • 🦞 diamond lobster: very strong readiness with only minor maintainer review expected.
  • 🐚 platinum hermit: good normal PR, likely mergeable with ordinary maintainer review.
  • 🦐 gold shrimp: useful signal, but proof or patch confidence is still limited.
  • 🦪 silver shellfish: thin signal; proof, validation, or implementation needs work.
  • 🧂 unranked krab: not merge-ready because proof is missing/unusable or there are serious correctness or safety concerns.
  • 🌊 off-meta tidepool: rating does not apply to this item.

Shiny media proof means a screenshot, video, or linked artifact directly shows the changed behavior. Runtime, network, CSP, and security claims still need visible diagnostics.

How this review workflow works
  • ClawSweeper keeps one durable marker-backed review comment per issue or PR.
  • Re-runs edit this comment so the latest verdict, findings, and automation markers stay together instead of adding duplicate bot comments.
  • A fresh review can be triggered by eligible @clawsweeper re-review comments, exact-item GitHub events, scheduled/background review runs, or manual workflow dispatch.
  • PR/issue authors and users with repository write access can comment @clawsweeper re-review or @clawsweeper re-run on an open PR or issue to request a fresh review only.
  • Maintainers can also comment @clawsweeper review to request a fresh review only.
  • Fresh-review commands do not start repair, autofix, rebase, CI repair, or automerge.
  • Maintainer-only repair and merge flows require explicit commands such as @clawsweeper autofix, @clawsweeper automerge, @clawsweeper fix ci, or @clawsweeper address review.
  • Maintainers can comment @clawsweeper explain to ask for more context, or @clawsweeper stop to stop active automation.

@RomneyDa
RomneyDa force-pushed the dallin/maturity-test-docs branch from 81658b5 to 75238ff Compare June 8, 2026 18:54
@clawsweeper clawsweeper Bot added rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. P3 Low-priority cleanup, docs, polish, ergonomics, or speculative work. merge-risk: 🚨 other 🚨 Merging this PR has meaningful risk outside the owned taxonomy. labels Jun 8, 2026
@RomneyDa
RomneyDa force-pushed the dallin/maturity-test-docs branch 6 times, most recently from c61d7d6 to b4deb0e Compare June 8, 2026 20:16
@clawsweeper clawsweeper Bot added rating: 🦐 gold shrimp Decent PR readiness signal, but merge confidence is limited. status: ⏳ waiting on author ClawSweeper has contributor-facing work open and is waiting for author action. and removed rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. labels Jun 8, 2026
@RomneyDa
RomneyDa force-pushed the dallin/maturity-test-docs branch 2 times, most recently from 0b541ec to 951802c Compare June 9, 2026 00:55
@RomneyDa
RomneyDa marked this pull request as draft June 10, 2026 07:51
@RomneyDa
RomneyDa force-pushed the dallin/maturity-test-docs branch from 951802c to 347ae15 Compare June 14, 2026 09:01
@clawsweeper clawsweeper Bot added rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. and removed rating: 🦐 gold shrimp Decent PR readiness signal, but merge confidence is limited. status: ⏳ waiting on author ClawSweeper has contributor-facing work open and is waiting for author action. merge-risk: 🚨 other 🚨 Merging this PR has meaningful risk outside the owned taxonomy. labels Jun 14, 2026
@RomneyDa RomneyDa changed the title docs: add maturity scorecard docs docs: add maturity docs routes Jun 23, 2026
@RomneyDa RomneyDa changed the title docs: add maturity docs routes docs: clarify maturity scorecard edit rules Jun 23, 2026
@RomneyDa
RomneyDa force-pushed the dallin/maturity-test-docs branch from 00e4019 to 97898a7 Compare June 23, 2026 01:37
@RomneyDa RomneyDa changed the title docs: clarify maturity scorecard edit rules docs: add maturity docs routes Jun 23, 2026
@RomneyDa
RomneyDa force-pushed the dallin/maturity-test-docs branch from 97898a7 to d151013 Compare June 23, 2026 02:09
@openclaw-barnacle openclaw-barnacle Bot added the scripts Repository scripts label Jun 23, 2026
@RomneyDa
RomneyDa force-pushed the dallin/maturity-test-docs branch 2 times, most recently from 7e4f53b to 0c4585c Compare June 23, 2026 08:15
@clawsweeper clawsweeper Bot added rating: 🦪 silver shellfish Thin PR readiness signal; proof, validation, or implementation needs work. merge-risk: 🚨 automation 🚨 May affect CI, automerge, proof capture, label sync, or maintainer automation. and removed rating: 🦐 gold shrimp Decent PR readiness signal, but merge confidence is limited. merge-risk: 🚨 other 🚨 Merging this PR has meaningful risk outside the owned taxonomy. labels Jun 23, 2026
@RomneyDa
RomneyDa force-pushed the dallin/maturity-test-docs branch from 0c4585c to 310edd6 Compare June 23, 2026 17:52
@RomneyDa RomneyDa changed the title docs: add maturity docs routes docs: link maturity scorecard docs Jun 23, 2026
@openclaw-barnacle openclaw-barnacle Bot removed the scripts Repository scripts label Jun 23, 2026
@RomneyDa
RomneyDa force-pushed the dallin/maturity-test-docs branch from 310edd6 to 3674ec4 Compare June 23, 2026 21:14
@clawsweeper clawsweeper Bot added rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. and removed rating: 🦪 silver shellfish Thin PR readiness signal; proof, validation, or implementation needs work. status: ⏳ waiting on author ClawSweeper has contributor-facing work open and is waiting for author action. labels Jun 24, 2026
@RomneyDa
RomneyDa marked this pull request as ready for review June 24, 2026 06:45
@RomneyDa
RomneyDa merged commit 4a503ed into main Jun 24, 2026
123 of 127 checks passed
@RomneyDa
RomneyDa deleted the dallin/maturity-test-docs branch June 24, 2026 06:59
github-actions Bot pushed a commit to Desicool/openclaw that referenced this pull request Jun 25, 2026
QiuYuang pushed a commit to QiuYuang/openclaw that referenced this pull request Jul 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to documentation extensions: qa-lab maintainer Maintainer-authored PR merge-risk: 🚨 automation 🚨 May affect CI, automerge, proof capture, label sync, or maintainer automation. P3 Low-priority cleanup, docs, polish, ergonomics, or speculative work. rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. size: XS status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants