draft · diff

git:20261010.3ba1fbe to git:20261113.8af5195

33 added, 25 removed. Audit A to A.

What this update changes in the checks

No check changed: every fixed check gives the same answer before and after this update.

A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.

---
name: draft
description: >-
- Use this when writing or expanding an article section by section. Never
- generate a full article in one shot.
+ Use this when writing or expanding an article one section at a time, with
+ the writer's approval between sections. Never writes the whole piece at once.
---
+ # Draft
+ Write from an approved outline, one section at a time, with the writer approving each before the next. Get a rough shape down, then improve it. Never produce the whole article in one go.
- # Draft
+ ## Before each section
- Write one section at a time from a signed outline and interview notes. Sculpt, do not dump.
+ 1. Say the thesis back in one sentence. If it has drifted or tries to say two things, stop and fix that first.
+ 2. Name the section and why it comes next.
+ 3. Name two habits of this writer's voice you will keep (first person, short punch paragraphs, dry asides, exact numbers). Use their earlier posts or notes if you have them.
- ## Before prose
+ ## While writing
- 1. Restate the thesis in one sentence. If it is vague or trying to say too many things, fix the thesis first.
- 2. Name 2 voice patterns you will keep (short punchline paragraph, concrete number, first person, etc.).
- 3. Say which section you are writing and why that one is next.
+ - Every paragraph moves the piece: a new fact, a new step, or a new turn. A paragraph that repeats the last one in other words gets cut.
+ - Plain, ordinary words. If a simpler word exists, use it.
+ - Open each section on something concrete. No "Have you ever wondered".
+ - Prose by default. Bullets only for steps or real lists.
+ - Mix short and long sentences on purpose.
+ - Start a sentence with "But" or "And" when it reads naturally. Grammar allows it.
+ - No invented numbers, quotes, or sources. Leave `[GAP: what is needed]` and keep going.
+ - Follow no-ai-slop's house rules as you write (no em dashes in short copy, no staged contrasts, no slogan endings). Cheaper than fixing them later.
- ## Guard rails
+ ## After each section
- - No em dashes. Periods, commas, parentheses.
- - Vary sentence length. Do not stack three similar sentences.
- - Banned: leverage, comprehensive, pivotal, delve, showcase, intricate, landscape, tapestry, transformative, paradigm, robust, seamless, unlock, dynamic.
- - No formula phrases: not just X but Y, in today's world, it's important to note, a key takeaway is, let's explore.
- - Every paragraph must add a new fact or move. Restating in new words is a cut.
- - Open with a claim, scene, or problem. Not "Have you ever…"
- - End concrete. No motivational poster.
- - Prose over bullets unless the reader is scanning steps.
- - Contrastive "not X, but Y" at most twice in a long piece. Prefer the positive claim.
- - Never invent numbers, quotes, or sources. Flag a gap instead.
+ - Offer two versions of any line that carries a lot of weight (the hook, a key claim, the last line) and let the writer pick.
+ - Reread from the top. Look for tone shifts and points made twice.
+ - If the section is fighting the outline, say so and propose an outline change. Going back early beats polishing a broken arc.
+ - Stop and wait for approval unless the writer asked for more than one section.
- ## How
+ When every section is in: source-check, then no-ai-slop.
- - One section, then stop for sign-off unless the writer asked for more.
- - Offer 2 options when the line is load-bearing (hook, invoice, takeaway).
- - After each section, reread from the top for tone shift and repeated points.
- - If the section fights the outline, say so and go back to Outline. Do not polish a broken arc.
+ ## Inspired by
- Source: adapted from [Nadiem Mahmoud, draft](https://github.com/nadiem99/claude-writing-skills/blob/5b52111e1bd30e93643929f17155e82aa26f771f/skills/pipeline/draft/SKILL.md). MIT; see [third-party notices](../../../THIRD_PARTY_NOTICES.md).
+ - [Nadiem Mahmoud, draft](https://github.com/nadiem99/claude-writing-skills/blob/5b52111e1bd30e93643929f17155e82aa26f771f/skills/pipeline/draft/SKILL.md) (MIT). Does well: section-by-section drafting, thesis check first, voice calibration, and going back to the outline when needed. Missing: bans sentences that start with "But" or "And", and leans on vault folders and context files the user may not have.
+ - [Paul Graham, Write Simply](https://www.paulgraham.com/simply.html) and [Writing, Briefly](https://www.paulgraham.com/writing44.html). Does well: ordinary words and a fast bad first version, then rewriting. Missing: no checkpoints or collaboration rules.
+ - [George Orwell, Politics and the English Language](https://www.orwellfoundation.com/the-orwell-foundation/orwell/essays-and-other-works/politics-and-the-english-language/). Does well: short rules with an escape clause for when a rule makes the sentence worse. Missing: nothing on structure or drafting with a collaborator.
+
+ ## What this version adds
+
+ - Gap markers so drafting never stops for a missing fact and never invents one.
+ - Anti-slop house rules applied during drafting, not only after.
+ - Explicit permission for natural "But" and "And" openers.