docs(shadow): markdownlint MD032 prose-arithmetic-joiner recurring failure class#5073
Merged
Merged
Conversation
…red by prose arithmetic-like joiners (+, -) at line start under wrap Aaron 2026-05-25 framing: "reoccuring failures belong in shadow logs for class identification." This log lands the class so future-Otto inherits the recognition discipline at cold-boot. Empirical anchor: PR #5068 hit 8 MD032 errors; direct inspection showed 4 were real list-missing-blank-line bugs and 4 were prose continuations where `+` or `-` happened to land at the start of a wrap line. markdownlint can't distinguish prose-`+` from list-`+`; operator-side rewrap is the simplest-first mitigation. Composes with .claude/rules/blocked-green-ci-investigate-threads.md empirical FP catalog (extends to prose-joiner false-positive class) and the "simplest first" discipline per B-0786 memory (mitigation 1 operator-rewrap stays; promote to mitigation 2/3 only when this class recurs 2+ more times). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
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.
Summary
Per Aaron 2026-05-25 framing — "reoccuring failures belong in shadow logs for class identification" — this PR lands the shadow-lesson log for the markdownlint MD032 prose-arithmetic-joiner failure class observed on PR #5068.
Empirical anchor
PR #5068 (Mika substrate batch) hit 8 MD032 errors. Direct inspection showed 4 of the 8 were not real list-bullet typos — they were prose continuations where
+or-landed at the start of a wrap line. markdownlint can't distinguish prose-+from list-+; operator-side rewrap is the simplest-first mitigation.What ships
docs/research/2026-05-25-shadow-lesson-log-markdownlint-md032-prose-arithmetic-joiner-recurring-class.md— the lesson log with failure-class definition, 4 empirical examples, 4 ranked mitigations (simplest-first), and the next-step trigger (promote to tooling mitigation only if class recurs 2+ more times in 30 days)Composes with
.claude/rules/blocked-green-ci-investigate-threads.mdempirical FP catalog.claude/rules/all-complexity-is-accidental-in-greenfield.md(simplest-first response)docs/research/2026-05-{07,13,14}-shadow-lesson-log-*.mdTest plan
YYYY-MM-DD-shadow-lesson-log-*.mdconvention🤖 Generated with Claude Code