Practical Prose Principles
July 10, 2026 · View on GitHub
Version: v0.1 (last update 2026-06-12)
Joshua Levy (github.com/jlevy) with agent assistance
Definition and Scope
Practical prose is writing where quality is judged by whether it helps a reader or agent understand, decide, do, verify, or maintain something.
Practical prose includes articles, blog posts, research reports, design documents, planning documents, technical specifications, academic papers, business memos, and analyses.
Persuasion is in scope when the writing is in service of a practical purpose and makes use of evidence and reasoning (such as in recommendation memos, grant proposals, incident analyses, or policy briefs). In contrast, writing where the primary purpose is expression, entertainment, or persuasion without evidence (fiction, personal essays, polemics, marketing copy) is out of scope.
Source Traditions
Practical writing draws from several traditions: plain language for economy, science for checkability, journalism for verification and proportion, technical communication for usability and maintenance, and literary craft for attention to the reader’s experience.
The principles here are a compact synthesis of ideas from these traditions. For the detailed sources and more context, see the bibliography.
Why Define Principles?
For practical writing, quality is the fit among purpose, truth, evidence, form, language, and need. A document works when its parts cooperate to help the intended reader do the intended thing.
The principles we select support these elements of quality.
| Quality element | Principles |
|---|---|
| Purpose | Purposeful: The document serves a named task. |
| Truth | Truthful: Claims are accurate and uncertainties apparent. |
| Evidence | Verifiable: Important claims can be traced and checked. |
| Form | Purposeful, Lucid, Maintainable: Shape fits task, navigation, and update workflow. |
| Language | Essential, Lucid, Humane: Wording is necessary, clear, and understandable by reader. |
| Need | Purposeful, Humane: The document helps a reader or agent act to fulfill human needs. |
Principles for Practical Prose
Rules tell you what you can or can’t do; principles tell you why. Normative guidelines help improve the quality and consistency of writing. But guidelines are most aligned and effective if they are written with principles in mind. We choose these:
-
Purposeful: The document states the reader need it serves, and its content, form, order, depth, and output shape fit that need. A decision memo has a recommendation; an audit has findings; a plan has milestones. A document whose shape elides what its task demands fails this principle even when the underlying analysis is sound.
-
Truthful: Claims are accurate, source-supported, framed at the right strength, and stated so they can be checked or refuted. Specificity lives under Precision, clarity under Lucid, and confidence under Calibration; this principle is the narrow epistemic core.
-
Essential: Practical prose surfaces the details and complexity the task requires and removes everything else. Keep language simple and direct. Omit needless words. Avoid inessential complexity. Note that this principle does not call for simplicity at the cost of accuracy; the complexity the task demands is part of what the document must carry.
-
Lucid: Prose is written for utility and ease of comprehension. Well-edited documents broker attention helpfully. Arguments are clear and logical. Problems are stated before solutions proposed. Terms are defined before they are used. Writing follows the “ladder of inference”: observation, judgment, interpretation, implication.
-
Verifiable: Claims trace to sources, observations, calculations, or explicit assumptions, and the sources needed to verify correctness are cited specifically enough to find the exact passage. A document can be Verifiable and still fail Truthful (sources cited at the wrong strength); verifiability is a precondition for trust, not a substitute for it.
-
Maintainable: Avoid duplication unless it serves a clear purpose. Organize documents for maintenance in a way that’s appropriate for the shelf life and workflows associated with the document.
-
Humane: Humane prose treats the reader as an intelligent participant. It respects the reader’s intelligence by giving complete information and making tradeoffs visible. It uses voice, rhythm, analogy, or story if they improve understanding or judgment. Humane writing is not softness or ornament; it is rigor in service of reader success.
These principles underlie practical-prose-guidelines.md and the dimensions used in practical-prose-rubric.md.
Mapping Principles to Measurable Attributes
practical-prose-guidelines.md defines twenty review dimensions grouped under six headings. Each maps to one or more principles.
| Dimension | Principles |
|---|---|
| Suitability | Purposeful; Humane |
| Scope | Purposeful |
| Breadth | Purposeful |
| Depth | Purposeful; Essential; Truthful |
| Clarity | Lucid; Humane |
| Coherence | Lucid; Humane |
| Concision | Essential; Humane |
| Organization | Lucid; Maintainable |
| Consistency | Lucid; Maintainable |
| Formatting | Lucid; Maintainable |
| Verifiability | Verifiable |
| Factuality | Truthful; Verifiable |
| Relevance | Purposeful; Essential |
| Discipline | Verifiable; Lucid |
| Soundness | Truthful; Verifiable |
| Precision | Truthful; Lucid |
| Parsimony | Essential; Verifiable |
| Calibration | Truthful; Humane |
| Fairness | Truthful |
| Robustness | Truthful; Verifiable |
Common Examples of Principle Mismatch
-
Cosmetic compliance crowds out substantive principle. Reviewing for banned words is a Lucid check; reviewing for arithmetic correctness is a Truthful check. The first is easier and tends to crowd out the second.
-
Style-tradition tools applied to the wrong principle. Strunk-and-White-style economy applied to a calibration problem produces shorter but no more accurate prose. The principles are not interchangeable.
-
Form mistaken for substance. A well-structured document with no functional value fails Purposeful no matter how good its scaffolding.
-
Audit machinery without judgment. A document can be highly Verifiable (every claim cited) and still fail Truthful (claims cited at the wrong strength, sources misrepresented). Auditability is a precondition for trust, not a substitute for it.
-
Performative rigor mistaken for quality. Once rules become rubrics, agents (and humans) will optimize the rubric: more tags, more citations, more caveats, more structure, more words. None of these makes a document better; they make it more compliant. The Humane principle exists to flag this failure mode: a document that scores high on every dimension but adds visible rigor without making its claims more inspectable, accurate, useful, or humane has gamed the metric. See “metrics are evidence, not quality” in practical-prose-rubric.md.
Related Docs
- ../README.md: how the practical-prose layers fit together.
- practical-prose-guidelines.md: prescriptive rules derived from these principles.
- practical-prose-rubric.md: descriptive 1-5 scoring anchors that operationalize the dimensions.
- practical-prose-bibliography.md: curated reading list for the traditions above.
- common-doc-guidelines.md: general style, organization, and formatting.