Skip to content

Commit fddfc8d

Browse files
claude[bot]claude
andauthored
docs(qa): step 6 of the coverage sweep no longer sends the record to runs/ (#14983)
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. Claude-Session: https://claude.ai/code/session_019RfFHiRCSs3JXLK4cwcfox Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: claude[bot] <209825114+claude[bot]@users.noreply.github.com>
1 parent 5d4d55a commit fddfc8d

1 file changed

Lines changed: 6 additions & 3 deletions

File tree

docs/qa/platform-checklist/SWEEP.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -62,9 +62,12 @@ single reader would not have covered.
6262
5. **Reconcile `coverage.json` centrally** (a single writer): un-waive any kind a hunter
6363
proved has a stock fixture, map new items to their kinds, pin `enumSource` on any new
6464
variants matrix.
65-
6. **Validate** `node scripts/check-platform-checklist.mjs` until green, then land the
66-
run record under `runs/` and surface product defects / docs drift to the maintainer
67-
in `FOLLOW-UPS.md`.
65+
6. **Validate** `node scripts/check-platform-checklist.mjs` until green, then surface
66+
product defects / docs drift to the maintainer in `FOLLOW-UPS.md` — with the authored
67+
items and the reconciled `coverage.json`, that register is the sweep's whole durable
68+
output. A sweep files **no run record**: that artifact belongs to `checklist-test`,
69+
and it never lands under `runs/` (git-ignored) but as one `qa-run` GitHub issue —
70+
[runs/README.md](./runs/README.md), body contract in [RUNNER.md](./RUNNER.md).
6871

6972
## Discipline that made the 2026-08 sweep trustworthy
7073

0 commit comments

Comments
 (0)