Conversation
Promote the 'CommonMark MD032 — line-leading + / - parsed as list marker' pattern to a named recurring-findings class in _patterns.md after 5 instances in a single tick (2026-04-25): - #377: '+ manifest files' continuation line - #280: '+ provenance-aware scoring' continuation - #195: '+ Kenji (Architect)' owner-list continuation - #235: '+ git history' (Amara verbatim ferry) - #219: '- [link]' (Amara verbatim ferry) Document the two-branch fix decision tree: - Author-controlled prose → reflow inline (replace '+'-separator with comma, extend prior line, etc). - Verbatim ferry / courier content (Otto-227) → add to markdownlint ignore list (precedent: docs/aurora/** in #469, docs/amara-full-conversation/**). Composes with Class A inline-code-span line-wrap (same shape: line-wrap hits a CommonMark special character at line start). Pre-commit-lint candidate noted for the doc-lint suite from #465.
There was a problem hiding this comment.
Pull request overview
Promotes the recurring markdownlint MD032 “line-leading list marker after a wrap” issue into a named pattern entry in docs/pr-preservation/_patterns.md, documenting both author-controlled and verbatim-preservation fix paths.
Changes:
- Adds a new recurring-findings entry documenting MD032-triggering line-wraps that start with
+/-/*/1.. - Captures a decision tree distinguishing author-editable prose vs Otto-227 verbatim ferry content.
- Notes a potential pre-commit lint direction for preventing recurrences.
AceHack
added a commit
that referenced
this pull request
Apr 25, 2026
- L139: 'CommonMark MD032' → 'markdownlint MD032' (MD032 is the markdownlint rule ID 'blanks-around-lists', not a CommonMark identifier; the trigger uses CommonMark-style list markers but the lint rule itself is markdownlint's). - L145: '#280' citation reframed — there's no docs/pr-preservation/280-drain-log.md in the corpus. The #280 fix landed at write-time (commit cce1df2) before any drain log was filed for it. Cite the fix-commit rather than a per-PR log so the observation is verifiable from the stated corpus. - L170: 'Pre-commit-lint candidate' wording was vague about whether detection exists. The repo already has tools/hygiene/audit-md032-plus-linestart.sh covering the '+'-at-line-start case. Update to point at the existing audit + state the new work clearly: extend to '- '/'* ' or promote to pre-commit enforcement. Drop 'Class A' label (this doc doesn't use that label; replace with the actual prior heading 'Inline-code-span line-wrap rendering bug').
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.
Summary
Promote the 'CommonMark MD032 — line-leading `+` / `-` parsed as list marker' pattern to a named recurring-findings class in `docs/pr-preservation/_patterns.md` after 5 instances surfaced in a single tick (2026-04-25):
Two-branch fix decision tree
The pattern documents both fix paths:
Composes with the existing Class A inline-code-span line-wrap pattern (same shape: line-wrap hits a CommonMark special character at line start). Pre-commit-lint candidate noted for the doc-lint suite tracked in #465.
Test plan
🤖 Generated with Claude Code