{ "code": "S41", "name": "Matched pairs", "shape": "matched-pairs", "family": "Lists and comparisons", "fits": "Three or four lines in someone's own voice on the left, each answered one-to-one by a short label on the right.", "use_when": "When every concern has a matching answer. Keep the left side in the speaker's or source's words, short.", "slots": [ { "name": "eyebrow-left", "holds": "what the left column is", "budget": "2-3 words" }, { "name": "eyebrow-right", "holds": "what the right column is", "budget": "2-3 words" }, { "name": "lines", "holds": "3-4 italic lines in quotes, hairlines between", "budget": "under 10 words each" }, { "name": "answers", "holds": "3-4 lime labels, one per line, same order", "budget": "under 4 words each" } ], "columns": 2, "density": "airy", "surface": "plum", "works_on": [ "deck", "page" ], "library": "Hoffman", "dir": "S41-pain-vs-solutions", "semantic": { "audience_question": "What response corresponds to each expressed need?", "intent": "Trace each left-hand statement to its matching right-hand response.", "reasoning_relation": "one-to-one mapping", "message_pattern": "You need [requirement]. Our response is [specific action and reason].", "required_content": [ "Three or four distinct concerns.", "One directly relevant response for each.", "Verified wording if quotes are presented as real; otherwise disclose illustrative wording." ], "narrative_positions": [ "context", "explanation", "evidence: choose only when the page supports the surrounding argument" ], "requires_before": [ "Show the research or explicitly identify these as hypotheses." ], "enables_after": [ "Explain and test the mechanism behind each response." ], "slot_roles": { "eyebrow-left": "Identify whether the lines are observed concerns, quotations or fictional examples.", "eyebrow-right": "Identify the status of the responses: proposed, available or tested.", "lines": "Three or four short concerns in parallel order.", "answers": "Exactly one response per concern in the same order." }, "avoid_when": [ "Many-to-many dependencies", "Unrelated service names", "Fictional quotes presented as research" ], "layout_specific_contract": "Three or four lines in someone's own voice on the left, each answered one-to-one by a short label on the right.", "provenance": { "basis": "interpretation of the existing layout and slot contracts", "review": "Tessel model-authored guidance; implementation approved by Nic, 2026-10-10", "corpus_evidence_status": "not yet established", "guide": "../SEMANTICS.md" }, "variation_rule": "Read the selected option’s actual markup, slot count and source record. Preserve this reasoning relationship only if the option still expresses it; flag a mismatch before adapting.", "reader_outcome": "Trace each left-hand statement to its matching right-hand response.", "matching": { "audience_question": "What response corresponds to each expressed need?", "reader_outcome": "Trace each left-hand statement to its matching right-hand response.", "reasoning_relation": "one-to-one mapping", "content_shape": { "composition": "Three or four lines in someone's own voice on the left, each answered one-to-one by a short label on the right.", "selected_state": "Three or four lines in someone's own voice on the left, each answered one-to-one by a short label on the right.", "density": "airy", "columns": 2, "column_note": "Base metadata only; selected option can replace the base geometry." }, "required_slots": [ { "name": "eyebrow-left", "reader_question": "What does the eyebrow left contribute to this page’s reader outcome?", "semantic_role": "Identify whether the lines are observed concerns, quotations or fictional examples.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · eyebrow-left · what the left column is]", "layout_budget": { "authored": "2-3 words", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "eyebrow-left", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 3 ] } }, { "name": "eyebrow-right", "reader_question": "What does the eyebrow right contribute to this page’s reader outcome?", "semantic_role": "Identify the status of the responses: proposed, available or tested.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · eyebrow-right · what the right column is]", "layout_budget": { "authored": "2-3 words", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "eyebrow-right", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 3 ] } }, { "name": "lines", "reader_question": "Which precise person, meaning, statement or response is being identified?", "semantic_role": "Three or four short concerns in parallel order.", "content_unit_count": { "min": 3, "max": 4, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · lines · 3-4 italic lines in quotes, hairlines between]", "layout_budget": { "authored": "under 10 words each", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "lines", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 24 ] } }, { "name": "answers", "reader_question": "Which precise person, meaning, statement or response is being identified?", "semantic_role": "Exactly one response per concern in the same order.", "content_unit_count": { "min": 3, "max": 4, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · answers · 3-4 lime labels, one per line, same order]", "layout_budget": { "authored": "under 4 words each", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "answers", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 17 ] } } ], "rejection_constraints": [ "Many-to-many relationships, paraphrases passed off as quotes or missing pair members.", "Paraphrasing the brief as the answer or claiming coverage without a delivery mechanism." ], "option_guidance": { "option": "default", "composition_delta": "Three or four lines in someone's own voice on the left, each answered one-to-one by a short label on the right.", "semantic_change": "retains base content relationship; changes presentation or disclosure", "matching_instruction": "Select S41 default when the supplied material answers “What response corresponds to each expressed need?” through one-to-one mapping. Respect this state: Three or four lines in someone's own voice on the left, each answered one-to-one by a short label on the right." }, "provenance": { "status": "inferred composition evidence", "author_intent": "not independently confirmed", "basis": [ "retained source composition where available", "authored layout and slot contracts", "static implementation inspection" ], "source_visual_count": 1, "source_visual_sha256": [ "2f524025001d7a5104be7f5b0f2408a27179fbea4b2189471799c2d2edeeef4b" ], "source_export": "private source images remain outside this draft site", "markup_sha256": "09124bdf6b1fc4b4d2a7abcccb80e590498b53da479d5afa7393a4ee31df12b6", "limits": [ "Static parsing inventories authored nodes; it does not certify rendered visibility, responsive fit or interactive state.", "Budgets are authored layout guidance, not a content-writing limit or proof of fit.", "Matching guidance is a draft inference; it does not establish facts, endorsement, causation or source author intent." ] }, "adaptation_rules": [ "Choose by audience question, reasoning relation and required content before aesthetic preference.", "Supply every required semantic role; retain visible unknowns as labelled real-content placeholders.", "A number needs source, scope and units; a quotation needs faithful wording and attribution.", "Do not infer importance from area, colour, depth or movement unless the content explicitly defines that encoding.", "Keep colour token roles, structural objects, licences and source records; changing content does not authorize changing them." ] }, "rejection_constraints": [ "Many-to-many relationships, paraphrases passed off as quotes or missing pair members.", "Paraphrasing the brief as the answer or claiming coverage without a delivery mechanism." ], "markup_inventory": { "file": "spread.html", "sha256": "09124bdf6b1fc4b4d2a7abcccb80e590498b53da479d5afa7393a4ee31df12b6", "method": "static lxml markup plus authored option description; no rendered-visibility claim", "all_markup_slot_counts": { "eyebrow-left": 1, "eyebrow-right": 1, "lines": 1, "answers": 1, "glossary": 1, "title": 1, "intro": 1, "terms": 1 }, "slot_evidence": { "eyebrow-left": [ { "tag": "span", "classes": "eyebrow", "sample_word_count": 3, "repeated_children": 0 } ], "eyebrow-right": [ { "tag": "span", "classes": "eyebrow ink-lime", "sample_word_count": 3, "repeated_children": 0 } ], "lines": [ { "tag": "div", "classes": "lines", "sample_word_count": 24, "repeated_children": 4 } ], "answers": [ { "tag": "div", "classes": "answers", "sample_word_count": 17, "repeated_children": 4 } ], "glossary": [ { "tag": "div", "classes": "gloss", "sample_word_count": 76, "repeated_children": 3 } ], "title": [ { "tag": "h2", "classes": "head", "sample_word_count": 4, "repeated_children": 0 } ], "intro": [ { "tag": "p", "classes": "sub", "sample_word_count": 9, "repeated_children": 0 } ], "terms": [ { "tag": "dl", "classes": "", "sample_word_count": 63, "repeated_children": 12 } ] }, "option_selectors": [ "glossary" ], "linked_implementation": [ { "file": "../spreads.css", "sha256": "32da94472b0c9131e4d5dae7d5bf0498b09202a9e66294b4e4f23e6ddfbf37ba" }, { "file": "../spread.js", "sha256": "3d99948b83f750bd4ae95dac08e3e50a395de7c149c90a6f1a1c0ea36a2634a4" } ] }, "variations": { "glossary": { "audience_question": "What does each short term mean here?", "intent": "Look up a term’s paired definition without interpreting it as testimony.", "reader_outcome": "Look up a term’s paired definition without interpreting it as testimony.", "reasoning_relation": "term and definition", "slot_roles": { "title": "The terminology’s subject.", "intro": "Explain the context and why these distinctions matter.", "terms": "Term-definition pairs in the actual definition list; do not import the default concern/response slots." }, "matching": { "audience_question": "What does each short term mean here?", "reader_outcome": "Look up a term’s paired definition without interpreting it as testimony.", "reasoning_relation": "term and definition", "content_shape": { "composition": "Three or four lines in someone's own voice on the left, each answered one-to-one by a short label on the right.", "selected_state": "Glossary: centred title and intro, then rows of a small-caps term and its one-line definition on hairlines", "density": "airy", "columns": 2, "column_note": "Base metadata only; selected option can replace the base geometry." }, "required_slots": [ { "name": "title", "reader_question": "What does each short term mean here?", "semantic_role": "The terminology’s subject.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · title · The honest subject or governing point of this composition.]", "layout_budget": { "authored": "one complete title", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "title", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 4 ] } }, { "name": "intro", "reader_question": "What does the intro contribute to this page’s reader outcome?", "semantic_role": "Explain the context and why these distinctions matter.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · intro · Enough context to interpret this reference set without repeating its title.]", "layout_budget": { "authored": "one brief orienting sentence", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "intro", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 9 ] } }, { "name": "terms", "reader_question": "Which precise person, meaning, statement or response is being identified?", "semantic_role": "Term-definition pairs in the actual definition list; do not import the default concern/response slots.", "content_unit_count": { "min": 6, "max": 6, "basis": "Authored visible members in the selected arrangement; annotation occurrences can differ." }, "placeholder": "[REAL CONTENT · terms · Each term paired with its concise contextual definition.]", "layout_budget": { "authored": "one complete term-definition pair per authored row", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "terms", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 63 ] } } ], "rejection_constraints": [ "Definitions presented as quotes or terms whose meanings require longer context.", "Paraphrasing the brief as the answer or claiming coverage without a delivery mechanism." ], "option_guidance": { "option": "glossary", "composition_delta": "Glossary: centred title and intro, then rows of a small-caps term and its one-line definition on hairlines", "semantic_change": "changes content relationship", "matching_instruction": "Select S41 glossary when the supplied material answers “What does each short term mean here?” through term and definition. Respect this state: Glossary: centred title and intro, then rows of a small-caps term and its one-line definition on hairlines" }, "provenance": { "status": "inferred composition evidence", "author_intent": "not independently confirmed", "basis": [ "retained source composition where available", "authored layout and slot contracts", "static implementation inspection" ], "source_visual_count": 1, "source_visual_sha256": [ "2f524025001d7a5104be7f5b0f2408a27179fbea4b2189471799c2d2edeeef4b" ], "source_export": "private source images remain outside this draft site", "markup_sha256": "09124bdf6b1fc4b4d2a7abcccb80e590498b53da479d5afa7393a4ee31df12b6", "limits": [ "Static parsing inventories authored nodes; it does not certify rendered visibility, responsive fit or interactive state.", "Budgets are authored layout guidance, not a content-writing limit or proof of fit.", "Matching guidance is a draft inference; it does not establish facts, endorsement, causation or source author intent." ] }, "adaptation_rules": [ "Choose by audience question, reasoning relation and required content before aesthetic preference.", "Supply every required semantic role; retain visible unknowns as labelled real-content placeholders.", "A number needs source, scope and units; a quotation needs faithful wording and attribution.", "Do not infer importance from area, colour, depth or movement unless the content explicitly defines that encoding.", "Keep colour token roles, structural objects, licences and source records; changing content does not authorize changing them." ], "previous_required_slots": [ { "name": "title", "reader_question": "What does each short term mean here?", "semantic_role": "The honest subject or governing point of this composition.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · title · The honest subject or governing point of this composition.]", "layout_budget": { "authored": "one complete title", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "title", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 4 ] } }, { "name": "intro", "reader_question": "What does the intro contribute to this page’s reader outcome?", "semantic_role": "Enough context to interpret this reference set without repeating its title.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · intro · Enough context to interpret this reference set without repeating its title.]", "layout_budget": { "authored": "one brief orienting sentence", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "intro", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 9 ] } }, { "name": "terms", "reader_question": "Which precise person, meaning, statement or response is being identified?", "semantic_role": "Each term paired with its concise contextual definition.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · terms · Each term paired with its concise contextual definition.]", "layout_budget": { "authored": "one complete term-definition pair per authored row", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "terms", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 63 ] } } ], "contract_correction": { "date": "2026-10-13", "basis": "Actual selected HTML/CSS inspection; previous required slots retained for review.", "records": [ { "code": "S41", "option": "glossary", "counts": { "terms": 6 }, "reason": "Current authored repeated members inspected; count was previously one wrapper rather than its repeated content." } ] } }, "narrative_profile": { "central_point": "Each term is paired with the meaning it has in this particular discussion.", "communication_job": "Remove vocabulary ambiguity before the argument depends on it.", "audience_value": "Explanation: lets readers distinguish terms that might otherwise sound interchangeable.", "reading_path": [ "Read the subject and introductory scope.", "Find a term, then read its paired definition.", "Return to the argument using that definition consistently." ], "adaptation": { "required_inputs": [ "A bounded terminology set.", "Accurate definitions for this context.", "Sources for technical definitions when contested or consequential." ], "slot_guidance": { "title": "The terminology’s subject.", "intro": "Explain the context and why these distinctions matter.", "terms": "Term-definition pairs in the actual definition list; do not import the default concern/response slots." }, "can_change": [ "Terms and definitions with evidence where needed." ], "must_survive": [ "Each term maps to one contextual definition.", "Definitions are used consistently afterward.", "No default concern/answer pair is retained as hidden content." ] }, "worked_example": { "fictional": true, "scenario": "Fictional repair cooperative, used only to demonstrate this selected communication job.", "slot_fills": { "title": "What we mean by readiness", "intro": "Working definitions for the fictional repair pilot; these describe proposed operating states, not results.", "terms": [ "Reported fault: The customer’s description before inspection.", "Diagnosis: The technician’s assessment of the cause.", "Part available: The required component is confirmed for this job.", "Provisional booking: A requested slot with an unresolved readiness check.", "Confirmed appointment: A slot offered after the specified checks pass.", "Follow-up: A later check on the repair and customer experience." ] }, "reasoning": "The distinctions prevent a request from being counted as a confirmed appointment and a reported symptom from being treated as a diagnosis.", "qualification": "All names, stories, statements and numbers are invented teaching material; no real endorsement, research result or implemented service is asserted." }, "narrative_fit": { "before": "Introduce the unfamiliar vocabulary or measurement problem.", "after": "Use the definitions in the process, scope or evaluation.", "good_uses": [ "A technical explainer", "Operational definitions", "A reference appendix" ], "poor_fits": [ "A problem-solution argument", "A list of unrelated buzzwords" ] }, "evidence": { "observations": [ "Current selected-option markup, CSS and contract were inspected: Remove vocabulary ambiguity before the argument depends on it." ], "interpretations": [ "The guidance interprets the layout’s communication affordances; it does not assert source-author intent." ], "not_verified": [ "Original author intent, surrounding source sequence, sample factual claims and persuasion effects are not independently verified.", "Option source pixels and live interaction were not separately verified in this authoring pass." ], "references": [ "dist/S41-pain-vs-solutions/spread.html", "dist/S41-pain-vs-solutions/spread.json", "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html" ] }, "review": { "status": "reviewed", "basis": "Reviewed option layout-contract and full fictional mapping from actual implementation; not source-author or empirical validation." }, "variation_relationship": "different-job" }, "required_content": [ "A bounded terminology set.", "Accurate definitions for this context.", "Sources for technical definitions when contested or consequential." ], "requires_before": [ "Introduce the unfamiliar vocabulary or measurement problem." ], "enables_after": [ "Use the definitions in the process, scope or evaluation." ], "avoid_when": [ "A problem-solution argument", "A list of unrelated buzzwords" ] }, "capability-to-purpose": { "audience_question": "Why should the audience care what this capability does?", "intent": "The reader can connect each feature to a task it may help and identify what proof is still needed.", "reader_outcome": "The reader can connect each feature to a task it may help and identify what proof is still needed.", "reasoning_relation": "One capability maps to one qualified purpose; the mechanism supports the connection.", "message_pattern": "A capability becomes meaningful when its mechanism and intended user benefit are explicit.", "required_content": [ "An accurate product capability or a clearly fictional specification.", "A plausible mechanism linking that capability to a user task.", "Evidence for any claim about actual time, cost or performance gains." ], "narrative_positions": [ "Connect a product capability to a useful job." ], "requires_before": [ "Inspect a real communication specimen and identify what the feature description leaves unexplained." ], "enables_after": [ "Demonstrate the most important mechanism and define a test for its intended benefit." ], "slot_roles": { "eyebrow": "Identify this as fictional teaching material.", "headline": "State the communication point and its relevance.", "closing": "Land the implication or prepare the next unit.", "qualification": "Keep evidence status and material limitations visible.", "pairs": "Keep each capability with its intended purpose and supporting mechanism." }, "avoid_when": [ "Benefits that require capabilities the product does not have.", "Many-to-many causal dependencies flattened into pairs.", "Invented user quotations presented as research." ], "variation_rule": "Repeatable capability-purpose pairs; one-to-one mapping, not a fixed number.", "provenance": { "basis": "Reviewed fictional teaching reconstruction; confidential correspondence excluded.", "payload_sha256": "bdba0da222443007b65b8df284b21f1ae4e951856dcaf6a01be8bc2c72dc3fd7" }, "matching": { "id": "S41--capability-to-purpose", "code": "S41", "name": "Capability to purpose", "dir": "S41-pain-vs-solutions", "option": "capability-to-purpose", "files": { "html": "cases/sc-5096e3463d284a72928204fe5e46769f/spread.html", "preview": "cases/sc-5096e3463d284a72928204fe5e46769f/preview.webp", "case": "cases/sc-5096e3463d284a72928204fe5e46769f/case.json", "guide": "cases/sc-5096e3463d284a72928204fe5e46769f/index.html", "reuse": "cases/sc-5096e3463d284a72928204fe5e46769f/reuse.json", "prompt": "cases/sc-5096e3463d284a72928204fe5e46769f/prompt.txt", "storyboard": "cases/sc-5096e3463d284a72928204fe5e46769f/storyboard.md", "alternate_html": "cases/sc-5096e3463d284a72928204fe5e46769f/alternate.html", "alternate_case": "cases/sc-5096e3463d284a72928204fe5e46769f/alternate.case.json" }, "case_id": "SC-5096e3463d284a72928204fe5e46769f", "audience_question": "Why should the audience care what this capability does?", "reader_outcome": "The reader can connect each feature to a task it may help and identify what proof is still needed.", "reasoning_relation": "One capability maps to one qualified purpose; the mechanism supports the connection.", "content_shape": { "composition": "Matched-pair family with coupled, detail-bearing rows, informed by the glossary option; quotation styling removed.", "selected_state": "Capability to purpose", "cardinality": { "semantic": "Repeatable capability-purpose pairs; one-to-one mapping, not a fixed number.", "tested": [ 3, 4 ], "adaptation": "Preserve the relationship and all qualifications; new counts require an inspected populated instance." } }, "required_slots": [ { "name": "eyebrow", "reader_question": "Why should the audience care what this capability does?", "semantic_role": "Identify this as fictional teaching material.", "content_unit_count": { "min": 1, "max": 1, "basis": "This populated instance; see reuse.json for count alternatives." }, "layout_budget": { "authored": "Preserve complete meaning and qualifications; inspect the populated instance.", "policy": "Recompose when content does not fit; do not omit required content." }, "placeholder": "[AUTHORISED CONTENT: Identify this as fictional teaching material.]", "markup": { "slot": "eyebrow", "annotation_status": "present in selected case HTML" } }, { "name": "headline", "reader_question": "Why should the audience care what this capability does?", "semantic_role": "State the communication point and its relevance.", "content_unit_count": { "min": 1, "max": 1, "basis": "This populated instance; see reuse.json for count alternatives." }, "layout_budget": { "authored": "Preserve complete meaning and qualifications; inspect the populated instance.", "policy": "Recompose when content does not fit; do not omit required content." }, "placeholder": "[AUTHORISED CONTENT: State the communication point and its relevance.]", "markup": { "slot": "headline", "annotation_status": "present in selected case HTML" } }, { "name": "closing", "reader_question": "Why should the audience care what this capability does?", "semantic_role": "Land the implication or prepare the next unit.", "content_unit_count": { "min": 1, "max": 1, "basis": "This populated instance; see reuse.json for count alternatives." }, "layout_budget": { "authored": "Preserve complete meaning and qualifications; inspect the populated instance.", "policy": "Recompose when content does not fit; do not omit required content." }, "placeholder": "[AUTHORISED CONTENT: Land the implication or prepare the next unit.]", "markup": { "slot": "closing", "annotation_status": "present in selected case HTML" } }, { "name": "qualification", "reader_question": "Why should the audience care what this capability does?", "semantic_role": "Keep evidence status and material limitations visible.", "content_unit_count": { "min": 1, "max": 1, "basis": "This populated instance; see reuse.json for count alternatives." }, "layout_budget": { "authored": "Preserve complete meaning and qualifications; inspect the populated instance.", "policy": "Recompose when content does not fit; do not omit required content." }, "placeholder": "[AUTHORISED CONTENT: Keep evidence status and material limitations visible.]", "markup": { "slot": "qualification", "annotation_status": "present in selected case HTML" } }, { "name": "pairs", "reader_question": "Why should the audience care what this capability does?", "semantic_role": "Keep each capability with its intended purpose and supporting mechanism.", "content_unit_count": { "min": 3, "max": 3, "basis": "This populated instance; see reuse.json for count alternatives." }, "layout_budget": { "authored": "Preserve complete meaning and qualifications; inspect the populated instance.", "policy": "Recompose when content does not fit; do not omit required content." }, "placeholder": "[AUTHORISED CONTENT: Keep each capability with its intended purpose and supporting mechanism.]", "markup": { "slot": "pairs", "annotation_status": "present in selected case HTML" } } ], "rejection_constraints": [ "Benefits that require capabilities the product does not have.", "Many-to-many causal dependencies flattened into pairs.", "Invented user quotations presented as research." ], "option_guidance": [ "Keep every capability paired with its own purpose.", "Make the mechanism explicit rather than relying on a benefit adjective.", "Label outcomes as intended until tested." ], "provenance": { "basis": "Reviewed fictional teaching reconstruction; confidential correspondence excluded.", "payload_sha256": "bdba0da222443007b65b8df284b21f1ae4e951856dcaf6a01be8bc2c72dc3fd7" }, "adaptation_rules": [ "Keep every capability paired with its own purpose.", "Make the mechanism explicit rather than relying on a benefit adjective.", "Label outcomes as intended until tested." ], "format_readiness": { "html": "Static HTML checked at 1600x900, 960x540 and 390x844 on eight surfaces. 1600x900 fits a 16:9 canvas; compact/phone views reflow vertically. Text remains editable in HTML.", "pptx": "unverified", "pdf": "unverified", "motion": "complete static composition; no animation or interactive decision engine" }, "alternative": { "layout": "S100", "description": "Shows several capabilities supporting a shared purpose, but loses the one-to-one mapping. Use only for a genuinely collective mechanism.", "basis": "Current markup and contract comparison; alternative replacement not rendered." } }, "narrative_profile": { "central_point": "A capability becomes meaningful when its mechanism and intended user benefit are explicit.", "communication_job": "Connect a product capability to a useful job.", "audience_value": "Expose missing value explanations without upgrading proposed benefits into measured outcomes.", "reading_path": [ "Read the governing point.", "Follow the labelled relationship in the populated HTML; retain the condition and qualification.", "Use the closing beat to prepare the next unit." ], "adaptation": { "required_inputs": [ "An accurate product capability or a clearly fictional specification.", "A plausible mechanism linking that capability to a user task.", "Evidence for any claim about actual time, cost or performance gains." ], "slot_guidance": { "eyebrow": "Identify this as fictional teaching material.", "headline": "State the communication point and its relevance.", "closing": "Land the implication or prepare the next unit.", "qualification": "Keep evidence status and material limitations visible.", "pairs": "Keep each capability with its intended purpose and supporting mechanism." }, "can_change": [ "Authorised scenario, wording and presentation brand.", "Repeatable capability-purpose pairs; one-to-one mapping, not a fixed number." ], "must_survive": [ "Keep every capability paired with its own purpose.", "Make the mechanism explicit rather than relying on a benefit adjective.", "Label outcomes as intended until tested." ] }, "narrative_fit": { "before": "Inspect a real communication specimen and identify what the feature description leaves unexplained.", "after": "Demonstrate the most important mechanism and define a test for its intended benefit.", "good_uses": [ "If one feature serves several different jobs, split the case by audience or use a matrix with explicit many-to-many links." ], "poor_fits": [ "Benefits that require capabilities the product does not have.", "Many-to-many causal dependencies flattened into pairs.", "Invented user quotations presented as research." ] }, "worked_example": { "fictional": true, "scenario": "A fictional shared-kitchen booking service is explaining three proposed features to community organisers.", "slot_fills": { "eyebrow": [ "text: Fictional teaching example / Capability to purpose" ], "headline": [ "text: A feature matters when it helps someone act." ], "closing": [ "text: Choose one mechanism to demonstrate and test." ], "qualification": [ "text: Fictional teaching scenario, not observed results or an approved operating plan. Benefits are proposed. No measured reduction in travel, mistakes or missed tasks. Mechanism explanations must remain accessible in any final visual adaptation." ], "pairs": [ "capability: Display current kitchen availability.; purpose: Know before travelling.; mechanism: Current availability lets an organiser check whether a slot is open before leaving.", "capability: Keep one preparation checklist.; purpose: Spot unfinished preparation.; mechanism: One shared checklist makes uncompleted tasks visible to the whole organising team.", "capability: Send reminders to assigned roles.; purpose: Reach the responsible person.; mechanism: A role-specific reminder directs a task to its designated owner instead of the entire group." ] }, "reasoning": "The matched pairs identify why each capability matters, while the mechanism fields stop an attractive benefit label from substituting for reasoning.", "qualification": "Fictional teaching scenario, not observed results or an approved operating plan. Benefits are proposed. No measured reduction in travel, mistakes or missed tasks. Mechanism explanations must remain accessible in any final visual adaptation." }, "evidence": { "observations": [ "Reviewed fictional content, slot map and explicit independent HTML.", "See batch-02-review.json for measured render and gallery checks." ], "interpretations": [ "Expose missing value explanations without upgrading proposed benefits into measured outcomes." ], "not_verified": [ "Editable PowerPoint, PDF exports and audience effectiveness.", "Counts beyond the specifically checked instances." ], "references": [ "cases/sc-5096e3463d284a72928204fe5e46769f/case.json", "cases/sc-5096e3463d284a72928204fe5e46769f/reuse.json", "batch-02-review.json" ] }, "review": { "status": "reviewed", "basis": "Tessel reviewed the version-bound fictional meaning/privacy payload. Render and integration evidence are separately recorded." }, "variation_relationship": "different-job" } } }, "narrative_profile": { "central_point": "Each stated concern has one directly corresponding response.", "communication_job": "Show a precise need-to-response mapping.", "audience_value": "Explanation and reassurance: helps readers judge whether the proposed response actually addresses their concern.", "reading_path": [ "Read the two column labels to understand the relation.", "Read each concern and its answer on the same row.", "Check the response against the specific need; a short service label may need explanation on the next page." ], "adaptation": { "required_inputs": [ "Three or four distinct concerns.", "One directly relevant response for each.", "Verified wording if quotes are presented as real; otherwise disclose illustrative wording." ], "slot_guidance": { "eyebrow-left": "Identify whether the lines are observed concerns, quotations or fictional examples.", "eyebrow-right": "Identify the status of the responses: proposed, available or tested.", "lines": "Three or four short concerns in parallel order.", "answers": "Exactly one response per concern in the same order." }, "can_change": [ "Concerns and matched responses.", "Glossary option only when the job becomes definition." ], "must_survive": [ "Equal concern/response counts and stable order.", "No response without a matching need.", "A label alone is not proof the problem is solved." ] }, "worked_example": { "fictional": true, "scenario": "Fictional repair cooperative proposal; all events, people and evidence are invented teaching material.", "slot_fills": { "eyebrow-left": "Fictional concerns", "eyebrow-right": "Proposed responses", "lines": [ "“Will the part be there?”", "“Must I wait at home twice?”", "“What if repair is unsafe?”", "“Who explains a failed repair?”" ], "answers": [ "Parts confirmation", "Agreed access window", "Safety assessment", "Named follow-up owner" ] }, "reasoning": "Each response addresses a different source of uncertainty; the row alignment makes the one-to-one mapping auditable.", "qualification": "Fictional teaching example only. Proposed benefits and results are not verified; replace with authorised material for a real use." }, "narrative_fit": { "before": "Show the research or explicitly identify these as hypotheses.", "after": "Explain and test the mechanism behind each response.", "good_uses": [ "Need-to-solution mapping", "An objection-response overview", "A reframing with exact counterparts" ], "poor_fits": [ "Many-to-many dependencies", "Unrelated service names", "Fictional quotes presented as research" ] }, "evidence": { "observations": [ "Viewed source: four first-person pain statements are paired with four service labels; current HTML preserves one-to-one alignment but uses a framing contrast.", "Current HTML and active slot contract were inspected." ], "interpretations": [ "The guidance interprets the layout’s communication affordances; it does not assert source-author intent." ], "not_verified": [ "Original author intent, surrounding source sequence, sample factual claims and persuasion effects are not independently verified." ], "references": [ "02_product/spreads/S41-pain-vs-solutions/source.webp", "dist/S41-pain-vs-solutions/spread.html", "dist/S41-pain-vs-solutions/spread.json", "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html" ] }, "review": { "status": "reviewed", "basis": "Viewed retained source capture and inspected current markup/slot contract; reviewed reasoning and example mapping. This is layout-contract review, not source-intent confirmation." }, "variation_relationship": "base" } }, "options": [ { "id": "glossary", "what": "Glossary: centred title and intro, then rows of a small-caps term and its one-line definition on hairlines" }, { "id": "capability-to-purpose", "what": "A capability becomes meaningful when its mechanism and intended user benefit are explicit.", "label": "Capability to purpose", "surface": "paper", "files": { "html": "cases/sc-5096e3463d284a72928204fe5e46769f/spread.html", "preview": "cases/sc-5096e3463d284a72928204fe5e46769f/preview.webp", "case": "cases/sc-5096e3463d284a72928204fe5e46769f/case.json", "guide": "cases/sc-5096e3463d284a72928204fe5e46769f/index.html", "reuse": "cases/sc-5096e3463d284a72928204fe5e46769f/reuse.json", "prompt": "cases/sc-5096e3463d284a72928204fe5e46769f/prompt.txt", "storyboard": "cases/sc-5096e3463d284a72928204fe5e46769f/storyboard.md", "alternate_html": "cases/sc-5096e3463d284a72928204fe5e46769f/alternate.html", "alternate_case": "cases/sc-5096e3463d284a72928204fe5e46769f/alternate.case.json" }, "case_id": "SC-5096e3463d284a72928204fe5e46769f", "cardinality": { "semantic": "Repeatable capability-purpose pairs; one-to-one mapping, not a fixed number.", "tested": [ 3, 4 ], "adaptation": "Preserve the relationship and all qualifications; new counts require an inspected populated instance." } } ], "also_seen_in": [], "source": { "ref": "Hoffman L24b Pain vs Solutions", "url": "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html" } }