Skip to content

style(docs): remove AI-writing tells from repository markdown - #494

Merged
kyle-sexton merged 5 commits into
mainfrom
claude/ai-slop-cleanup-repo-lllz3a
Aug 25, 2026
Merged

style(docs): remove AI-writing tells from repository markdown#494
kyle-sexton merged 5 commits into
mainfrom
claude/ai-slop-cleanup-repo-lllz3a

Conversation

@kyle-sexton

Copy link
Copy Markdown
Contributor

No linked issue

Summary

Repo-wide /ai-slop:audit fix pass over all 120 tracked markdown files. The detector found 1292 findings (1277 em dashes, 14 rule-of-three density hits, 1 emoji-formatting hit) across 86 files; this PR rewrites them per the plugin's rewrite guide while preserving what every sentence asserts.

Fix

  • Em dashes in prose become colons (label bullets, heading qualifiers), commas, periods, or restructured sentences. Never parentheses, en dashes, or spaced hyphens.
  • Rule-of-three density findings were judged individually; rhetorical triads collapse toward the strongest item, while load-bearing enumerations in normative criteria are kept and the reasons recorded.
  • REVIEW.md's severity-marker emoji (load-bearing output vocabulary) are suppressed with an ai-slop ignore marker instead of removed.
  • Work lands group by group (conventions/review first; components, conventions/engineering+process, docs, root/distribution follow) as parallel rewrite passes complete verification.

Verification

  • Each group's rewrite is checked by a fresh-context semantic-diff reviewer, blind to the rewrite rationale, flagging any dropped qualifier, threshold, actor, or claim; flagged hunks are reverted. The conventions/review groups verified clean.
  • Pre-commit lanes (typos, editorconfig-checker, gitleaks, markdownlint) pass on every commit.
  • The ai-slop detector is re-run over the fixed set at the end; residual count reported in the PR thread.

Related

  • melodic-software/ai-slop plugin (/ai-slop:audit), whose catalog and rewrite guide this pass applies.

🤖 Generated with Claude Code

https://claude.ai/code/session_01SdUrpi8EBT79LYEzDPHUP8


Generated by Claude Code

ai-slop:audit fix pass: 412 em-dash findings rewritten to colons,
commas, periods, or restructured sentences across the review
conventions and overlays. Rule-of-three density findings were
individually judged; load-bearing enumerations kept as-is.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdUrpi8EBT79LYEzDPHUP8
@claude

claude Bot commented Aug 25, 2026

Copy link
Copy Markdown

Claude finished @kyle-sexton's task in 1m 40s —— View job


Claude is reviewing this PR

  • Gather context (PR diff, changed files, task instructions)
  • Run /review:code-review procedure (skill invocation didn't return content; proceeding with equivalent manual semantic-diff review per the fallback instructions)
  • Analyze diff for correctness / maintainability issues (3 parallel semantic-diff reviewers dispatched across the 25 changed files)
  • Post inline comments for anchorable findings
  • Post summary review comment

ai-slop:audit fix pass: 133 em-dash findings rewritten across
README.md, REVIEW.md, .claude/source-control.md, harness/README.md,
and distribution/. REVIEW.md's severity-marker emoji are suppressed
with a reasoned ai-slop-ignore marker (load-bearing output
vocabulary). Two rewrites a blind semantic-diff review flagged as
narrowing open-class claims in REVIEW.md were repaired to keep the
original meaning.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdUrpi8EBT79LYEzDPHUP8
@github-actions

Copy link
Copy Markdown

Claude has reviewed this PR 1 time. The lane skips further automatic reviews after 5; deleting this comment resets the count.

claude added 3 commits August 25, 2026 16:27
ai-slop:audit fix pass: 220 em-dash findings rewritten across the
component READMEs and threat models. Rule-of-three density findings
in runner-policy's threat model were judged individually; every
flagged list is a load-bearing security enumeration and kept. A
blind semantic-diff review flagged one rewrite in
claude-permissions/README.md as admitting a narrowed reading of the
never-inferred rule; it was repaired to keep the absolute
prohibition. Fixture edit verified against the markdownlint
component tests (24 assertions pass).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdUrpi8EBT79LYEzDPHUP8
ai-slop:audit fix pass: 240 em-dash findings rewritten across
conventions/engineering, conventions/process, and conventions
READMEs; one em dash inside a literal ISO 24495-1 title is
suppressed with a reasoned ai-slop-ignore marker. Four triad
collapses that a blind semantic-diff review flagged as dropping
load-bearing list members were reverted to the full enumerations in
dash-free form.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdUrpi8EBT79LYEzDPHUP8
ai-slop:audit fix pass: 269 em-dash findings rewritten across the
ADRs, component-lifecycle doc, and topic planning records with
punctuation-level changes only; decisions, acceptance criteria, and
quoted historical text are unchanged (verified byte-identical by a
blind semantic-diff review). One em dash inside a verbatim quote of
a stale manifest comment is suppressed with a reasoned
ai-slop-ignore marker.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SdUrpi8EBT79LYEzDPHUP8

Copy link
Copy Markdown
Contributor Author

Cleanup complete; all five groups have landed. Detector re-run over the full 120-file tracked set:

  • rule-em-dash: 1277 → 0. Two deliberate suppressions remain, each with a reasoned in-file ai-slop-ignore marker: the literal ISO 24495-1 title in conventions/engineering/concise-prose.md, and a verbatim quote of a stale manifest comment in docs/topics/standards-sync-audit/PLAN.md.
  • rule-emoji-formatting: 1 → 0. REVIEW.md's 🔴/🟡/🟣 severity markers are load-bearing output vocabulary and are suppressed, not removed.
  • rule-rule-of-three: 15 density findings remain by design. Every flagged triad was individually reviewed; the survivors are load-bearing enumerations in normative criteria (complete OS sets, WCAG terms, threat-model coverage lists). Four attempted collapses were reverted after a blind semantic-diff review flagged them as dropping list members.

Every rewritten group was checked by a fresh-context semantic-diff reviewer, blind to the rewrite rationale; the seven hunks flagged across all groups (narrowed open-class claims, dropped list members) were repaired or reverted. Pre-commit lanes (typos, editorconfig, gitleaks, markdownlint) pass on every commit, and the markdownlint fixture edit was verified against its component tests (24 assertions pass).


Generated by Claude Code

@kyle-sexton
kyle-sexton merged commit 6303a32 into main Aug 25, 2026
45 checks passed
@kyle-sexton
kyle-sexton deleted the claude/ai-slop-cleanup-repo-lllz3a branch August 25, 2026 17:07
kyle-sexton added a commit that referenced this pull request Aug 26, 2026
Conflicts in docs/topics/standards-sync-audit/PLAN.md are all the same
shape: main's #494 style pass rewrote em-dashes to plain punctuation on
lines this branch had already rewritten for content. Resolved by taking
this branch's content and applying #494's punctuation to it, so the file
carries the Phase 1.4/1.5 [DONE] records and the new Phase 1.6 section
without reintroducing the em-dashes #494 removed (count back to 1, the
ai-slop-ignore verbatim quote main also kept).

The engine line reference in Phase 1.5's Sanity Check stays at this
branch's `:666-684`, verified against distribution/sync-manifest.mjs
(automerge parsing is 666-684 today); main's `:723-732` is stale.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013FKgumzQEj4s9cbzh5k2UX
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants