{"id":"CLR-015","name":"Use readability scores diagnostically","domain":"clarity","layer":"document","strength":"heuristic","human_logic":"IF a readability metric flags difficulty, THEN inspect vocabulary, syntax, concepts, and assumed knowledge; do not simplify solely to hit a number ELSE retain.","when":{"path":"document.readability_metric.flag","operator":"eq","value":true},"then":[{"action":"diagnose","target":"document","dimensions":["vocabulary","syntax","concept_density","knowledge_gap"]},{"action":"test_with_reader","target":"document"}],"else":[{"action":"retain","target":"current_text","reason":"No triggering condition is present."}],"unless":[],"because":"A formula estimates surface difficulty but cannot judge accuracy, dignity, or conceptual necessity.","diagnostics":[],"examples":{},"source_ids":["WEB-002","WEB-006","BK-008"],"laka":{"smallest_sufficient_intervention":true,"primary_axes":["scope","depth","magnitude","reversibility"]},"requires_facts":["document.readability_metric.flag"],"tests":[],"sources":[{"id":"WEB-002","title":"Principles of plain language","creator":"Digital.gov / U.S. General Services Administration","domain":"plain_language","type":"Government guidance","note":"Design content so the intended audience can find, understand, and use it.","url":"https://www.plainlanguage.gov/"},{"id":"WEB-006","title":"Making Content Usable for People with Cognitive and Learning Disabilities","creator":"W3C","domain":"cognitive_accessibility","type":"W3C Working Group Note","note":"Clear words, simple voice and tense, explicit instructions, and supportive structure.","url":"https://www.w3.org/TR/coga-usable/"},{"id":"BK-008","title":"The Sense of Style","creator":"Steven Pinker","domain":"cognitive_style","type":"Book","note":"Reader-centered clarity informed by linguistics and cognition.","url":null}],"defined_in":{"file":"11-clarity-style-rules.json","title":"Clarity, Precision, and Plain-Language Rules","slug":"clarity-style-rules"}}