For agents that make what a reader sees before they read: headers, cards, figures and diagrams.
What is in it
7 in the kit
Open why-this-pieceReaders read for a gain they can take and for standing among their peers. AnswerBefore you write, answer these in writing, from the material in front of you:1. What is the point of this piece?2. Why would a reader care about it?3. What is the business goal of this piece?4. What does the fact that we made the thing it's about say about us, and why doRules for the answers:- Each answer cites its source: a sentence in the material, a number, a run, or - The neighbour test: put the nearest similar piece in place of this one. Any an- Name the kind: a craft showpiece (shows a novel solution generously, workflow Read references/model-answer.md once: the user's own answers for one piece, the
Before you write, it asks four questions in writing: the point of the piece, why a reader would care, the business goal, and what making it says about us.
Open but-thereforeA story is a causal chain. Each beat exists because of the one before it: eitherThis is the cheapest kind of meaning for a reader to decode. Cause and effect be## The testWrite the beats as single lines, one event each. Read the joint between each pai- therefore: this beat happened because of the last one. It's a consequence, a d- but: this beat pushes against the last one. It's a failure, a surprise, a cost- and then: neither. This beat is just next in time.Every "and then" joint is a place to work. Repair it one of three ways:1. Find the real cause. Usually there is one and the draft hid it. "We added a d2. Cut the beat. If nothing caused it and nothing depends on it, the story doesn3. Move it. A beat can be orphaned because it's in the wrong place. Put it whereA chain that's all "therefore" is a plan going well: a reader trusts it and does## Building a chain from raw materialThe source is a diary, a transcript, a commit log, an interview, a pile of notes
Rebuilds a devlog or post as a chain of "but" and "therefore" instead of "and then".
Open cognitive-prophylacticsA prophylactic protects before the exposure. A story does that for situations: tThe currency is status. A story shows what to do in a situation to lift your sta## What the reader takes awayBefore drafting, write the dose in one line: the situation the reader might meet- "When a client asks for a discount on day one, the freelancer who names a smal- "When an agent you trusted closes another agent's window, the fix isn't a warnA piece with no dose is a diary entry. Find the dose, or cut the piece down to a## How to deliver it- Put a character in the situation. The dose lands through someone it happens to- Show the cost. Status has to visibly move: someone's face, a reply that doesn'- Let the failure happen on the page. The most protective beat is the one where - Couch information in real dialogue. What a person says, in their voice, with w- Arcs take time. A character who learns in one scene teaches a trick; one who c- Match the decoding cost to the reader. A situation a reader can see (a face, a
Before you draft, it asks for one line: the situation your reader might meet and the move that lifts or lowers their standing in it.
Open signal-chainPeople decode signals in a chain. Each tier is a compressed code for the tier be1. Emotions. Faces and voices. Understood from birth: the root of all meaning.2. Physical narratives. The puppet show: how bodies and objects acting on each o3. Verbal encoding. Speech. Language encodes stories and states the way a puppet4. Visual encoding. Writing, which encodes speech.5. Symbolic encoding. Maths, notation, code, where one symbol stands for a sente6. Hostile signals. A signal whose surface invites a lower tier's story, so the ## Tier is a state, not a traitHow far up the chain someone decodes depends on how much energy they'll spend ri## Writing with it- Lead with the lowest tier that carries the point. A face, a moment, an action,- Each tier unlocks the next. A reader who felt something (tier 1) and saw it ha- Cognitive affordances help everyone. What lets a tier-3 reader use the thing a- Trust lives low in the chain. Writing and generated images are now cheap to fa
It ranks ways of carrying a message by how costly each is for the reader to decode, from faces and voices to writing and symbols, so you choose the one they can afford.
Open shared-interface-partsA key interface part is a part that more than one view shows: main navigation, tWhen a new view needs a key part that already exists, use the component. Do not A part that belongs to one page goes beside or under the shared part. It never rA mock or prototype starts from the product's shared parts. It does not draw itsA change to a key part changes every view at once. Before you call the change co
A key interface part is a part that more than one view shows: main navigation, the header, status words, attention colours, a control that appears in many places.
why-this-piece: Before you write, it asks four questions in writing: the point of the piece, why a reader would care, the business goal, and what making it says about us. but-therefore: Rebuilds a devlog or post as a chain of "but" and "therefore" instead of "and then". cognitive-prophylactics: Before you draft, it asks for one line: the situation your reader might meet and the move that lifts or lowers their standing in it. signal-chain: It ranks ways of carrying a message by how costly each is for the reader to decode, from faces and voices to writing and symbols, so you choose the one they can afford. business-is-a-discipline: Business is a discipline in reality. no-eyebrows: Do not put a small label above a heading. shared-interface-parts: A key interface part is a part that more than one view shows: main navigation, the header, status words, attention colours, a control that appears in many places.
No eyebrows: Do not put a small label above a heading.
Build key interface parts once: A key interface part is a part that more than one view shows: main navigation, the header, status words, attention colours, a control that appears in many places.