Skip to content

Add "the part" as a stand-in to §4 - #338

Closed
ndbroadbent wants to merge 1 commit into
blader:mainfrom
ndbroadbent:the-part-placeholder
Closed

ndbroadbent wants to merge 1 commit into
blader:mainfrom
ndbroadbent:the-part-placeholder

Conversation

@ndbroadbent

Copy link
Copy Markdown

Problem

Current models often write "the part" where they should name a thing. We see it most from Claude, which writes most of our text. It takes two forms:

  • A run-up before the point: "The hard part is choosing which project to drop." "The new part is that a refusal now looks like a success." "The useful part is that each item goes straight to the right agent." "The slow part is the dependencies."
  • A label for something the text never names: "This post is about the part that doesn't." "Third-party crates are the part worth sharing." "That's the part that matters." "The part you approved is done."

In both forms, the reader has to work out what "the part" refers to. In the run-up form, the sentence makes the reader wait for X when it could just state it.

It's common and it gets past editing. In our own agent transcripts, assistant replies used it more than a hundred times. Our messages to the agents used it a handful of times, mostly in AI text we'd pasted back. In our blog drafts, "The useful part goes beyond summarizing" appeared in three successive drafts, including the one marked final. "This post is about the part that doesn't" made it through a full Humanizer pass (2.8.2) and a copy-editing pass before a person caught it.

Why §4

§4 already lists "The thing is" and "Here's the thing". "The hard part is X" is the same run-up, with an adjective in front of the noun. The label form makes the same move: it points at the point without making it. So this extends §4 rather than adding a pattern. §25 (writing about the document) catches "This post is about..." but not "the part worth sharing" or "the part that matters".

Change

  • §4: adds "the part" forms to the watch list, one paragraph on how to fix them (name the thing, or state X directly), and one before/after. A literal part, such as one part of a multipart upload, is left alone.
  • README: adds "The hard part is..." to the strongest-tells list and to §4's table row.
  • CHANGELOG: one line under "Unreleased". There's no version bump.
  • SKILL.md grows by 122 words (5,226 to 5,348 by len(SKILL.split()), cap 5,500).
  • python3 scripts/validate-package.py, npx skills add . --list and claude plugin validate . all pass.

@blader

blader commented Nov 19, 2026

Copy link
Copy Markdown
Owner

Thanks @ndbroadbent! Folded into #343 (merged in 732e48a).

@blader blader closed this Nov 19, 2026
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