inteligir Writing
Write for someone who skims first and reads only if the skim earns it. This
skill owns structure and prose; inteligir-notes owns syntax.
Lead With The Answer
After the H1, the first paragraph states the conclusion, decision, or state —
standing on its own, needing nothing from later sections.
- Conclusions before evidence. Evidence before caveats.
- Sections ordered most to least important, not chronologically.
- Paragraphs of two to four sentences.
## for sections, ###/#### beneath. Never a second #.
Detail is not the enemy; front-loaded detail is. Move derivations down, do not
delete them.
Match The Shape To The Information
| The information is |
Write it as |
| One connected idea |
A paragraph |
| Related points or ordered steps |
A list |
| Attributes compared across items |
A table |
| Peer views read one at a time |
Tabs |
| Context, caution, or priority worth setting apart |
A callout |
| A numeric trend |
A chart |
| A question that needs an answer |
A comment on the exact text |
Two rules that save the most rework: keep block content out of table cells (a
cell holds inline content only), and give every fact exactly one home — a
requirement restated in a table, a checklist, and a callout will drift into three
different requirements.
Shapes That Work
- Decision — recommendation, options, tradeoffs, next step.
- Plan — goal, steps or checklist, owners and state, open questions.
- Research — findings first, then evidence by theme, then sources.
- Reference — one-line definition, rules, examples.
- Status — where it stands, what changed, what happens next.
Comment, Or Just Fix It
Comment when a person has to decide something, approve something, or answer a
question only they can answer — anchored to the exact evidence.
Fix directly: wording, ordering, duplication, a heading that buries its section.
A comment saying "this is unclear" on text you could have clarified is work
handed back to the reader.
Before You Finish
- The first paragraph after the H1 stands alone and says the thing.
- Headings plus their opening lines tell the story to someone who reads nothing
else.
- Each block matches the shape of what it holds.
- Every fact has one home.
- Properties live in frontmatter, not restated as bold labels in the body.
1---2name: inteligir-writing3description: How an inteligir note should read — leading with the answer, choosing structure that fits the information, and knowing when to stop.4---56# inteligir Writing78Write for someone who skims first and reads only if the skim earns it. This9skill owns structure and prose; `inteligir-notes` owns syntax.1011## Lead With The Answer1213After the H1, the first paragraph states the conclusion, decision, or state —14standing on its own, needing nothing from later sections.1516- Conclusions before evidence. Evidence before caveats.17- Sections ordered most to least important, not chronologically.18- Paragraphs of two to four sentences.19- `##` for sections, `###`/`####` beneath. Never a second `#`.2021Detail is not the enemy; front-loaded detail is. Move derivations down, do not22delete them.2324## Match The Shape To The Information2526| The information is | Write it as |27| ------------------------------------------------- | --------------------------- |28| One connected idea | A paragraph |29| Related points or ordered steps | A list |30| Attributes compared across items | A table |31| Peer views read one at a time | Tabs |32| Context, caution, or priority worth setting apart | A callout |33| A numeric trend | A chart |34| A question that needs an answer | A comment on the exact text |3536Two rules that save the most rework: keep block content out of table cells (a37cell holds inline content only), and give every fact exactly one home — a38requirement restated in a table, a checklist, and a callout will drift into three39different requirements.4041## Shapes That Work4243- **Decision** — recommendation, options, tradeoffs, next step.44- **Plan** — goal, steps or checklist, owners and state, open questions.45- **Research** — findings first, then evidence by theme, then sources.46- **Reference** — one-line definition, rules, examples.47- **Status** — where it stands, what changed, what happens next.4849## Comment, Or Just Fix It5051Comment when a person has to decide something, approve something, or answer a52question only they can answer — anchored to the exact evidence.5354Fix directly: wording, ordering, duplication, a heading that buries its section.55A comment saying "this is unclear" on text you could have clarified is work56handed back to the reader.5758## Before You Finish5960- The first paragraph after the H1 stands alone and says the thing.61- Headings plus their opening lines tell the story to someone who reads nothing62 else.63- Each block matches the shape of what it holds.64- Every fact has one home.65- Properties live in frontmatter, not restated as bold labels in the body.
kyh