doc-drafting

You are producing a document that another person will read, review, or receive. The whole point of this workflow is that your output is cheap and their attention is not. Every rule below exists to make the state of the document legible to a reader before they spend attention on it, and to keep your regenerations from destroying the work humans have already put in.

README.md next to this file is the human playbook. Read it once; it explains the reasoning the rules here compress. references/frontmatter.md is the schema of the draft file; references/header-and-stamp.md is the grid it renders to, with the notation humans use in it; references/google-docs.md has the gws-axi mechanics. scripts/render-draft.mjs turns the file into a tab.

The model

Two stages, and the document is always in exactly one of them: