Skip to content

Rewrite numbered work-item labels in code comments as descriptive names - #21

Merged
connollydavid merged 1 commit into
mainfrom
chore/anti-slop-numeral-sweep
Jun 15, 2026
Merged

Rewrite numbered work-item labels in code comments as descriptive names#21
connollydavid merged 1 commit into
mainfrom
chore/anti-slop-numeral-sweep

Conversation

@connollydavid

Copy link
Copy Markdown
Owner

Applies the repository's anti-slop vocabulary discipline to existing src/
and tests/ code comments: numbered work-item labels (a milestone-synonym
noun followed by a numeral) are reworded as descriptive names. The numeral
is the cross-model agentic tell; the discipline keeps it out of code comments
the same way it is kept out of commit subjects and governance prose.

Scope

  • Comment-only. 31 files, 54 lines changed / 54 removed; the non-comment
    scan is empty — no .c/.h/.rs code, no string literals, no test names,
    no behaviour touched.
  • Each label is removed and reworded (e.g. 5.4 retired "utf8"
    "utf8" was retired), not partially substituted — no decimal-mangling.

Gate (scoped to the change class)

  • Allium lifecycle: no behavioural change ⇒ no spec/obligation/weed impact.
  • CI: observed green on the pushed commit (Build and Test, success).
  • Review: every substituted line read in full and verified comment-only
    with correct, idiomatic text (the codemod-output-is-a-claim lesson).

🤖 Generated with Claude Code

The anti-slop linter's prior pass left the bare-numeral degenerate form
untouched because the engine matched only worded synonyms; the decimal-aware
engine (no-phase #11) now surfaces them. Strip the work-item-number register
from src/, tests/, and bridge/ comments — `5.4:` / `(5.5)` / `work-item 5.3`
labels and `(Phase 5.0)` headers become descriptive text. Legitimate version
numbers (Winsock 1.1, NT 3.1/4.0, the 1.8432 MHz UART clock, test version
data) are kept; one Unix-epoch false positive reworded.

Comment-only: 0 non-comment lines changed. Verified — engine reports 0
work-item tells (was 7 hard + 44 advisory); mingw cross-build 101/101,
host-pbt ALL PASS (50k trials), bridge cargo check clean.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@connollydavid
connollydavid merged commit 792da61 into main Jun 15, 2026
8 checks passed
@connollydavid
connollydavid deleted the chore/anti-slop-numeral-sweep branch June 15, 2026 20:38
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.

1 participant