building ai knowledge systems with @arsumbrisai
Joined April 2025
- Tweets1.4K
- Following373
- Followers13.7K
- Likes4.2K
going quiet for a few weeks to focus on the next big @arsumbrisai update. stay tuned
# Avoid the overused phrase
A overused phrase is one you have read many times.
The reader skims past it.
Write it in your own words instead.
If a phrase comes to you too easily, it is worn out.
Cut it or replace it.
# No period on a list item
A list item takes no terminal period.
The bullet and the line break already close it.
So the period is a redundant mark.
Drop it from every bullet and every numbered step.
Running prose keeps its periods.
A sentence still needs its end.
The bullet "read the note." becomes "read the note".
To check, no list item ends in a period.
jump to the first post in case you want to bookmark this
xitter.cf/arscontexta/status/210…
i wrote 20+ atomic writing rules ( see 🧵 )
each in its own md file explaining what matters to me and why
i mean “explain this in ASD-STE100” is a start...
but i want to define my own writing style and carry it across models and sessions
session profiles select which rules get injected through the session start hook
i rather work with small composable rules instead of one giant agents md
btw the same rules also power two skills:
/apply-writing-style to rewrite existing text
/check-writing-style to review it against the rules
so i can add one rule, reuse it across profiles and have the next session work with the updated version
the types, rules and skills are bundled as one reusable repo
i can add it as a dependency to my current workspace to make use of it
or i just depend on the types to build a different rule set / profile and reuse the skills
( so in love with composable repos for knowledge work )
check out my writing rules and steal what you like
# Cut what could go anywhere
A sentence that fits any note says nothing about this one.
Test each line.
Could it move unchanged to another project or product?
If it could, it is filler.
Cut it or make it specific to this note.
# One word, one meaning
Pick one word for a thing.
Use it every time.
Do not use a synonym to vary the prose.
A reader who meets a second word asks if you mean a second thing.
Use "check" every time.
Do not mix it with "verify" or "confirm".
Scan a note for two words that name one thing.
One of them is redundant.
# Cut the optional comma
If a comma changes no meaning, drop it.
It slows the reader down.
Drop the comma you do not need:
- Before an "and" or "or" that joins one subject
- Before an extra phrase the sentence reads fine without
Keep a comma that stops a wrong reading.
Cut the rest.
# Cut the empty adjective
A flourish is a sentence shaped for effect rather than the point.
Common flourishes:
- The false contrast, "It's not X. It's Y."
- The fake-insight setup, "What nobody tells you"
- The grand kicker, a closing line that sounds deep and says nothing
- The recap that repeats what the reader just read
- Any shape that sounds deep and adds nothing
The shape hides a thin or missing point.
State the point plainly or cut the sentence.
"It's not the model, it's the eval" becomes "the eval matters more than the model".
# Cut the flourish
A flourish is a sentence shaped for effect rather than the point.
Common flourishes:
- The false contrast, "It's not X. It's Y."
- The fake-insight setup, "What nobody tells you"
- The grand kicker, a closing line that sounds deep and says nothing
- The recap that repeats what the reader just read
- Any shape that sounds deep and adds nothing
The shape hides a thin or missing point.
State the point plainly or cut the sentence.
"It's not the model, it's the eval" becomes "the eval matters more than the model".
# Group a long list
The reader holds only a few items at once.
A flat list of more than about five is too many.
Group a long list into a few labeled parts.
Each part holds a few items.
For example, group eight fields into three parts:
- Identity
- Timing
- Payload
# Every word is a debt
Every word you keep is work for later.
Someone reads it again and checks that it is still true.
So keep few words.
Keep what the truth needs and no more.
Cut a word that does no work.
Do not cut a real point.
Test each sentence.
Does it help the reader do one of these:
- Decide
- Build
- Remember
- Check
- Understand
Cut the sentence that helps with none of them.
Any real help counts, not only these five.
# Say it plain
Write for a smart coworker, not to sound clever.
Use the plain choice every time:
- The short word, not the long one
- The plain word, not the jargon
- The active voice, not the passive
- The positive statement, not the negative
- The short sentence, not the long one
A long word chosen to sound smart means the same as the short one.
Use the short one.
Keep the precise term when no plain word carries the meaning.
Define it once.
Reuse it.
# No em-dashes, no semicolon
Both marks join two thoughts that read better apart.
Split them.
An em-dash becomes a period and a new line.
A semicolon becomes two sentences.
When you want a dash, write the second thought as its own sentence.
# One sentence, one line
Put a line break after every sentence.
Each sentence stands on its own line.
Give each fact its own line too.
A sentence that joins two thoughts with "and" or "so" holds two facts.
When a line holds two facts, break it in two.
A block of sentences hides where one ends and the next starts.
A line each lets the reader find, move and cut any line on its own.
# Bold the key term
Bold the one term the reader's eye should land on first.
It is the anchor the scan finds.
Bold at most one term per beat.
Two bold terms compete.
Neither anchors the eye.
A bold label is that beat's one bold term.
Do not bold another term inside it.
To check, a beat has at most one bold term.
# Leave room for the case you did not name
End a list of examples with an item that covers the rest.
Your examples never cover every case.
A list that stops at them reads as the whole class.
The reader then meets a case you left out and stops.
Put the catch-all in the list, not in the lead-in.
The reader scans the bullets and skips the line above them.
A closed set needs no catch-all.
An enum's members and a sealed family's leaves are the whole set.
Leave them closed.
Read your list.
Name a case it leaves out.
If the reader would stall there, add the item.
# Number a list only when ordered
A number carries a meaning a bullet does not, an order.
Number a list only when the number does work.
Number it when the items run in a sequence, or when the reader points back to one by its number:
- Steps taken in turn
- A ranked series
- An item the reader will cite, "do 2 and 4"
Otherwise use a bullet.
A number on an unordered set is a false signal, it implies an order that is not there.
To check, renumber the list at random, if nothing is lost it should be a bullet.