docs: add re-scope-after-a-regression rule to task-writing.md - #226
Merged
Merged
Conversation
bborbe
marked this pull request as ready for review
September 27, 2026 12:14
There was a problem hiding this comment.
The review is complete. This is a clean docs-only PR with no issues.
Summary: A docs-only PR adding a well-reasoned "re-scope after a regression, never patch" rule to task-writing.md § Audit. The section is correctly placed as a sub-section under Audit, grounded in empirical evidence (two observed cycling rows of 14 and 5 rounds), and clearly distinguishes the rule from rejected alternatives (clause budget, delete-symmetry). Version alignment is verified across all four required files.
{
"verdict": "approve",
"summary": "Docs-only PR adds a well-integrated 're-scope after a regression' rule to task-writing.md § Audit, with empirical grounding and clear rejection of alternatives. Version alignment verified across all four required files. No concerns.",
"comments": [],
"concerns_addressed": []
}
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a rule to
docs/task-writing.md§ Audit: re-scope after a regression, never patch.A criterion that has reached a passing verdict and then regresses is re-scoped or cut, not repaired again. The trigger is the first regression after a held verdict; the action is to cut the criterion back to what the evidence can carry, or replace the claim with one the artifact supports — never to add a clause narrowing the failing one.
Why
Measured on two independent task rows in one manager session (2026-09-26) that cycled 14 and 5 audit rounds without converging. Neither reached the 9/10 bar, and both were ended by a re-scope, not by a successful patch.
The rejected alternatives are recorded in the section, each with the failure it would produce:
Hence a regression after a held verdict rather than a count. Checked against both rows before shipping: it fires at round 10 of 14 in the first — four rounds before the re-scope that actually ended it — and at the last round of 5 in the second, where it ratifies rather than accelerates.
Verification
make precommitgreen — all 8 Go packages ok, scenario suites 0 failed, golangci-lint 0 issues, CHANGELOG structure OK.