Cut the fourth restatement of the hero and name the payoff once - #357
Merged
Conversation
CommitLore — record lintTrailers: clean — 1 commit in Active constraints for the paths this PR touchesLimits (42)
Ruled out (95)
Warnings (24)
Trailer violations fail this check. Active constraints are informational — they are what the repository already decided, not a verdict on this PR. |
The hero runs promise, category, mechanism -- and then said the mechanism a second time, in the paragraph the previous positioning left behind. Three consecutive paragraphs made the same claim: "surfaces only the decisions still in force", then "tracks which decisions are still in force and which have been reversed", then "sees only current decisions when it queries a path". A reader who understood the first one had to read two more to find out they were the same sentence. In README.ko.md the leftover also broke voice. The hero above it is 존댓말 and the restatement was 해라체, so the register changed mid-hero for no reason a reader could see. Nothing is added to replace it. What the hero was missing is not another description of the mechanism but the ask, so the install block now closes with one: give the next agent the judgment the last one earned. That is the only new line in the file. The scene that shows the rejected reuse was titled "See the difference", which names a comparison rather than what the scene is about. It now states the loss. "Stop re-reviewing the same bad idea" stays underneath it, where a claim that specific is safe to make -- it is a bad hero, because it implies a verdict `guard` cannot deliver at 22% recall, but it is an accurate caption for a scene that shows exactly that one case. Record-Id: r-heropolish Limit: README.ko.md still switches from 존댓말 to 해라체 below the hero; that split is older than this change and belongs to the restructure in #344 Ruled-out: Hero nav links to install, demo and how-it-works | there is no install heading to anchor against, and minting one is a restructure, not a copy change Ruled-out: Moving the pain line back out of the demo | it was tried as the hero and moved here on purpose, and readme-order.test.ts records why Certainty: firm Blast: local Undo: easy Verified: readme, readme-order, readme-numbers, readme-positioning and compatibility-matrix pass at 83; check-readme-numbers.mjs exits 0 with the BENCH block byte-identical at 39 lines and 2262 bytes; the four positioning assertions still resolve, through the hero image alt text rather than the deleted paragraph Unverified: how the new heading reads to someone who arrives from a shared link and sees it before the hero
MongLong0214
force-pushed
the
docs-judgment-copy
branch
from
August 1, 2026 04:08
e359186 to
f6144bc
Compare
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.
An external positioning review of the v0.5.0 README argued that the hero should sell engineering-judgment inheritance rather than a review-convenience feature. That hero was already applied. What the review surfaced that was not applied is the redundancy it left behind, and the missing ask.
Changed
**Git-native decision authority for AI-assisted codebases.** …restated the mechanism paragraph directly above it. Three consecutive paragraphs claimed the same thing. InREADME.ko.mdthe leftover was also 해라체 against a 존댓말 hero.All three applied to
README.md,README.ko.md,README.ja.md,README.zh-CN.md.Audited, no change needed
The review's list of copy the product cannot honestly make — "never let agents make the same mistake twice", "eliminate architectural regressions", "save tokens and review time", "the memory your AI never forgets" — none appear. Guard precision 44.8% / recall 22.0% remain disclosed with their Wilson CI in Known limitations.
Verified
readme,readme-order,readme-numbers,readme-positioning,compatibility-matrix— 83 tests passscripts/check-readme-numbers.mjsexit 0, BENCH block byte-identical (39 lines, 2262 bytes)readme-positioningauthority assertions still resolve — through the hero image alt text, not the deleted paragraph