feat: ci-harper — grammar for prose, complementing typos for code#2
Merged
Conversation
harper-cli joins the shared lint gate: typos owns spelling (code identifiers, low-FP corrections), harper owns grammar (repetition, agreement, style) — so the wrapper ships with SpellCheck off (typos' job) and UseTitleCase off (heading case is a style choice). Repos append rules via HARPER_IGNORE; scope defaults to docs/ and kb/ (the prose homes), with explicit paths overriding. Exits non-zero via xargs when any file has findings. Heads-up for adopters: harper joins wrapped lines, so hand-wrapped markdown can trip false positives (a split word across a line break reads as one word) — repos with tightly wrapped design docs may want this advisory rather than gating. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Signed-off-by: Sebastian Hoß <seb@xn--ho-hia.de>
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
1 participant
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.
harper-cli joins the shared lint gate: typos owns spelling (code identifiers, low-FP corrections), harper owns grammar (repetition, agreement, style) — so the wrapper ships with SpellCheck off (typos' job) and UseTitleCase off (heading case is a style choice). Repos append rules via HARPER_IGNORE; scope defaults to docs/ and kb/ (the prose homes), with explicit paths overriding. Exits non-zero via xargs when any file has findings.
Heads-up for adopters: harper joins wrapped lines, so hand-wrapped markdown can trip false positives (a split word across a line break reads as one word) — repos with tightly wrapped design docs may want this advisory rather than gating.