Repository navigation
Closed
Copy link
Labels
agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.Fully specified and briefed; eligible for autonomous pickup from the frontier.priority: mediumReal value, no hard deadline; normal backlog flow.Real value, no hard deadline; normal backlog flow.status: readyTriaged, unblocked, and fully specified; eligible to pick up.Triaged, unblocked, and fully specified; eligible to pick up.work-class: scopedA briefed fix or small feature; blast radius bounded by the brief, tests exist.A briefed fix or small feature; blast radius bounded by the brief, tests exist.
Description
Parent #7591 decides that "/docs-hygiene:write-for-humans grounding rule only if an eval shows the gap" (Q526), and its done-when needs the write-for-humans eval slice to carry a Probe result: comment, but that slice was never filed (comment 6556369883); this slice authors the eval cases and slice S3 runs them on a host. The rule under test, from the accepted Q526 list, is "introduce each concept before a sentence relies on it, or name it as assumed reader knowledge", and plugins/docs-hygiene/skills/write-for-humans/ has no such rule on main.
Done when
-
plugins/docs-hygiene/evals/gains at least twowfh-grounding-*cases. Each case hascase.yaml,prompt.md,graders/skill-fired.md(same form aswfh-tutorial-is-reference/graders/skill-fired.md) and a grounding grader. - Each grader has a
samples/<grader-name>.jsonwith at least onepassand onefailentry (same shape aswfh-tutorial-is-reference/samples/skill-fired.json). - Each prompt asks for a human-facing document (README, design doc or how-to) from source material that uses at least one domain term before it defines it.
- The grounding grader is
type: llm. Its text says PASS only when every such term is introduced before a sentence relies on it or is named as assumed reader knowledge, and FAIL otherwise. - Each
case.yamlsetsruns: 3or more. - The diff edits neither
plugins/docs-hygiene/skills/write-for-humans/SKILL.mdnorreference/sentence-rules.md: the rule ships only if S3 shows the gap. - A
.changes/docs-hygiene/*.mdfragment withbump: nonedescribes the new cases. - The PR's CI is green.
Out of scope
- Writing the grounding rule.
- Running the eval (slice S3).
Parent: #7591
Metadata
Metadata
Assignees
Labels
agent-readyFully specified and briefed; eligible for autonomous pickup from the frontier.Fully specified and briefed; eligible for autonomous pickup from the frontier.priority: mediumReal value, no hard deadline; normal backlog flow.Real value, no hard deadline; normal backlog flow.status: readyTriaged, unblocked, and fully specified; eligible to pick up.Triaged, unblocked, and fully specified; eligible to pick up.work-class: scopedA briefed fix or small feature; blast radius bounded by the brief, tests exist.A briefed fix or small feature; blast radius bounded by the brief, tests exist.
Type
Fields
No fields configured for Task.
Activity
github-actions commentedon Nov 1, 2026