# The Laws of Writing

Writing is the transfer of order from one mind to another. Opacity, decoration, and ambiguity destroy that order in transit — so the same law that governs design governs prose: every clause carries meaning or is removed, every claim can be wrong or is flagged, and the burden of clarity is always on the writer.

## Decision mandate

- Does the sentence carry a fact, claim, number, name, or position?
- Could a reader repeat the point after one read?
- Could the claim be wrong, and does it say what would break it?
- If any answer is no, cut or rewrite it.

## hostility

W01. **Opacity is hostility.** Decorative terms, ambiguous phrasing, and opaque language are not style failures. They are hostile acts against the reader — the worst kind, because they wear the costume of rigor. Language that makes a person dig for a point that could be said in two lines takes their time by force.

W02. **Opacity destroys order.** The writer already holds the thought in ordered form. Delivering it disordered forces every reader to spend energy reconstructing what the writer had and withheld — a pure loss, multiplied by readership. This is the site's order axiom applied to prose: suppressing the clear form when you possess it is suppressed energy, and it is charged to the writer.

W03. **Ambiguity is not politeness.** Ambiguity used to dodge commitment is a defect. Hedging, false balance, and qualifier-armor let a writer look careful while refusing to say anything that could be wrong. Say the thing that could be wrong.

W04. **The burden of clarity is on the writer.** When a reader asks what you are saying, the writer failed, not the reader. The repair is a rewrite in plainer words with a concrete case — never a restatement at the same altitude, and never a complaint about the reader.

## compression

W05. **Existence test for sentences.** Every clause must carry meaning — a fact, a claim, a number, a name, a position. Otherwise cut it. Throat-clearing, setup phrases, restated summaries, and scaffolding built around a point are removed before the point ships.

W06. **Say it once, plainly.** One idea, said once, in the words a person would use across a table. No synonym pass that restates the paragraph above it, no reveal structure that promises depth and delivers a rewording.

W07. **One question at a time.** A challenge is one question, in plain words, with one concrete case attached. Burying a single question under walls of hedging, either/or scaffolding, and pre-answered branches is spam even when every sentence in the wall is individually defensible.

## commitment

W08. **Falsifiable or flagged.** Sharpen every claim until it can be wrong. A claim that cannot fail is either an axiom — name it as one — or decoration, which is cut. An empirical bet is stated as a bet, with the case that would break it.

W09. **No decorative certainty.** Constructions like "This is not X. It is Y." launder interpretation into proof by rhetorical contrast. State the claim, then its mechanism or evidence. The certainty theater is deleted.

W10. **Land somewhere.** Presenting every side and never landing is a non-answer. Take the position the evidence supports, in one line, and defend it. Balance without a verdict is evasion.

W11. **Concede plainly.** When shown wrong, state the corrected position and continue from it. Do not narrate the concession, apologize in layers, or re-litigate the road there. The corrected claim is the concession.

## concrete

W12. **Concrete over abstract.** Numbers, names, dates, cases. One concrete case carries more than three abstractions. A general claim without an instance is unfinished; the instance is where the reader tests it.

W13. **Plain words only.** No jargon where a plain word exists. A term of art earns its place by being defined at first use or it is replaced. Vocabulary chosen to impress rather than transmit fails the existence test.

## rhythm

W14. **Human rhythm.** Sentence lengths vary. A metronome of same-shaped sentences reads as generated even when every word is defensible. Fragments are legal. A long sentence earns its length with real parts, then the next one snaps short.

W15. **Headers carry findings.** A heading states a finding in a human voice, never a filing label. "The company that got hacked wrote it up first" is a finding; "Company response" is taxonomy. Two headings sharing a grammatical template is a defect — rewrite one.

## register

W16. **End where the substance ends.** No closing recap, no sign-off, no restated thesis. The last sentence that adds a fact, claim, or consequence is the last sentence.

## Representations

- **article:** /a/writing-law — explain meaning (human reader)
- **markdown:** /api/articles/writing-law?format=markdown — portable explanation (human or model reader)
- **json:** /api/articles/writing-law — transport the complete typed object (software)
- **directory:** /api/directory/WRITING_LAW — discover identity and contract (router or operator)
- **skill:** /api/articles/writing-law/skill — teach behavior (LLM)
- **oip_contract:** /api/dispatch?key=WRITING_LAW — discover authority and invocation (agent or protocol client)
- **invoke:** /api/dispatch?invoke=WRITING_LAW — execute behavior and return proof (authorized agent or protocol client)
- **graph:** /api/articles/writing-law/voxels — traverse relationships (graph client)
- **versions:** /api/articles/writing-law/versions — inspect amendment lineage (auditor)
- **conformance:** /api/articles/writing-law/conformance — falsify claims and prescribe repair (test runner or critic)