Bow Tie Kreative Writing System
Run the engine

Rules / accessibility

ACC-006 Hard constraint layer: document

Headings and labels are unique and descriptive

IF repeated or vague headings prevent out-of-context identification, THEN rename them by topic or task ELSE retain.

Why the rule exists

Screen-reader and scanning navigation often presents headings out of surrounding context.

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.

  • ANY
    • document.duplicate_heading_count gt 0
    • document.vague_heading_count gt 0

Facts this rule reads

PathSource
document.duplicate_heading_count You supply it
document.vague_heading_count You supply it

Then

  1. rename — target document.headings

Else

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

Test cases

TST-019 · [object Object]

Before
Heading: Details
After
Heading: Eligibility requirements
Reason
The heading works out of context.

LAKA

Smallest sufficient intervention
Yes
Primary axes

Sources

  • Writing for Web Accessibility — W3C Web Accessibility Initiative link
    Clear structure, descriptive labels, alternatives, and understandable content.
  • Web Content Accessibility Guidelines 2.2 — W3C link
    Testable accessibility requirements for web content.
The raw rule record

Verbatim from 17-accessibility-rules.json. Also available at /v1/rules/ACC-006.

{
  "id": "ACC-006",
  "name": "Headings and labels are unique and descriptive",
  "domain": "accessibility",
  "layer": "document",
  "strength": "hard_constraint",
  "human_logic": "IF repeated or vague headings prevent out-of-context identification, THEN rename them by topic or task ELSE retain.",
  "when": {
    "any": [
      {
        "path": "document.duplicate_heading_count",
        "operator": "gt",
        "value": 0
      },
      {
        "path": "document.vague_heading_count",
        "operator": "gt",
        "value": 0
      }
    ]
  },
  "then": [
    {
      "action": "rename",
      "target": "document.headings",
      "pattern": "specific_topic_or_task"
    }
  ],
  "else": [
    {
      "action": "retain",
      "target": "current_text",
      "reason": "No triggering condition is present."
    }
  ],
  "unless": [],
  "because": "Screen-reader and scanning navigation often presents headings out of surrounding context.",
  "diagnostics": [],
  "examples": {},
  "source_ids": [
    "WEB-005",
    "WEB-007"
  ],
  "laka": {
    "smallest_sufficient_intervention": true,
    "primary_axes": [
      "scope",
      "depth",
      "magnitude",
      "reversibility"
    ]
  }
}

Other accessibility rules

  1. ACC-001 Use clear words for the actual audience IF a simpler word is equally accurate, respectful, and familiar, THEN use it ELSE retain the necessary precise term with support. Context default
  2. ACC-002 Simple tense and voice when possible IF present active construction expresses the real time and actor, THEN prefer it ELSE use the tense and voice accuracy requires. Context default
  3. ACC-003 No nested double negatives IF a double negative or negative inside another condition obscures polarity, THEN rewrite with one explicit positive or negative operation ELSE retain a necessary legal distinction with explanation. Hard constraint
  4. ACC-004 Separate each instruction IF multiple actions appear in one block and can be completed separately, THEN make each a separate step ELSE retain a single compound action. Context default
  5. ACC-005 Explain implied meaning when consequential IF humor, irony, metaphor, convention, or context carries a consequential instruction or conclusion, THEN state the literal meaning too ELSE retain. Hard constraint
  6. ACC-007 Text alternatives convey function or information IF meaningful non-text content appears, THEN provide a concise equivalent of its purpose and relevant information; IF decorative, mark it ignorable ELSE block release. Hard constraint
  7. ACC-008 Do not encode meaning by color alone IF color distinguishes status, category, instruction, or error, THEN add text, shape, icon, pattern, or position with an accessible label ELSE retain. Hard constraint
  8. ACC-009 Avoid directional text without structural anchor IF instructions say above, below, left, right, or color-only location and layout can reflow, THEN name the control, section, or landmark ELSE retain stable spatial instruction. Hard constraint