{
  "code": "S12",
  "name": "Numbered",
  "shape": "sequence",
  "family": "Lists and comparisons",
  "fits": "A lead line, then two to four short lines that build on each other.",
  "use_when": "A build: each line goes one step further than the last.",
  "slots": [
    {
      "name": "eyebrow",
      "holds": "what the list is",
      "budget": "2-4 words"
    },
    {
      "name": "head",
      "holds": "the lead line",
      "budget": "under 10 words"
    },
    {
      "name": "points",
      "holds": "3 x (big mono number, Noto emoji, short title, one sentence)",
      "budget": "sentence under 20 words"
    }
  ],
  "columns": 1,
  "density": "standard",
  "surface": "paper",
  "works_on": [
    "deck",
    "page"
  ],
  "library": "Hoffman",
  "dir": "S12-numbered",
  "semantic": {
    "audience_question": "What are the successive moves that build this answer?",
    "intent": "Follow numbered reasoning or instructions in their authored order.",
    "reasoning_relation": "ordered accumulation",
    "message_pattern": "First [step and purpose], then [step], leading to [outcome].",
    "required_content": [
      "Three short steps in the current markup.",
      "A reason for their order.",
      "A defined outcome and necessary conditions."
    ],
    "narrative_positions": [
      "context",
      "explanation",
      "evidence: choose only when the page supports the surrounding argument"
    ],
    "requires_before": [
      "Explain why confirming appointments too early causes difficulty."
    ],
    "enables_after": [
      "Assign owners and measurement to the proposed steps."
    ],
    "slot_roles": {
      "eyebrow": "Name the method or capability being explained.",
      "head": "State what the method is for.",
      "points": "Three numbered units: action title, concise explanation and optional deck symbol; do not imply time durations with the numbers."
    },
    "avoid_when": [
      "A detailed branching workflow",
      "Independent principles that do not need ordering"
    ],
    "layout_specific_contract": "A lead line, then two to four short lines that build on each other.",
    "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": "Follow numbered reasoning or instructions in their authored order.",
    "matching": {
      "audience_question": "What are the successive moves that build this answer?",
      "reader_outcome": "Follow numbered reasoning or instructions in their authored order.",
      "reasoning_relation": "ordered accumulation",
      "content_shape": {
        "composition": "A lead line, then two to four short lines that build on each other.",
        "selected_state": "A lead line, then two to four short lines that build on each other.",
        "density": "standard",
        "columns": 1,
        "column_note": "Base metadata only; selected option can replace the base geometry."
      },
      "required_slots": [
        {
          "name": "eyebrow",
          "reader_question": "What kind of content or argument section am I reading?",
          "semantic_role": "Name the method or capability being explained.",
          "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 · what the list is]",
          "layout_budget": {
            "authored": "2-4 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "eyebrow",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              3
            ]
          }
        },
        {
          "name": "head",
          "reader_question": "What are the successive moves that build this answer?",
          "semantic_role": "State what the method is for.",
          "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 · head · the lead line]",
          "layout_budget": {
            "authored": "under 10 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "head",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              4
            ]
          }
        },
        {
          "name": "points",
          "reader_question": "What does this distinct step, state, scenario or observation contribute?",
          "semantic_role": "Three numbered units: action title, concise explanation and optional deck symbol; do not imply time durations with the numbers.",
          "content_unit_count": {
            "min": 2,
            "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 · points · 3 x (big mono number, Noto emoji, short title, one sentence)]",
          "layout_budget": {
            "authored": "sentence under 20 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "points",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              32
            ]
          }
        }
      ],
      "rejection_constraints": [
        "An unordered set, or steps that each require a separate evidence page.",
        "Arbitrary numbered lists that imply chronology or causality."
      ],
      "option_guidance": {
        "option": "default",
        "composition_delta": "A lead line, then two to four short lines that build on each other.",
        "semantic_change": "retains base content relationship; changes presentation or disclosure",
        "matching_instruction": "Select S12 default when the supplied material answers “What are the successive moves that build this answer?” through ordered accumulation. Respect this state: A lead line, then two to four short lines that build on each other."
      },
      "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": [
          "b24cf643e3a1015ceae75f8c030dae1681820f371081e1aa36e1822bfabbd8ef"
        ],
        "source_export": "private source images remain outside this draft site",
        "markup_sha256": "719e084650dc3374d416c6c386ebb2125f9a38ca9eac3de19791d3312b334d80",
        "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": [
      "An unordered set, or steps that each require a separate evidence page.",
      "Arbitrary numbered lists that imply chronology or causality."
    ],
    "markup_inventory": {
      "file": "spread.html",
      "sha256": "719e084650dc3374d416c6c386ebb2125f9a38ca9eac3de19791d3312b334d80",
      "method": "static lxml markup plus authored option description; no rendered-visibility claim",
      "all_markup_slot_counts": {
        "eyebrow": 1,
        "head": 1,
        "points": 1
      },
      "slot_evidence": {
        "eyebrow": [
          {
            "tag": "span",
            "classes": "eyebrow",
            "sample_word_count": 3,
            "repeated_children": 0
          }
        ],
        "head": [
          {
            "tag": "h2",
            "classes": "head",
            "sample_word_count": 4,
            "repeated_children": 0
          }
        ],
        "points": [
          {
            "tag": "div",
            "classes": "vcols",
            "sample_word_count": 32,
            "repeated_children": 3
          }
        ]
      },
      "option_selectors": [],
      "linked_implementation": [
        {
          "file": "../spreads.css",
          "sha256": "32da94472b0c9131e4d5dae7d5bf0498b09202a9e66294b4e4f23e6ddfbf37ba"
        },
        {
          "file": "../spread.js",
          "sha256": "3d99948b83f750bd4ae95dac08e3e50a395de7c149c90a6f1a1c0ea36a2634a4"
        },
        {
          "file": "../motion.js",
          "sha256": "c994e23f63dc1e1dc0c500f2320dd123c0f0727ca7a077bd26e45ffa9a6154ea"
        }
      ]
    },
    "variations": {
      "stagger": {
        "audience_question": "What are the successive moves that build this answer?",
        "intent": "Follow numbered reasoning or instructions in their authored order.",
        "reader_outcome": "Follow numbered reasoning or instructions in their authored order.",
        "reasoning_relation": "ordered accumulation",
        "slot_roles": {
          "eyebrow": "Name the method or capability being explained.",
          "head": "State what the method is for.",
          "points": "Three numbered units: action title, concise explanation and optional deck symbol; do not imply time durations with the numbers."
        },
        "matching": {
          "audience_question": "What are the successive moves that build this answer?",
          "reader_outcome": "Follow numbered reasoning or instructions in their authored order.",
          "reasoning_relation": "ordered accumulation",
          "content_shape": {
            "composition": "A lead line, then two to four short lines that build on each other.",
            "selected_state": "Staggered points: the points rise in one after another, once, when they start below the fold (motion.line-stagger, 80ms apart; ../motion.js).",
            "density": "standard",
            "columns": 1,
            "column_note": "Base metadata only; selected option can replace the base geometry."
          },
          "required_slots": [
            {
              "name": "eyebrow",
              "reader_question": "What kind of content or argument section am I reading?",
              "semantic_role": "Name the method or capability being explained.",
              "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 · what the list is]",
              "layout_budget": {
                "authored": "2-4 words",
                "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
              },
              "markup": {
                "slot": "eyebrow",
                "occurrences": 1,
                "annotation_status": "present",
                "visibility_status": "not asserted from static parsing",
                "sample_word_counts": [
                  3
                ]
              }
            },
            {
              "name": "head",
              "reader_question": "What are the successive moves that build this answer?",
              "semantic_role": "State what the method is for.",
              "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 · head · the lead line]",
              "layout_budget": {
                "authored": "under 10 words",
                "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
              },
              "markup": {
                "slot": "head",
                "occurrences": 1,
                "annotation_status": "present",
                "visibility_status": "not asserted from static parsing",
                "sample_word_counts": [
                  4
                ]
              }
            },
            {
              "name": "points",
              "reader_question": "What does this distinct step, state, scenario or observation contribute?",
              "semantic_role": "Three numbered units: action title, concise explanation and optional deck symbol; do not imply time durations with the numbers.",
              "content_unit_count": {
                "min": 2,
                "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 · points · 3 x (big mono number, Noto emoji, short title, one sentence)]",
              "layout_budget": {
                "authored": "sentence under 20 words",
                "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
              },
              "markup": {
                "slot": "points",
                "occurrences": 1,
                "annotation_status": "present",
                "visibility_status": "not asserted from static parsing",
                "sample_word_counts": [
                  32
                ]
              }
            }
          ],
          "rejection_constraints": [
            "An unordered set, or steps that each require a separate evidence page.",
            "Arbitrary numbered lists that imply chronology or causality."
          ],
          "option_guidance": {
            "option": "stagger",
            "composition_delta": "Staggered points: the points rise in one after another, once, when they start below the fold (motion.line-stagger, 80ms apart; ../motion.js).",
            "semantic_change": "retains base content relationship; changes presentation or disclosure",
            "matching_instruction": "Select S12 stagger when the supplied material answers “What are the successive moves that build this answer?” through ordered accumulation. Respect this state: Staggered points: the points rise in one after another, once, when they start below the fold (motion.line-stagger, 80ms apart; ../motion.js)."
          },
          "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": [
              "b24cf643e3a1015ceae75f8c030dae1681820f371081e1aa36e1822bfabbd8ef"
            ],
            "source_export": "private source images remain outside this draft site",
            "markup_sha256": "719e084650dc3374d416c6c386ebb2125f9a38ca9eac3de19791d3312b334d80",
            "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."
          ]
        },
        "narrative_profile": {
          "central_point": "A few ordered actions build toward one named outcome.",
          "communication_job": "Explain a compact method in an intentional order. Reveals the same ordered points one after another; timing reinforces reading order without changing the method.",
          "audience_value": "Explanation: helps the audience understand what to do first and how later steps depend on earlier ones.",
          "reading_path": [
            "Read the lead line for the purpose of the sequence.",
            "Read numbered points from first to last.",
            "Check that each action hands something useful to the next."
          ],
          "adaptation": {
            "required_inputs": [
              "Three short steps in the current markup.",
              "A reason for their order.",
              "A defined outcome and necessary conditions."
            ],
            "slot_guidance": {
              "eyebrow": "Name the method or capability being explained.",
              "head": "State what the method is for.",
              "points": "Three numbered units: action title, concise explanation and optional deck symbol; do not imply time durations with the numbers."
            },
            "can_change": [
              "Step names and explanations.",
              "Decorative symbols or stagger timing without changing order.",
              "Reveals the same ordered points one after another; timing reinforces reading order without changing the method."
            ],
            "must_survive": [
              "The order is justified.",
              "All steps remain visible in complete and reduced-motion views.",
              "All steps remain available without animation; motion must not imply completion."
            ]
          },
          "worked_example": {
            "fictional": true,
            "scenario": "A fictional repair cooperative is preparing a pilot proposal; all people, events and data are teaching examples.",
            "slot_fills": {
              "eyebrow": "A dependable booking",
              "head": "Check readiness before promising a repair.",
              "points": [
                "01 Diagnose: Ask what failed and establish whether an inspection is needed.",
                "02 Prepare: Confirm the required part and technician are available.",
                "03 Promise: Offer an appointment only after those checks are complete."
              ]
            },
            "reasoning": "Diagnosis determines preparation; preparation earns the promise. The order is part of the method.",
            "qualification": "Fictional teaching example. Replace with authorised facts, evidence and destinations before delivery; no results or audience effect are claimed."
          },
          "narrative_fit": {
            "before": "Explain why confirming appointments too early causes difficulty.",
            "after": "Assign owners and measurement to the proposed steps.",
            "good_uses": [
              "A short process",
              "An ordered explanation",
              "A method summary"
            ],
            "poor_fits": [
              "A detailed branching workflow",
              "Independent principles that do not need ordering"
            ]
          },
          "evidence": {
            "observations": [
              "Current option markup/CSS and selected contract show: Reveals the same ordered points one after another; timing reinforces reading order without changing the method."
            ],
            "interpretations": [
              "Communication job, audience value and adaptation advice are layout-contract interpretations. They are not verified statements of source-author intent."
            ],
            "not_verified": [
              "Source-author intent, surrounding source sequence, sample factual claims and audience effect were not independently verified.",
              "Option source pixels and live interaction were not separately reviewed in this authoring pass."
            ],
            "references": [
              "dist/S12-numbered/spread.html",
              "dist/S12-numbered/spread.json",
              "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html"
            ]
          },
          "review": {
            "status": "reviewed",
            "basis": "Reviewed actual option markup, selected contract and example mapping; source intent and interaction fidelity not asserted."
          },
          "variation_relationship": "same-job"
        },
        "required_content": [
          "Three short steps in the current markup.",
          "A reason for their order.",
          "A defined outcome and necessary conditions."
        ],
        "requires_before": [
          "Explain why confirming appointments too early causes difficulty."
        ],
        "enables_after": [
          "Assign owners and measurement to the proposed steps."
        ],
        "avoid_when": [
          "A detailed branching workflow",
          "Independent principles that do not need ordering"
        ]
      }
    },
    "narrative_profile": {
      "central_point": "A few ordered actions build toward one named outcome.",
      "communication_job": "Explain a compact method in an intentional order.",
      "audience_value": "Explanation: helps the audience understand what to do first and how later steps depend on earlier ones.",
      "reading_path": [
        "Read the lead line for the purpose of the sequence.",
        "Read numbered points from first to last.",
        "Check that each action hands something useful to the next."
      ],
      "adaptation": {
        "required_inputs": [
          "Three short steps in the current markup.",
          "A reason for their order.",
          "A defined outcome and necessary conditions."
        ],
        "slot_guidance": {
          "eyebrow": "Name the method or capability being explained.",
          "head": "State what the method is for.",
          "points": "Three numbered units: action title, concise explanation and optional deck symbol; do not imply time durations with the numbers."
        },
        "can_change": [
          "Step names and explanations.",
          "Decorative symbols or stagger timing without changing order."
        ],
        "must_survive": [
          "The order is justified.",
          "All steps remain visible in complete and reduced-motion views."
        ]
      },
      "worked_example": {
        "fictional": true,
        "scenario": "A fictional repair cooperative is preparing a pilot proposal; all people, events and data are teaching examples.",
        "slot_fills": {
          "eyebrow": "A dependable booking",
          "head": "Check readiness before promising a repair.",
          "points": [
            "01 Diagnose: Ask what failed and establish whether an inspection is needed.",
            "02 Prepare: Confirm the required part and technician are available.",
            "03 Promise: Offer an appointment only after those checks are complete."
          ]
        },
        "reasoning": "Diagnosis determines preparation; preparation earns the promise. The order is part of the method.",
        "qualification": "Fictional teaching example. Replace with authorised facts, evidence and destinations before delivery; no results or audience effect are claimed."
      },
      "narrative_fit": {
        "before": "Explain why confirming appointments too early causes difficulty.",
        "after": "Assign owners and measurement to the proposed steps.",
        "good_uses": [
          "A short process",
          "An ordered explanation",
          "A method summary"
        ],
        "poor_fits": [
          "A detailed branching workflow",
          "Independent principles that do not need ordering"
        ]
      },
      "evidence": {
        "observations": [
          "Viewed source: three numbered approach steps, each with a title and one supporting sentence.",
          "Current markup and the named slot contract were inspected."
        ],
        "interpretations": [
          "Communication job, audience value and adaptation advice are layout-contract interpretations. They are not verified statements of source-author intent."
        ],
        "not_verified": [
          "Source-author intent, surrounding source sequence, sample factual claims and audience effect were not independently verified."
        ],
        "references": [
          "02_product/spreads/S12-numbered/source.webp",
          "dist/S12-numbered/spread.html",
          "dist/S12-numbered/spread.json",
          "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html"
        ]
      },
      "review": {
        "status": "reviewed",
        "basis": "Viewed base source capture, inspected current markup/slots and reviewed the example for reasoning fit; no source-intent or empirical validation claim."
      },
      "variation_relationship": "base"
    }
  },
  "options": [
    {
      "id": "stagger",
      "what": "Staggered points: the points rise in one after another, once, when they start below the fold (motion.line-stagger, 80ms apart; ../motion.js)."
    }
  ],
  "also_seen_in": [],
  "source": {
    "ref": "Hoffman L37 Numbered points",
    "url": "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html"
  }
}