Shorten the idea to its three claims - #28
Open
andreisavu wants to merge 1 commit into
Open
Conversation
The section ran 39 lines and 307 words before a reader met a function name. It made three claims and gave each one a paragraph and three bullets, so the bullets restated the paragraph above them. Each claim now has its bold lead and the argument under it, at 22 lines and 189 words. Both framings stay, as `CLAUDE.md` requires: agents wait for events, and the agent is the ownership boundary. Two sentences ran to 26 words against the 25 the writing rules allow. Both are two sentences now.
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.
"The idea" ran 39 lines and 307 words before a reader met a function name.
It is 22 lines and 189 words now, and it makes the same three claims.
What was doubled
Each claim had a paragraph and a three-bullet list under it, and the
bullets restated the paragraph above them.
bullets for one fact.
techniques compose" restated the sentence above it.
restated "Ambion makes the team first-class".
The bullets are gone and the paragraphs hold anything they added. A reader
of the three bold leads still gets the section's claims, which is what the
writing guidance asks of a page.
What stayed
Both framings, as
CLAUDE.mdrequires: agents wait for events, and theagent is the ownership boundary.
context engineering, and the ownership boundary"; the sentence under it
makes the first half, so the lead names the boundary. The step from a
shared context window to an agent no team can improve is one sentence
now, and it keeps the argument the claim rests on.
The lead dropped "Ambion starts there", which the paragraph says.
Also
Two sentences ran to 26 words against the 25 the writing rules allow for a
description. One of them predates this change. Both are two sentences now.
Checks
pnpm run check:formatpasses. The change is one section ofREADME.md,so no code, test or contract moved.