From 21ba6f282b7f3063a63a877e921fb55c683f29e0 Mon Sep 17 00:00:00 2001 From: Claude Date: Thu, 3 Sep 2026 16:10:52 +0000 Subject: [PATCH] docs(qa): step 6 of the coverage sweep no longer sends the record to `runs/` SWEEP.md step 6 told every sweep agent to "land the run record under `runs/`". That directory is git-ignored (`*`, minus its README and .gitignore), so the instruction is unexecutable: `git add` on an ignored path is a near-silent no-op, and an agent that obeys the step believes it filed a record that does not exist. Two facts decide the replacement text, both measured rather than assumed: - `runs/README.md` and `RUNNER.md` name the destination for a run record -- one `qa-run` GitHub issue, text only, body contract in RUNNER.md. - A coverage sweep does not produce a run record at all. README.md splits the two skills: `checklist-author` authors items per SWEEP.md, `checklist-test` executes them and emits a run record per RUNNER.md. `checklist-author`'s own deliverables are the authored `areas/*.json` items, the reconciled `coverage.json` and the `FOLLOW-UPS.md` entries -- no record. Every one of the 20 most recent `qa-run` issues is an execution record whose title carries a build sha and PASS/PARTIAL/FAIL counts, none of which a sweep has. So step 6 now states the sweep's actual durable output and attributes the run record to `checklist-test`, pointing at both source docs by the names they use for themselves -- rather than sending a sweep to file a `qa-run` issue whose body contract it structurally cannot satisfy. Co-Authored-By: Claude Fable 5.1 Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox --- docs/qa/platform-checklist/SWEEP.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/qa/platform-checklist/SWEEP.md b/docs/qa/platform-checklist/SWEEP.md index d16ab60fab..cb0e461e11 100644 --- a/docs/qa/platform-checklist/SWEEP.md +++ b/docs/qa/platform-checklist/SWEEP.md @@ -62,9 +62,12 @@ single reader would not have covered. 5. **Reconcile `coverage.json` centrally** (a single writer): un-waive any kind a hunter proved has a stock fixture, map new items to their kinds, pin `enumSource` on any new variants matrix. -6. **Validate** `node scripts/check-platform-checklist.mjs` until green, then land the - run record under `runs/` and surface product defects / docs drift to the maintainer - in `FOLLOW-UPS.md`. +6. **Validate** `node scripts/check-platform-checklist.mjs` until green, then surface + product defects / docs drift to the maintainer in `FOLLOW-UPS.md` — with the authored + items and the reconciled `coverage.json`, that register is the sweep's whole durable + output. A sweep files **no run record**: that artifact belongs to `checklist-test`, + and it never lands under `runs/` (git-ignored) but as one `qa-run` GitHub issue — + [runs/README.md](./runs/README.md), body contract in [RUNNER.md](./RUNNER.md). ## Discipline that made the 2026-08 sweep trustworthy