Recorded from the skills-optimization flight #14317 (internal-small member card). Unassigned — recording only, for triage. ⛔ Not touched by that flight: its file surface is the four internal SKILL.md files plus objectui's verify, and this defect is in a doc that flight treats as a binding anchor it must not edit.
What
docs/qa/platform-checklist/SWEEP.md step 6 says, verbatim:
Validatenode 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.
But docs/qa/platform-checklist/runs/.gitignore is *, and runs/README.md is titled so that the directory's own documentation says results are NOT committed. So the instruction directs an agent to commit a file into a directory whose contents git is configured to ignore.
Why it matters more than it looks
checklist-author is the skill that dispatches sweep agents, and it routes them to SWEEP.md as the normative method — so this is not a stale line in a doc nobody reads, it is a step in a live agent runbook. The failure is quiet in the bad direction: git add on an ignored path is a no-op with a non-obvious message, so a sweep agent that follows step 6 believes it landed the record and the record does not exist.
Two readings, both need the maintainer, not a dev's guess
- The
runs/ convention changed (records are session artifacts, deliberately uncommitted) and step 6 was never updated — fix is to correct step 6 and say where a run record actually goes. - Run records ARE meant to be committed and the ignore rule is the defect — fix is in the
.gitignore, and the README title is then also wrong.
The two point at opposite files, which is why this is filed rather than fixed in passing.
Verified at origin/mainaaa4e657
docs/qa/platform-checklist/runs/.gitignore = *docs/qa/platform-checklist/SWEEP.md still carries the step-6 sentence abovenode scripts/check-platform-checklist.mjs is green today (15 areas, 260 items, 0 waived) — nothing mechanical catches this, which is consistent with the instruction being unexecutable rather than violated
Refs: #14317 (the flight that measured it; ⛔ out of its scope by construction)
Recorded from the skills-optimization flight #14317 (internal-small member card). Unassigned — recording only, for triage. ⛔ Not touched by that flight: its file surface is the four internal SKILL.md files plus objectui's
verify, and this defect is in a doc that flight treats as a binding anchor it must not edit.What
docs/qa/platform-checklist/SWEEP.mdstep 6 says, verbatim:But
docs/qa/platform-checklist/runs/.gitignoreis*, andruns/README.mdis titled so that the directory's own documentation says results are NOT committed. So the instruction directs an agent to commit a file into a directory whose contents git is configured to ignore.Why it matters more than it looks
checklist-authoris the skill that dispatches sweep agents, and it routes them to SWEEP.md as the normative method — so this is not a stale line in a doc nobody reads, it is a step in a live agent runbook. The failure is quiet in the bad direction:git addon an ignored path is a no-op with a non-obvious message, so a sweep agent that follows step 6 believes it landed the record and the record does not exist.Two readings, both need the maintainer, not a dev's guess
runs/convention changed (records are session artifacts, deliberately uncommitted) and step 6 was never updated — fix is to correct step 6 and say where a run record actually goes..gitignore, and the README title is then also wrong.The two point at opposite files, which is why this is filed rather than fixed in passing.
Verified at
origin/mainaaa4e657docs/qa/platform-checklist/runs/.gitignore=*docs/qa/platform-checklist/SWEEP.mdstill carries the step-6 sentence abovenode scripts/check-platform-checklist.mjsis green today (15 areas, 260 items,0 waived) — nothing mechanical catches this, which is consistent with the instruction being unexecutable rather than violatedRefs: #14317 (the flight that measured it; ⛔ out of its scope by construction)