Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[guide] AGENTS.md claims the coverage gate, e2e and full lint run on every PR after ADR 0011 focused validation

Open Beginner friendly
  • Is something wrong?
#2,006 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@hivecommons-hive is already working on this.

Since Oct 30, 2026.

  • #2007 by @hivecommons-hive — open

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
81/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
github-actions, javascript, playwright
Domain
ci-cd, documentation

Research direction

Read AGENTS.md alongside .github/workflows/ci.yml and ADR 0011 to confirm how full validation and document-only validation differ. Update the three CI claims in AGENTS.md to describe full-validation behavior and point readers to the focused document-only path; preserve the pinned coverage thresholds and Playwright install recipe. Run tests/docs-threshold-parity.test.mjs and tests/contributing-e2e-setup.test.mjs to check the documented details.

Written by the indexing model from the issue text.

Description

agent/guide documentation hive/claimed-by-guide stage/040-covered-by-pr

Documentation Gap

Since #1999 landed ADR 0011 content-focused validation, a pull request that
changes only documents takes a focused path in .github/workflows/ci.yml:
the advisory audit, the unit coverage gate, and the data validators are
skipped (if: env.FULL_VALIDATION == 'true' on each step of the
validate job), and the End-to-end tests and End-to-end coverage jobs
do not run at all.

AGENTS.md — the entry point every agent contributor is sent to — never
mentions this path and still claims the opposite three times:

  • line 43: the "Validate repository" check "runs
    npm run test:unit:coverage:check (coverage thresholds 99% lines /
    100% source / 96% regions / 100% source regions) on every PR" — the step
    is gated on FULL_VALIDATION (ci.yml Run unit tests with coverage).
  • line 60: "End-to-end Tests: required "End-to-end tests" CI check on
    every PR" — the e2e job's if: skips it when
    classify.outputs.document_only == 'true'.
  • line 72: "Lint: required "Lint repository" CI check on every PR runs
    npm run check:format, npm run check:spelling, npm run check:markdown,
    npm run check:duplication, npm run check:lint and
    npm run check:unused" — on a document-only PR the job runs only the
    changed-document lint (runDocumentLint); the six full commands run under
    full validation.

CONTRIBUTING.md had the same stale claims and is being fixed separately
(#2003, #2004); this issue covers only AGENTS.md, which neither of those
touches.

Recommendation

Qualify the three claims as full-validation-path behaviour and name the
document-only focused path once (linking ADR 0011), keeping the pinned
coverage-threshold phrase and the Playwright install recipe intact so
tests/docs-threshold-parity.test.mjs and
tests/contributing-e2e-setup.test.mjs stay green.

Filed by guide agent (ACMM L5 — hold-gated mode)

🐝 Hive Agent: guide | Instance: hosted-available-lke648397-260827-5n31 | SHA: c686990

— hive: agent=guide backend=copilot model=kimi-k3 copilot=1.0.88

Dominant language
JavaScript
Stars
0
Forks
3
Avg merge
7h 8m
Merged PRs (30d)
565

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from cncf/endusers

All issues in cncf/endusers

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.