{ "code": "S40", "name": "Scope table", "shape": "table", "family": "Lists and comparisons", "fits": "A reference table: rows of items with a sub-line each, against two or three columns of ticks or counts.", "use_when": "The one place dense text is right: a schedule, a scope, what is in and what is out. Trim sub-lines to phrases.", "slots": [ { "name": "eyebrow", "holds": "what the table covers, with dates", "budget": "under 8 words" }, { "name": "table", "holds": "dark header row, then 3-6 rows of (item, sub-line) x 2-3 columns of ticks or counts", "budget": "item 6 words, sub-line under 12 words" } ], "columns": 3, "density": "dense", "surface": "paper", "works_on": [ "deck", "page" ], "library": "Hoffman", "dir": "S40-scope-table", "semantic": { "audience_question": "Exactly which items are included across these scopes, and in what quantity?", "intent": "Look up comparable inclusions using explicit column meanings and row definitions.", "reasoning_relation": "item-by-scope reference comparison", "message_pattern": "[Item] includes [specific deliverable or quantity] under [condition].", "required_content": [ "Two or three defined scopes or editions.", "Three to six deliverables with consistent units.", "A period, inclusion rules and any material exclusions." ], "narrative_positions": [ "context", "explanation", "evidence: choose only when the page supports the surrounding argument" ], "requires_before": [ "Agree the objective, proposed period and scope options." ], "enables_after": [ "Discuss resourcing, exclusions, acceptance criteria or approval." ], "slot_roles": { "eyebrow": "The scope and applicable period.", "table": "Header plus three-to-six rows: item and sub-line, then each scope’s inclusion or count. A tick means included only when that meaning is declared." }, "avoid_when": [ "Unbounded service promises", "Outcome evidence", "A calendar needing dependencies" ], "layout_specific_contract": "A reference table: rows of items with a sub-line each, against two or three columns of ticks or counts.", "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" }, "reader_outcome": "Look up comparable inclusions using explicit column meanings and row definitions.", "matching": { "audience_question": "Exactly which items are included across these scopes, and in what quantity?", "reader_outcome": "Look up comparable inclusions using explicit column meanings and row definitions.", "reasoning_relation": "item-by-scope reference comparison", "content_shape": { "composition": "A reference table: rows of items with a sub-line each, against two or three columns of ticks or counts.", "selected_state": "A reference table: rows of items with a sub-line each, against two or three columns of ticks or counts.", "density": "dense", "columns": 3, "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": "The scope and applicable period.", "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 table covers, with dates]", "layout_budget": { "authored": "under 8 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": [ 5 ] } }, { "name": "table", "reader_question": "What does the table contribute to this page’s reader outcome?", "semantic_role": "Header plus three-to-six rows: item and sub-line, then each scope’s inclusion or count. A tick means included only when that meaning is declared.", "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 · table · dark header row, then 3-6 rows of (item, sub-line) x 2-3 columns of ticks or counts]", "layout_budget": { "authored": "item 6 words, sub-line under 12 words", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "table", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 36 ] } } ], "rejection_constraints": [ "Vague ticks, incompatible quantities or important exclusions hidden in the sub-lines.", "Ambiguous checkmarks, hidden exclusions or a table used to imply a recommendation it does not support." ], "option_guidance": { "option": "default", "composition_delta": "A reference table: rows of items with a sub-line each, against two or three columns of ticks or counts.", "semantic_change": "retains base content relationship; changes presentation or disclosure", "matching_instruction": "Select S40 default when the supplied material answers “Exactly which items are included across these scopes, and in what quantity?” through item-by-scope reference comparison. Respect this state: A reference table: rows of items with a sub-line each, against two or three columns of ticks or counts." }, "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": [ "97d01ba542a7ff0e7a831b87529252b63db5bc738ac7520403f618c949c82e2a" ], "source_export": "private source images remain outside this draft site", "markup_sha256": "3975260cd7bd953a59799b19641f121795796b7daf757e77944ff5323c5cb850", "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": [ "Vague ticks, incompatible quantities or important exclusions hidden in the sub-lines.", "Ambiguous checkmarks, hidden exclusions or a table used to imply a recommendation it does not support." ], "markup_inventory": { "file": "spread.html", "sha256": "3975260cd7bd953a59799b19641f121795796b7daf757e77944ff5323c5cb850", "method": "static lxml markup plus authored option description; no rendered-visibility claim", "all_markup_slot_counts": { "eyebrow": 1, "table": 1 }, "slot_evidence": { "eyebrow": [ { "tag": "span", "classes": "eyebrow", "sample_word_count": 5, "repeated_children": 0 } ], "table": [ { "tag": "div", "classes": "stretch tbl", "sample_word_count": 36, "repeated_children": 4 } ] }, "option_selectors": [], "linked_implementation": [ { "file": "../spreads.css", "sha256": "32da94472b0c9131e4d5dae7d5bf0498b09202a9e66294b4e4f23e6ddfbf37ba" }, { "file": "../spread.js", "sha256": "3d99948b83f750bd4ae95dac08e3e50a395de7c149c90a6f1a1c0ea36a2634a4" } ] }, "variations": { "bounded-scope": { "audience_question": "What is included, what is extra, and what is still unresolved?", "intent": "The reader can identify included work, separately quoted additions and unresolved needs before agreement.", "reader_outcome": "The reader can identify included work, separately quoted additions and unresolved needs before agreement.", "reasoning_relation": "Line items classified by inclusion and commercial boundary with a shared scope definition.", "message_pattern": "A price or programme description is usable only when its units, period and exclusions are explicit.", "required_content": [ "Defined deliverables, units and period.", "An explicit inclusion/exclusion rule.", "Separate treatment for third-party costs and unresolved needs.", "Consistent arithmetic and currencies if a numeric offer is supplied." ], "narrative_positions": [ "Make the boundary of a proposed scope explicit." ], "requires_before": [ "Establish the desired programme and its necessary delivery activities." ], "enables_after": [ "Resolve uncovered requirements and any separate quotations before asking for commitment." ], "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.", "rows": "Bounded deliverables with explicit included and separately quoted work.", "scope-note": "Shared agreement still needed before the offer can be used." }, "avoid_when": [ "Unbounded service promises.", "A comparison whose columns use different periods or units.", "Synthetic prices presented as a real quote." ], "variation_rule": "Repeatable bounded deliverables; quantities are example content, never universal scope requirements.", "provenance": { "basis": "Reviewed fictional teaching reconstruction; confidential correspondence excluded.", "payload_sha256": "67cafa7d5168274a59188a0bda4508b43dd9be1bd701ecc20c77a69abeb58fa2" }, "matching": { "id": "S40--bounded-scope", "code": "S40", "name": "Bounded scope", "dir": "S40-scope-table", "option": "bounded-scope", "files": { "html": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/spread.html", "preview": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/preview.webp", "case": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/case.json", "guide": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/index.html", "reuse": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/reuse.json", "prompt": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/prompt.txt", "storyboard": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/storyboard.md", "alternate_html": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/alternate.html", "alternate_case": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/alternate.case.json" }, "case_id": "SC-063c7a365ed44e588aa4884fbdcd49fe", "audience_question": "What is included, what is extra, and what is still unresolved?", "reader_outcome": "The reader can identify included work, separately quoted additions and unresolved needs before agreement.", "reasoning_relation": "Line items classified by inclusion and commercial boundary with a shared scope definition.", "content_shape": { "composition": "S40 reference-table family with wide descriptive columns and labelled stacked rows instead of narrow tick/count columns.", "selected_state": "Bounded scope", "cardinality": { "semantic": "Repeatable bounded deliverables; quantities are example content, never universal scope requirements.", "tested": [ 4, 5 ], "adaptation": "Preserve the relationship and all qualifications; new counts require an inspected populated instance." } }, "required_slots": [ { "name": "eyebrow", "reader_question": "What is included, what is extra, and what is still unresolved?", "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": "What is included, what is extra, and what is still unresolved?", "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": "What is included, what is extra, and what is still unresolved?", "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": "What is included, what is extra, and what is still unresolved?", "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": "rows", "reader_question": "What is included, what is extra, and what is still unresolved?", "semantic_role": "Bounded deliverables with explicit included and separately quoted work.", "content_unit_count": { "min": 4, "max": 4, "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: Bounded deliverables with explicit included and separately quoted work.]", "markup": { "slot": "rows", "annotation_status": "present in selected case HTML" } }, { "name": "scope-note", "reader_question": "What is included, what is extra, and what is still unresolved?", "semantic_role": "Shared agreement still needed before the offer can be used.", "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: Shared agreement still needed before the offer can be used.]", "markup": { "slot": "scope-note", "annotation_status": "present in selected case HTML" } } ], "rejection_constraints": [ "Unbounded service promises.", "A comparison whose columns use different periods or units.", "Synthetic prices presented as a real quote." ], "option_guidance": [ "Every row has a defined unit or bounded activity.", "Inclusions and exclusions are not confused with outcomes.", "Separately quoted means neither included nor approved.", "The stated coverage must agree with the actual priced scope." ], "provenance": { "basis": "Reviewed fictional teaching reconstruction; confidential correspondence excluded.", "payload_sha256": "67cafa7d5168274a59188a0bda4508b43dd9be1bd701ecc20c77a69abeb58fa2" }, "adaptation_rules": [ "Every row has a defined unit or bounded activity.", "Inclusions and exclusions are not confused with outcomes.", "Separately quoted means neither included nor approved.", "The stated coverage must agree with the actual priced scope." ], "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": "S57", "description": "Useful for choosing among complete packages; misleading if it turns inclusions and exclusions within one offer into competing offers.", "basis": "Current markup and contract comparison; alternative replacement not rendered." } }, "narrative_profile": { "central_point": "A price or programme description is usable only when its units, period and exclusions are explicit.", "communication_job": "Make the boundary of a proposed scope explicit.", "audience_value": "Prevent a broad programme description from being mistaken for an all-inclusive commitment.", "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": [ "Defined deliverables, units and period.", "An explicit inclusion/exclusion rule.", "Separate treatment for third-party costs and unresolved needs.", "Consistent arithmetic and currencies if a numeric offer is supplied." ], "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.", "rows": "Bounded deliverables with explicit included and separately quoted work.", "scope-note": "Shared agreement still needed before the offer can be used." }, "can_change": [ "Authorised scenario, wording and presentation brand.", "Repeatable bounded deliverables; quantities are example content, never universal scope requirements." ], "must_survive": [ "Every row has a defined unit or bounded activity.", "Inclusions and exclusions are not confused with outcomes.", "Separately quoted means neither included nor approved.", "The stated coverage must agree with the actual priced scope." ] }, "narrative_fit": { "before": "Establish the desired programme and its necessary delivery activities.", "after": "Resolve uncovered requirements and any separate quotations before asking for commitment.", "good_uses": [ "If an essential requirement lies outside the core scope, flag the gap and request a revised proposal rather than endorsing the core as sufficient." ], "poor_fits": [ "Unbounded service promises.", "A comparison whose columns use different periods or units.", "Synthetic prices presented as a real quote." ] }, "worked_example": { "fictional": true, "scenario": "A fictional public-garden education programme distinguishes a bounded core programme from additional venue hire and optional research.", "slot_fills": { "eyebrow": [ "text: Fictional teaching example / Bounded scope" ], "headline": [ "text: Make the boundary of the offer visible." ], "closing": [ "text: Resolve essential gaps before agreeing the core scope." ], "qualification": [ "text: Fictional teaching scenario, not observed results or an approved operating plan. Invented counts demonstrate scope units, not a scaled historical quotation. This is a programme inclusion table, not an outcome forecast." ], "rows": [ "deliverable: Teaching sessions; core: Three sessions during the agreed term; separate: Additional sessions require a new quote.", "deliverable: Coordination; core: One planning meeting and one closing review; separate: Further meetings require agreement.", "deliverable: Venue hire; core: Not included; separate: Quote separately if required.", "deliverable: Participant research; core: Not included; separate: Optional study requires a separate brief." ], "scope-note": [ "text: This teaching example contains no real fees. The term dates, locations and acceptance criteria must be agreed before use." ] }, "reasoning": "Each row makes the boundary observable; additional services remain choices instead of being smuggled into the core offer.", "qualification": "Fictional teaching scenario, not observed results or an approved operating plan. Invented counts demonstrate scope units, not a scaled historical quotation. This is a programme inclusion table, not an outcome forecast." }, "evidence": { "observations": [ "Reviewed fictional content, slot map and explicit independent HTML.", "See batch-02-review.json for measured render and gallery checks." ], "interpretations": [ "Prevent a broad programme description from being mistaken for an all-inclusive commitment." ], "not_verified": [ "Editable PowerPoint, PDF exports and audience effectiveness.", "Counts beyond the specifically checked instances." ], "references": [ "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/case.json", "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/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": "Readers can see exactly which deliverables or items are included in each scope.", "communication_job": "Make commitments comparable and checkable.", "audience_value": "Reassurance and decision support: resolves uncertainty about inclusion, quantities and the time period covered.", "reading_path": [ "Read the period and table headers before cells.", "Read across each deliverable row to compare the same item in every scope.", "Distinguish inclusion ticks, counts, exclusions and unknowns using an explicit legend." ], "adaptation": { "required_inputs": [ "Two or three defined scopes or editions.", "Three to six deliverables with consistent units.", "A period, inclusion rules and any material exclusions." ], "slot_guidance": { "eyebrow": "The scope and applicable period.", "table": "Header plus three-to-six rows: item and sub-line, then each scope’s inclusion or count. A tick means included only when that meaning is declared." }, "can_change": [ "Deliverables, two-to-three scopes and period.", "Ticks or quantities with explicit meaning." ], "must_survive": [ "Every column uses the same row definitions.", "Planned commitments stay distinct from completion.", "Exclusions and unknowns are not left as unexplained blanks." ] }, "worked_example": { "fictional": true, "scenario": "Fictional repair cooperative proposal; all events, people and evidence are invented teaching material.", "slot_fills": { "eyebrow": "Fictional pilot scope · October 2026", "table": "Headers: Deliverable | North site | South site. Legend: Included means committed in this proposed pilot.\n\nReadiness checks | Before selected bookings | Included | Included\n\nResident interviews | Completed interviews planned | 3 | 3\n\nWeekly review | Exceptions and workload | 1 per week | 1 per week" }, "reasoning": "The same deliverable is compared across two sites; explicit units prevent a tick being mistaken for a count or a completed result.", "qualification": "Fictional teaching example only. Proposed benefits and results are not verified; replace with authorised material for a real use." }, "narrative_fit": { "before": "Agree the objective, proposed period and scope options.", "after": "Discuss resourcing, exclusions, acceptance criteria or approval.", "good_uses": [ "Scope of work", "Edition or market coverage", "A delivery commitment summary" ], "poor_fits": [ "Unbounded service promises", "Outcome evidence", "A calendar needing dependencies" ] }, "evidence": { "observations": [ "Viewed source: deliverable descriptions are crossed with two market columns containing ticks and counts, under a dated scope label.", "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/S40-scope-table/source.webp", "dist/S40-scope-table/spread.html", "dist/S40-scope-table/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": "bounded-scope", "what": "A price or programme description is usable only when its units, period and exclusions are explicit.", "label": "Bounded scope", "surface": "paper", "files": { "html": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/spread.html", "preview": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/preview.webp", "case": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/case.json", "guide": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/index.html", "reuse": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/reuse.json", "prompt": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/prompt.txt", "storyboard": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/storyboard.md", "alternate_html": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/alternate.html", "alternate_case": "cases/sc-063c7a365ed44e588aa4884fbdcd49fe/alternate.case.json" }, "case_id": "SC-063c7a365ed44e588aa4884fbdcd49fe", "cardinality": { "semantic": "Repeatable bounded deliverables; quantities are example content, never universal scope requirements.", "tested": [ 4, 5 ], "adaptation": "Preserve the relationship and all qualifications; new counts require an inspected populated instance." } } ], "also_seen_in": [], "source": { "ref": "Hoffman L24 Scope table", "url": "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html" } }