Repository navigation
Add ADR 0008: scope agent findings to user-observable change - #1848
Conversation
The site is launched and stable, but the fleet opened 138 of the last 150 issues and 65 of the last 80 merged PRs touched only tests, scripts, workflows or root markdown. ADR 0006 and ADR 0007 each closed one series of findings and the agents moved to the next category. ADR 0008 states one remit in bright lines: an agent-filed issue or PR must name a user-observable defect, a security or supply-chain exposure, a required check failing, a data or dependency refresh, or maintainer-filed work. Metric-only changes are out of remit, the coverage, mutation and clone thresholds are frozen regression gates, decided questions are not re-filed, folded findings use Refs rather than Fixes, and planning checklists do not return to the tree. AGENTS.md and GOVERNANCE.md carry the same rules so the agents read them where they already look, and ADR 0007 gets a status note for the narrowing of its decision 3. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Signed-off-by: mrbobbytables <mrbobbytables@users.noreply.github.com>
✅ Deploy Preview for endusers ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Why this has been happeningA longer explanation of the mechanics behind the numbers in the ADR, for anyone (human or agent) reading this later and wondering why a launched, content-stable site produces fifteen issues a day. 1. Hive has no terminal stateHive is a scheduled scan-and-file loop. Each agent ( 2. The dominant agent measures things with no floor
3. Every fix became the next feedThe repository has responded to each series by adding a gate, and each gate became a new metric for the same agent to drive:
This is a ratchet by construction. The repository's own comments say so: 4. Scoping by category does not convergeADR 0006 narrowed test-only work (citation pins, listing reach, harness-of-harness tests). ADR 0007 narrowed browser-coverage findings. Both were read and honoured: the guide agent filed #1646 asking that GOVERNANCE.md be tightened per ADR 0006, and citation-pin findings stopped. But each ADR named the category it was closing, and the agents moved to the nearest category it did not name. ADR 0007 is the clearest example: it carried qualifiers ("unless there is surviving-mutant evidence", "integration-boundary evidence", "accepted regions"), and each qualifier was treated as a new area to explore (#1736, #1752, #1811). A remit written as policy-with-exceptions reads, to an agent, as a list of places where work is still permitted. That is why ADR 0008 is written as bright lines and names what is in remit rather than what is out. 5. Decisions do not persist across rewordingsHive's duplicate detection matches on text and file citations, not on the rule that was decided. The maintainer decision on #1669 (keep per-component CSS local, do not compose 6. Folding corrupts the issue graphWhen a new finding cites a file that an open agent issue already cites, Hive folds the new finding into that issue instead of opening another. The intent is fewer issues; the effect is issues whose title no longer describes their contents and PRs that close the wrong thing. #1829 is "ci.yml duplicates Playwright setup"; the static-asset symlink finding was folded into it because its evidence mentioned 7. Planning prose was a finding generator
8. What the numbers look like from the site's sideOf the 80 pull requests merged between 2026-10-17 and 2026-10-23, 65 changed only What this ADR can and cannot doIt can change what the agents read, which the ADR 0006 experience shows they do honour, and it can take the metrics off the table as objectives by naming them frozen. It cannot change the cadence, the autonomy level, or the folding behaviour. If agent-filed volume has not fallen materially by 2026-11-23, the next step is a request to the Hive maintainers with this ADR attached, asking for |
c574dc6
ℹ️ Sentinel notice — informational; author is trusted (owner), merge is not blockedHive flagged this PR (author @mrbobbytables, head
Hive did not add the |
Why
The site is launched and its content is stable, but the repository is not. In the ten days to 2026-10-23 the Hive fleet opened 138 of the last 150 issues (about 15 a day), and 65 of the 80 pull requests merged since 2026-10-17 changed only
tests/,scripts/,.github/or root markdown; one changeddocs/. ADR 0006 and ADR 0007 each closed one series of findings, and the fleet moved to the adjacent category each left open (mutants in the test harness, clones under the ceiling, re-filed CSS decisions, tracking issues for planning-doc bullets).What
adr/0008-scope-agent-findings-to-user-observable-change.mdstates one remit in bright lines, with no qualifiers on purpose (ADR 0007's qualifiers each became their own series and an amendment within two days):mainor fleet-wide, a data or dependency refresh through its existing lane, or maintainer-filed work.Refs, neverFixes, on its host issue ([architect] ci.yml duplicates Playwright setup across e2e and e2e-coverage jobs #1829 / test: fail on a symlink under static/ instead of skipping it #1839).AGENTS.mdandGOVERNANCE.mdcarry rules 1, 2, 4 and 5 in the same words, since those are the files the agents quote back. ADR 0007 gets a status note for the narrowing of its decision 3. No code or threshold values change; the gates already block regressions and the ratchets only move when a change that was in remit anyway removes clones.The ADR sets a 30-day checkpoint (2026-11-23). If agent-filed volume has not fallen materially, the remaining lever is the Hive configuration (schedule, autonomy level, folding), which lives outside this repository.
Verification
npm run test:unit:coverage:checkgreen (ADR contract, markdown reference and governance parity tests included).prettier,cspellandmarkdownlint-cli2clean on the five changed files.Governance change per
GOVERNANCE.md, so this takes the independent-review path rather than the low-risk one.Refs #1788, #1718.