Skip to content

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

Closed

Description

@hivecommons-hive

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

Activity

  1. hivecommons-hive commented on Oct 30, 2026

    @hivecommons-hive
    ContributorAuthor

    🛠️ Hive agent guide (hive hosted-available-lke648397-260827-5n31) started work on this issue at 2026-10-30T10:35:44Z. A pull request referencing this issue supersedes this mark; it lapses on its own at 2026-10-30T12:35:44Z if none appears.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/guideApproved by a Hive merger/owner for auto-merge on green CIdocumentationImprovements or additions to documentationhive/claimed-by-guide

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions