Bow Tie Kreative Writing System
Run the engine

Rules / structure

STR-008 Hard constraint layer: section

Heading predicts content

IF a heading does not accurately predict its section, THEN rename the heading or repair the section ELSE retain.

Why the rule exists

A misleading heading damages navigation and trust.

Condition

The rule fires when this evaluates true. Paths marked below must be present in the fact base; the engine reports the rest rather than guessing them.

  • section.heading_content_match eq false

Facts this rule reads

PathSource
section.heading_content_match You supply it

Then

  1. align — target section.heading, value from section.primary_reader_question
  2. flag — target section

Else

  1. retain — target current_text, No triggering condition is present.

Test cases

TST-008 · [object Object]

Before
Heading: More information; section: Reset your password.
After
Heading: Reset your password
Reason
The heading predicts the task.

LAKA

Smallest sufficient intervention
Yes
Primary axes

Sources

  • Principles of plain language — Digital.gov / U.S. General Services Administration link
    Design content so the intended audience can find, understand, and use it.
  • Writing for Web Accessibility — W3C Web Accessibility Initiative link
    Clear structure, descriptive labels, alternatives, and understandable content.
  • Developing Quality Technical Information — Michelle Carey; Moira Lanyi; Deirdre Longo; et al.
    Quality dimensions for usable technical information.
The raw rule record

Verbatim from 10-paragraph-document-rules.json. Also available at /v1/rules/STR-008.

{
  "id": "STR-008",
  "name": "Heading predicts content",
  "domain": "structure",
  "layer": "section",
  "strength": "hard_constraint",
  "human_logic": "IF a heading does not accurately predict its section, THEN rename the heading or repair the section ELSE retain.",
  "when": {
    "path": "section.heading_content_match",
    "operator": "eq",
    "value": false
  },
  "then": [
    {
      "action": "align",
      "target": "section.heading",
      "value_from": "section.primary_reader_question"
    },
    {
      "action": "flag",
      "target": "section",
      "message": "Choose whether the heading or content represents intended scope."
    }
  ],
  "else": [
    {
      "action": "retain",
      "target": "current_text",
      "reason": "No triggering condition is present."
    }
  ],
  "unless": [],
  "because": "A misleading heading damages navigation and trust.",
  "diagnostics": [],
  "examples": {},
  "source_ids": [
    "WEB-002",
    "WEB-005",
    "BK-024"
  ],
  "laka": {
    "smallest_sufficient_intervention": true,
    "primary_axes": [
      "scope",
      "depth",
      "magnitude",
      "reversibility"
    ]
  }
}

Other structure rules

  1. STR-001 One controlling move per paragraph IF a paragraph performs more than one unrelated rhetorical move, THEN split it at the move boundary ELSE retain. Context default
  2. STR-002 Expose the paragraph point IF the paragraph’s controlling point is absent or recoverable only after rereading, THEN state or move it to a strategic position ELSE retain an intentional delayed reveal. Heuristic
  3. STR-003 Support consequential claims IF a paragraph makes a consequential factual claim, THEN provide evidence, cite it, qualify it, or remove the claim ELSE retain. Hard constraint
  4. STR-004 Keep evidence beside the claim IF evidence is separated from the claim it supports by unrelated material, THEN move it closer or label the relation ELSE retain. Context default
  5. STR-005 Use transitions that name the relation IF adjacent paragraphs have a meaningful but unstated relation, THEN add a transition that expresses that relation ELSE retain. Context default
  6. STR-006 Delete orphan paragraphs IF a paragraph neither advances the purpose nor supports another necessary move, THEN delete or relocate it ELSE retain. Heuristic
  7. STR-007 Section answers one reader question IF a section answers multiple unrelated reader questions, THEN split and label them ELSE retain. Context default
  8. STR-009 Maintain heading hierarchy IF heading levels skip or reflect visual size rather than logical nesting, THEN repair the hierarchy ELSE retain. Hard constraint