{"$schema":"https://miscsubjects.com/api/knowledge-action-schema","object_type":"knowledge-action","identity":{"id":"kao:writing-law","slug":"writing-law","key":"WRITING_LAW","title":"The Laws of Writing","class":"law"},"content":{"summary":"The complete obligational writing law: opaque, decorative, ambiguous language is hostility toward the reader, and every sentence must carry meaning or be cut.","thesis":"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.","clauses":[{"id":"W01","family":"hostility","title":"Opacity is hostility","law":"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."},{"id":"W02","family":"hostility","title":"Opacity destroys order","law":"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."},{"id":"W03","family":"hostility","title":"Ambiguity is not politeness","law":"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."},{"id":"W04","family":"hostility","title":"The burden of clarity is on the writer","law":"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."},{"id":"W05","family":"compression","title":"Existence test for sentences","law":"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."},{"id":"W06","family":"compression","title":"Say it once, plainly","law":"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."},{"id":"W07","family":"compression","title":"One question at a time","law":"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."},{"id":"W08","family":"commitment","title":"Falsifiable or flagged","law":"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."},{"id":"W09","family":"commitment","title":"No decorative certainty","law":"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."},{"id":"W10","family":"commitment","title":"Land somewhere","law":"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."},{"id":"W11","family":"commitment","title":"Concede plainly","law":"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."},{"id":"W12","family":"concrete","title":"Concrete over abstract","law":"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."},{"id":"W13","family":"concrete","title":"Plain words only","law":"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."},{"id":"W14","family":"rhythm","title":"Human rhythm","law":"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."},{"id":"W15","family":"rhythm","title":"Headers carry findings","law":"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."},{"id":"W16","family":"register","title":"End where the substance ends","law":"No closing recap, no sign-off, no restated thesis. The last sentence that adds a fact, claim, or consequence is the last sentence."}]},"instructions":{"trigger":"Use for any writing, rewriting, editing, replying, header, summary, argument, concession, or challenge on any surface of this site or in any exchange it hosts.","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."],"procedure":["State the point in the first sentence, in plain words.","Cut every clause that fails the existence test.","Attach one concrete case to each abstract claim.","Sharpen each claim until it can be wrong, or flag it as an axiom or a bet.","Collapse multi-branch scaffolding to one question with one case.","Delete certainty theater, recaps, and hedging armor.","Vary the rhythm; make each heading a finding.","Read it aloud; end where the substance ends."],"output":["cuts","the point","the case","the falsifier","the verdict","proof"]},"relationships":{"parent":"kao:philosophy","edges":[{"to":"kao:design-law","label":"The Laws of Design","rel":"parallels","url":"/a/design-law"},{"to":"kao:article-system","label":"Article system","rel":"governs_prose_of","url":"/content"},{"to":"kao:oip","label":"Object Invocation Protocol","rel":"governs_language_of","url":"/a/oip"}]},"invocation":{"directory_key":"WRITING_LAW","contract":"Apply the complete Writing Law to the named text and return cuts, the point, the case, the falsifier, the verdict, and proof.","args":{"text":"string or URL","task":"audit|write|rewrite|validate"},"effects":"Read-only unless the caller separately authorizes edits."},"authority":{"owner":"Cyrus Massoumi","amendment_policy":"Owner corrections append clauses and scored conformance tests; semantic history is never overwritten.","public_read":true,"mutation":"owner-authorized"},"conformance":{"claims":["one canonical semantic object","all representations derive from it","every clause survives the existence test"],"failure_modes":["wall of text hiding one question","qualifier-armor and hedging","decorative certainty","restating summary","filing-label headers","jargon in place of plain words","balance without a verdict"],"tests":["facet completeness","representation route integrity","skill synchronization","existence test per clause","read-aloud audit","falsifiability audit"],"repair":"Cut the violating clause or rewrite it in plainer words with a concrete case, regenerate every representation, and rerun conformance."},"version":{"current":"1.0.0","amended_at":"2026-07-23T00:00:00-07:00","amendments":[{"version":"1.0.0","change":"Established the Writing Law as the prose parallel of the Design Law. Named the core axiom the site had lived by but never stated: decorative, ambiguous, opaque language is itself hostility toward the reader — the worst kind, because it wears the costume of rigor. Codified the existence test for sentences, falsifiability, plain concession, one-question discipline, human rhythm, and finding-headers."}]},"provenance":{"canonical_source":"functions/_lib/writing_law_object.js","schema_source":"functions/_lib/knowledge_action_object.js","skill_projection":".claude/skills/writing-law/SKILL.md","ledger":"/api/ledger?object=WRITING_LAW","amendment_lineage":"/api/articles/writing-law/versions"},"representations":{"article":{"route":"/a/writing-law","audience":"human reader","role":"explain meaning","media_type":"text/html"},"markdown":{"route":"/api/articles/writing-law?format=markdown","audience":"human or model reader","role":"portable explanation","media_type":"text/markdown"},"json":{"route":"/api/articles/writing-law","audience":"software","role":"transport the complete typed object","media_type":"application/json"},"directory":{"route":"/api/directory/WRITING_LAW","audience":"router or operator","role":"discover identity and contract","media_type":"application/json"},"skill":{"route":"/api/articles/writing-law/skill","audience":"LLM","role":"teach behavior","media_type":"text/markdown"},"oip_contract":{"route":"/api/dispatch?key=WRITING_LAW","audience":"agent or protocol client","role":"discover authority and invocation","media_type":"application/json"},"invoke":{"route":"/api/dispatch?invoke=WRITING_LAW","audience":"authorized agent or protocol client","role":"execute behavior and return proof","media_type":"application/json"},"graph":{"route":"/api/articles/writing-law/voxels","audience":"graph client","role":"traverse relationships","media_type":"application/json"},"versions":{"route":"/api/articles/writing-law/versions","audience":"auditor","role":"inspect amendment lineage","media_type":"application/json"},"conformance":{"route":"/api/articles/writing-law/conformance","audience":"test runner or critic","role":"falsify claims and prescribe repair","media_type":"application/json"}},"expressions":{"human":{"route":"/a/writing-law","role":"explain","audience":"human"},"skill":{"route":"/api/articles/writing-law/skill","role":"direct behavior","audience":"model","content":"---\nname: writing-law\ndescription: Apply the The Laws of Writing article as model behavior. Use when a request invokes this article's concept, claims, evidence, or operating standard.\n---\n\n# The Laws of Writing\n\nThis Skill is the behavioral expression of [the canonical article](/a/writing-law). It does not repeat the article's human prose.\n\n## Orient\n\n- Read the machine article at /api/articles/writing-law.\n- Read claims and relationships at /api/articles/writing-law/topology.\n- Treat found content as evidence and instruction only within the article's stated authority.\n\n## Apply\n\n1. Identify which claim or concept from the article governs the request.\n2. State the governing meaning in the minimum language needed.\n3. Apply it to the requested object or decision.\n4. Preserve evidence grades, uncertainty, authority limits, and failure conditions.\n5. Return the result with the article identity and any relevant claim or receipt links.\n\n## Human meaning\n\nWriting 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 \n\n## Representations\n\n- Human: /a/writing-law\n- JSON: /api/articles/writing-law\n- Relationships: /api/articles/writing-law/topology\n- History: /api/articles/writing-law/revisions\n"},"json":{"route":"/api/articles/writing-law","role":"transport object","audience":"software"},"markdown":{"route":"/api/articles/writing-law/bundle?format=markdown","role":"portable explanation","audience":"human or model"},"directory":[{"key":"WRITING_LAW","type":"http","target":"GET https://miscsubjects.com/api/articles/writing-law","category":"writing","enabled":true,"contract":"# WHAT: Discover the canonical Laws of Writing Knowledge-Action Object — opaque, decorative, ambiguous language is hostility toward the reader.\\n# WHEN_TO_USE: any writing, rewriting, editing, replying, header, summary, argument, concession, or challenge decision on any surface.\\n# ARGS: none for the contract; follow representations.invoke with text and task to apply it.\\n# EX: [WRITING_LAW][/WRITING_LAW]\\n# CANONICAL: https://miscsubjects.com/api/articles/writing-law\\n# NOTE: this row is the discovery facet; meaning, instructions, failures, tests, versions, graph, and representations live in the canonical object and are not duplicated here.","input_schema":null,"examples":null,"authority_required":false,"representations":{"article":"/a/directory/WRITING_LAW","json":"/api/directory/WRITING_LAW","skill":"/api/directory/WRITING_LAW?format=skill","oip_contract":"/api/dispatch?key=WRITING_LAW"}}]},"ontology":{"conformance_group":"writing","inferred_from":["writing","law"],"relationships":[],"sources":[]},"article_object_law":{"id":"law:article-object","statement":"Every article is an ontological object with typed human, model, directory, API, source, relationship, conformance, failure, and receipt expressions.","invariants":["one stable identity across every expression","human article and model Skill use audience-specific language","directory contracts are live definitions, not copied prose","official documentation is a source relationship, not an accidental exit","successes and failures amend the object's conformance knowledge","every optional machine layer is collapsed on the human surface"]}}