# Essays / longform Apply [`core.md`](./core.md) first. This file is the genre overlay for essays, talks, and other long argumentative prose. It is not the file for reference docs, changelogs, API pages, or UI chrome. Those get core only. Same house register is fine. Required anecdote is not. Journal articles and working papers use [`academic.md`](./academic.md), not this file's scene rule. --- ## One register Pick a house voice and use it on every essay and talk in the publication. Formality is the easiest place for AI smell to hide: core's tells all read as more natural in a formal register. What is not acceptable is drift, where the register depends on which day a piece was written. Typical for this genre: first person when the author is in the piece. Keep a few full forms on purpose for emphasis. That is a choice, not a leak. Talks may use more signpost openers than a blog post. The audience needs the map. They also earn air. Cut the same scaffolding from prose. --- ## The author has to be in it Abstract argument with no author and no anecdote is the main failure mode of an **essay**. Every essay needs a person: a first-hand moment, a named failure, a specific scene, or a checkable story. A placeholder that "reads complete" without the story is a trap. Fill it or do not ship. Do not inject a scene into a reference hub to satisfy this rule. --- ## Concrete instance The strongest writing is anchored to specifics: a number, a named source, a particular failure, a first-hand moment. The weakest passages are the abstract ones. **Rule: no framework essay ships without at least one concrete, checkable anchor.** If the piece teaches a model, show the model working on one real object before you ask the reader to carry the model away. --- ## Optional: close with a deed Some publications require that every essay end in an available action, in the same piece, not in a follow-up. Not a call to subscribe. A thing the reader can do today, ideally in the next ten minutes, ideally with someone already in their life. Insight that lands with no deed attached is easy to mistake for having acted. If the overlay requires a deed, weld it to the reframe in the essay's own voice. Do not bolt on a generic "now go forth." This package does not require a deed unless the project overlay says so. --- ## Talk and long argument extras Surface law for essays, talks, and long argument. Not for reference docs, changelogs, or UI chrome. If a rewrite would only restate colleague voice, it is already in core. **Walk-vs-stage.** Would you say this next to someone, or from a stage? If stage, rewrite. Agents default to a lectern. That test already catches elevated prose, impersonal dummy ("Show one piece and it looks like a side project"), and verbs only a specialist or an activist would say. Keep ordinary moves a listener can picture: observe, dig, test, try, refine. They should finish and feel they could have taken the same steps: not "anyone could have," not "only I." If they have to decode the sentence, they cannot arrive at the thought. Spell the fact. Overlay may keep a stricter form. This file gets the short test. **Picture before theory.** Do not ask a theory question before the picture is in the room. "Why does recognition work where instruction fails?" is a unit title in question form. Ask after they can see the thing, or do not ask: start with the strike, the tree, the hinge. A Socratic question starts with something ordinary. A midterm question starts with the doctrine. Core already protects the first. This rule names the second. **Subject first.** The same rule for definitions and section openers. Show the case, then name it: two sentences about one silence, then "call that limit the bound." An opener like "The limits of your responsibility matter most when…" makes the reader wait a paragraph to learn the section is about a harmful pattern. Test: after the first sentence, can they say which situation this is? Core's topic-sentence pinning is the opposite failure. Pinning announces the point; this withholds the subject. **Hedge where the doubt is real.** A budget, not a ban. Careful prose earns hedges where the uncertainty is real: what another person meant, what the evidence can't show yet. Stack *can*, *may*, and *might* across every line and the lines meant to land go soft. Keep the hedge where it describes the world. Cut it where the reader already accepts the uncertainty. [`claims.md`](./claims.md) flags an absolute where a hedge is earned. This is the reverse: a hedge where plain is earned. Do not trade a hedge for an absolute the evidence won't carry. **Take a breath.** A new paragraph is a pause. If you would stop and look at them before the next beat, break. Do not chop every sentence. **Don't close a live definition.** A shut noun makes a still-refining shape sound finished. "Conclusions," "the system," "the answer" when the thing is still being named. Prefer the live word: connections, definitions, a working model. **Don't retrofit a later name.** If they did the thing before they had the phrase, say they did not have the phrase. Do not put today's vocabulary in a younger mouth. **One claim per breath.** A definition, a scope claim, and a duty each need their own beat. One sentence can carry one. **Don't repeat unless you add a beat.** Coming back is fine when you add something. A second pass that only restates is a stall. **Obligation as object.** "I take the obligation" / "I accept it" / "I embrace it" is ceremony. Say what you try to do. The feeling can stay *obligation* where that is the right word. Do not flag every use of the noun. [`civic.md`](./civic.md) is the named exception: ceremony that names a real oath still passes. --- ## Audit extras for this genre On top of `core.md` and `audit.md`: - Missing author / missing concrete instance (essays and talks, not reference) - Title or lede that claims more than the body proves (run `claims.md` when this is in doubt) - Walk-vs-stage (lectern, impersonal dummy, specialist verbs) - Midterm question before the picture, subject withheld behind an abstract opener, hedges stacked on the lines meant to land, live definition closed too early, later name retrofitted, three claims in one breath, restating without a beat, obligation as object (ceremony, not the noun)