{
  "code": "S21",
  "name": "Contents",
  "shape": "contents",
  "family": "Openers and endings",
  "fits": "Three to five part titles, numbered, with one big word naming the list.",
  "use_when": "Showing the shape of the journey near the start: a short, scannable table of contents with titles only.",
  "slots": [
    {
      "name": "eyebrow",
      "holds": "what the list is, top left",
      "budget": "2-4 words"
    },
    {
      "name": "items",
      "holds": "3-5 rows on hairlines: mono number, part title, one Noto emoji at the right end (decks only)",
      "budget": "under 6 words each, no descriptions"
    },
    {
      "name": "word",
      "holds": "one huge word on the right naming the list",
      "budget": "1 word"
    }
  ],
  "columns": 2,
  "density": "airy",
  "surface": "paper",
  "works_on": [
    "deck",
    "page"
  ],
  "library": "Hoffman",
  "dir": "S21-agenda",
  "semantic": {
    "audience_question": "Which sections will I read, and in what order?",
    "intent": "See the route through the argument and find a named section.",
    "reasoning_relation": "contents and narrative order",
    "message_pattern": "We will establish [context], decide [choice], and agree [action].",
    "required_content": [
      "Three to five actual major sections.",
      "Accurate ordering and concise titles."
    ],
    "narrative_positions": [
      "opening"
    ],
    "requires_before": [
      "Introduce the proposal’s central promise."
    ],
    "enables_after": [
      "Begin the first section with the question the agenda names."
    ],
    "slot_roles": {
      "eyebrow": "Name the scope of this contents list.",
      "items": "Three to five ordered section names; optional decorative deck symbols do not carry essential information.",
      "word": "One organising label for the list."
    },
    "avoid_when": [
      "A short self-explanatory sequence",
      "A list of benefits masquerading as an agenda"
    ],
    "layout_specific_contract": "Three to five part titles, numbered, with one big word naming the list.",
    "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": "See the route through the argument and find a named section.",
    "matching": {
      "audience_question": "Which sections will I read, and in what order?",
      "reader_outcome": "See the route through the argument and find a named section.",
      "reasoning_relation": "contents and narrative order",
      "content_shape": {
        "composition": "Three to five part titles, numbered, with one big word naming the list.",
        "selected_state": "Three to five part titles, numbered, with one big word naming the list.",
        "density": "airy",
        "columns": 2,
        "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 scope of this contents list.",
          "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, top left]",
          "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": "items",
          "reader_question": "What does the items contribute to this page’s reader outcome?",
          "semantic_role": "Three to five ordered section names; optional decorative deck symbols do not carry essential information.",
          "content_unit_count": {
            "min": 3,
            "max": 5,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · items · 3-5 rows on hairlines: mono number, part title, one Noto emoji at the right end (decks only)]",
          "layout_budget": {
            "authored": "under 6 words each, no descriptions",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "items",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              55
            ]
          }
        },
        {
          "name": "word",
          "reader_question": "Which sections will I read, and in what order?",
          "semantic_role": "One organising label for the list.",
          "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 · word · one huge word on the right naming the list]",
          "layout_budget": {
            "authored": "1 word",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "word",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              1
            ]
          }
        }
      ],
      "rejection_constraints": [
        "A conclusion page masquerading as an agenda, or sections with no meaningful hierarchy.",
        "An agenda that promises decisions the material never reaches."
      ],
      "option_guidance": {
        "option": "default",
        "composition_delta": "Three to five part titles, numbered, with one big word naming the list.",
        "semantic_change": "retains base content relationship; changes presentation or disclosure",
        "matching_instruction": "Select S21 default when the supplied material answers “Which sections will I read, and in what order?” through contents and narrative order. Respect this state: Three to five part titles, numbered, with one big word naming the list."
      },
      "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": [
          "e371779721d777be42d951688f502c9c818f8c3d30e2b300cebcaa01509708f3"
        ],
        "source_export": "private source images remain outside this draft site",
        "markup_sha256": "73e6dc44d62b5b0424ccad004fe829f91d161bf1829bc0d966b870492ea55a0c",
        "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": [
      "A conclusion page masquerading as an agenda, or sections with no meaningful hierarchy.",
      "An agenda that promises decisions the material never reaches."
    ],
    "markup_inventory": {
      "file": "spread.html",
      "sha256": "73e6dc44d62b5b0424ccad004fe829f91d161bf1829bc0d966b870492ea55a0c",
      "method": "static lxml markup plus authored option description; no rendered-visibility claim",
      "all_markup_slot_counts": {
        "eyebrow": 1,
        "items": 1,
        "emoji": 4,
        "word": 1
      },
      "slot_evidence": {
        "eyebrow": [
          {
            "tag": "span",
            "classes": "eyebrow",
            "sample_word_count": 3,
            "repeated_children": 0
          }
        ],
        "items": [
          {
            "tag": "ol",
            "classes": "",
            "sample_word_count": 55,
            "repeated_children": 8
          }
        ],
        "emoji": [
          {
            "tag": "span",
            "classes": "accent",
            "sample_word_count": 1,
            "repeated_children": 0
          },
          {
            "tag": "span",
            "classes": "accent",
            "sample_word_count": 1,
            "repeated_children": 0
          },
          {
            "tag": "span",
            "classes": "accent",
            "sample_word_count": 1,
            "repeated_children": 0
          },
          {
            "tag": "span",
            "classes": "accent",
            "sample_word_count": 1,
            "repeated_children": 0
          }
        ],
        "word": [
          {
            "tag": "h2",
            "classes": "word",
            "sample_word_count": 1,
            "repeated_children": 0
          }
        ]
      },
      "option_selectors": [
        "toc"
      ],
      "linked_implementation": [
        {
          "file": "../spreads.css",
          "sha256": "32da94472b0c9131e4d5dae7d5bf0498b09202a9e66294b4e4f23e6ddfbf37ba"
        },
        {
          "file": "../spread.js",
          "sha256": "3d99948b83f750bd4ae95dac08e3e50a395de7c149c90a6f1a1c0ea36a2634a4"
        }
      ]
    },
    "variations": {
      "toc": {
        "audience_question": "Where can I find each section and subsection?",
        "intent": "Navigate a genuine contents hierarchy with accurate page references.",
        "reader_outcome": "Navigate a genuine contents hierarchy with accurate page references.",
        "reasoning_relation": "section hierarchy and location reference",
        "slot_roles": {
          "word": "Visible organising title above the contents.",
          "items": "Ordered main entries and indented subentries with genuine page references; hide neither crucial destination nor hierarchy."
        },
        "matching": {
          "audience_question": "Where can I find each section and subsection?",
          "reader_outcome": "Navigate a genuine contents hierarchy with accurate page references.",
          "reasoning_relation": "section hierarchy and location reference",
          "content_shape": {
            "composition": "Three to five part titles, numbered, with one big word naming the list.",
            "selected_state": "Table of contents: small title above one centred column, indented sub-entries, hairline leaders to page numbers",
            "density": "airy",
            "columns": 2,
            "column_note": "Base metadata only; selected option can replace the base geometry."
          },
          "required_slots": [
            {
              "name": "word",
              "reader_question": "Which sections will I read, and in what order?",
              "semantic_role": "Visible organising title above the contents.",
              "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 · word · one huge word on the right naming the list]",
              "layout_budget": {
                "authored": "1 word",
                "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
              },
              "markup": {
                "slot": "word",
                "occurrences": 1,
                "annotation_status": "present",
                "visibility_status": "not asserted from static parsing",
                "sample_word_counts": [
                  1
                ]
              }
            },
            {
              "name": "items",
              "reader_question": "What does the items contribute to this page’s reader outcome?",
              "semantic_role": "Ordered main entries and indented subentries with genuine page references; hide neither crucial destination nor hierarchy.",
              "content_unit_count": {
                "min": 3,
                "max": 5,
                "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
              },
              "placeholder": "[REAL CONTENT · items · 3-5 rows on hairlines: mono number, part title, one Noto emoji at the right end (decks only)]",
              "layout_budget": {
                "authored": "under 6 words each, no descriptions",
                "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
              },
              "markup": {
                "slot": "items",
                "occurrences": 1,
                "annotation_status": "present",
                "visibility_status": "not asserted from static parsing",
                "sample_word_counts": [
                  55
                ]
              }
            }
          ],
          "rejection_constraints": [
            "Invented page numbers or arbitrary indentation implying a false hierarchy.",
            "An agenda that promises decisions the material never reaches."
          ],
          "option_guidance": {
            "option": "toc",
            "composition_delta": "Table of contents: small title above one centred column, indented sub-entries, hairline leaders to page numbers",
            "semantic_change": "changes content relationship",
            "matching_instruction": "Select S21 toc when the supplied material answers “Where can I find each section and subsection?” through section hierarchy and location reference. Respect this state: Table of contents: small title above one centred column, indented sub-entries, hairline leaders to page numbers"
          },
          "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": [
              "e371779721d777be42d951688f502c9c818f8c3d30e2b300cebcaa01509708f3"
            ],
            "source_export": "private source images remain outside this draft site",
            "markup_sha256": "73e6dc44d62b5b0424ccad004fe829f91d161bf1829bc0d966b870492ea55a0c",
            "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": "eyebrow",
              "reader_question": "What kind of content or argument section am I reading?",
              "semantic_role": "what the list is, top left",
              "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, top left]",
              "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": "items",
              "reader_question": "What does the items contribute to this page’s reader outcome?",
              "semantic_role": "3-5 rows on hairlines: mono number, part title, one Noto emoji at the right end (decks only)",
              "content_unit_count": {
                "min": 3,
                "max": 5,
                "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
              },
              "placeholder": "[REAL CONTENT · items · 3-5 rows on hairlines: mono number, part title, one Noto emoji at the right end (decks only)]",
              "layout_budget": {
                "authored": "under 6 words each, no descriptions",
                "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
              },
              "markup": {
                "slot": "items",
                "occurrences": 1,
                "annotation_status": "present",
                "visibility_status": "not asserted from static parsing",
                "sample_word_counts": [
                  55
                ]
              }
            }
          ],
          "contract_correction": {
            "date": "2026-10-13",
            "basis": "Actual selected HTML/CSS inspection; previous required slots retained for review.",
            "records": [
              {
                "code": "S21",
                "option": "toc",
                "slots": [
                  "items"
                ]
              },
              {
                "code": "S21",
                "option": "toc",
                "slots": [
                  "word",
                  "items"
                ],
                "reason": "Visible title/identity is part of the selected arrangement."
              }
            ]
          }
        },
        "narrative_profile": {
          "central_point": "Sections and subsections can be found at their actual locations.",
          "communication_job": "Provide a usable document index with hierarchy and page references.",
          "audience_value": "Orientation: reduces the effort of locating material and distinguishes a section from its subtopics.",
          "reading_path": [
            "Read the visible contents title.",
            "Scan main entries, then indented subentries.",
            "Follow the correct page or route reference; numbers identify location, not importance."
          ],
          "adaptation": {
            "required_inputs": [
              "Actual document sections and subsections.",
              "Accurate page or route destinations.",
              "Stable titles matching the destination headings."
            ],
            "slot_guidance": {
              "word": "Visible organising title above the contents.",
              "items": "Ordered main entries and indented subentries with genuine page references; hide neither crucial destination nor hierarchy."
            },
            "can_change": [
              "Entry titles and current page references.",
              "Subentry count matching actual document structure."
            ],
            "must_survive": [
              "Visible title and actual destinations.",
              "Subentries stay beneath their correct parents.",
              "The base eyebrow is hidden and cannot carry necessary context."
            ]
          },
          "worked_example": {
            "fictional": true,
            "scenario": "Fictional repair cooperative, used only to demonstrate this selected communication job.",
            "slot_fills": {
              "word": "Contents",
              "items": [
                "01 Why bookings fail — p2",
                "02 What readiness means — p4; 2.1 Diagnosis — p5; 2.2 Parts — p6",
                "03 How the pilot works — p8; 3.1 Exceptions — p9",
                "04 What we will measure — p11"
              ]
            },
            "reasoning": "The hierarchy lets a reader jump to the specific parts-check discussion without confusing it with the whole readiness section.",
            "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 document and its purpose.",
            "after": "Open the section the reader needs.",
            "good_uses": [
              "A longer read-ahead document",
              "A reference-rich pitch",
              "A report with nested sections"
            ],
            "poor_fits": [
              "Invented page numbers",
              "An agenda without stable locations"
            ]
          },
          "evidence": {
            "observations": [
              "Current selected-option markup, CSS and contract were inspected: Provide a usable document index with hierarchy and page references."
            ],
            "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/S21-agenda/spread.html",
              "dist/S21-agenda/spread.json",
              "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html"
            ]
          },
          "review": {
            "status": "reviewed",
            "basis": "Reviewed selected option CSS, corrected matching contract and fictional example: the visible word title and items are mapped; the hidden eyebrow is excluded. This is a layout-contract review, not source-author confirmation."
          },
          "variation_relationship": "different-job"
        },
        "required_content": [
          "Actual document sections and subsections.",
          "Accurate page or route destinations.",
          "Stable titles matching the destination headings."
        ],
        "requires_before": [
          "Introduce the document and its purpose."
        ],
        "enables_after": [
          "Open the section the reader needs."
        ],
        "avoid_when": [
          "Invented page numbers",
          "An agenda without stable locations"
        ]
      }
    },
    "narrative_profile": {
      "central_point": "The audience can see the route through the story before taking it.",
      "communication_job": "Provide a short map of the authored sequence.",
      "audience_value": "Orientation: reduces uncertainty about scope and helps readers locate a later section.",
      "reading_path": [
        "Read the list label and large organising word.",
        "Scan numbered section titles in the order the argument will follow.",
        "Use titles to anticipate questions, without treating the agenda as evidence."
      ],
      "adaptation": {
        "required_inputs": [
          "Three to five actual major sections.",
          "Accurate ordering and concise titles."
        ],
        "slot_guidance": {
          "eyebrow": "Name the scope of this contents list.",
          "items": "Three to five ordered section names; optional decorative deck symbols do not carry essential information.",
          "word": "One organising label for the list."
        },
        "can_change": [
          "Section names and three-to-five count.",
          "The supported contents option when page references matter."
        ],
        "must_survive": [
          "Titles correspond to actual sections.",
          "Order matches the real argument."
        ]
      },
      "worked_example": {
        "fictional": true,
        "scenario": "Fictional repair cooperative proposal; all events, people and evidence are invented teaching material.",
        "slot_fills": {
          "eyebrow": "In this proposal",
          "items": [
            "01 Why bookings fail",
            "02 What readiness means",
            "03 How the pilot works",
            "04 What we will measure"
          ],
          "word": "Contents"
        },
        "reasoning": "The map moves from diagnosis to definition, method and evaluation, so each later section has a clear role.",
        "qualification": "Fictional teaching example only. Proposed benefits and results are not verified; replace with authorised material for a real use."
      },
      "narrative_fit": {
        "before": "Introduce the proposal’s central promise.",
        "after": "Begin the first section with the question the agenda names.",
        "good_uses": [
          "A substantial pitch",
          "A long visual story",
          "A document needing way-finding"
        ],
        "poor_fits": [
          "A short self-explanatory sequence",
          "A list of benefits masquerading as an agenda"
        ]
      },
      "evidence": {
        "observations": [
          "Viewed source: four numbered agenda rows under a small label, with one oversized organising word beside them.",
          "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/S21-agenda/source.webp",
          "dist/S21-agenda/spread.html",
          "dist/S21-agenda/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": "toc",
      "what": "Table of contents: small title above one centred column, indented sub-entries, hairline leaders to page numbers"
    }
  ],
  "also_seen_in": [],
  "source": {
    "ref": "Hoffman L03 Agenda",
    "url": "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html"
  }
}