{
  "code": "S74",
  "name": "Venn",
  "shape": "venn",
  "family": "Lists and comparisons",
  "fits": "Two things that are each worth something alone and matter most where they overlap: two circles with a label each, and a caption pinned to the overlap.",
  "use_when": "When the argument is the overlap: two forces, two audiences or two assets, and the point is what only exists where they meet.",
  "slots": [
    {
      "name": "title",
      "holds": "the page title, top left",
      "budget": "under 6 words"
    },
    {
      "name": "circle-a",
      "holds": "left circle: a label and up to two short dash lines",
      "budget": "label 3 words or fewer, lines under 6 words"
    },
    {
      "name": "circle-b",
      "holds": "right circle: a label (lines optional)",
      "budget": "label 3 words or fewer"
    },
    {
      "name": "caption",
      "holds": "what the overlap is: a mono kicker and one large italic word, joined to a dot in the overlap by a leader line",
      "budget": "kicker 3 words, word 1-2 words"
    }
  ],
  "columns": 1,
  "density": "airy",
  "surface": "paper",
  "works_on": [
    "deck",
    "page"
  ],
  "library": "Hoffman",
  "dir": "S74-venn",
  "semantic": {
    "audience_question": "What value exists where these two domains overlap?",
    "intent": "Distinguish each domain from their named intersection.",
    "reasoning_relation": "set intersection",
    "message_pattern": "[A] contributes [value], [B] contributes [value]; together they create [specific overlap].",
    "required_content": [
      "Two clearly defined domains.",
      "An explicit, defensible intersection."
    ],
    "narrative_positions": [
      "context",
      "explanation",
      "evidence: choose only when the page supports the surrounding argument"
    ],
    "requires_before": [
      "Define the practical barrier the two domains address."
    ],
    "enables_after": [
      "Show how the program supplies both and where its limits remain."
    ],
    "slot_roles": {
      "title": "Name the relationship being explained.",
      "circle-a": "Define the first domain and up to two clarifying attributes.",
      "circle-b": "Define the second domain on the same conceptual level.",
      "caption": "Name the intersection, with a short cue explaining why it is shared."
    },
    "avoid_when": [
      "A causal equation disguised as overlap.",
      "Quantitative set sizes without calibrated areas."
    ],
    "layout_specific_contract": "Two things that are each worth something alone and matter most where they overlap: two circles with a label each, and a caption pinned to the overlap.",
    "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": "Distinguish each domain from their named intersection.",
    "matching": {
      "audience_question": "What value exists where these two domains overlap?",
      "reader_outcome": "Distinguish each domain from their named intersection.",
      "reasoning_relation": "set intersection",
      "content_shape": {
        "composition": "Two things that are each worth something alone and matter most where they overlap: two circles with a label each, and a caption pinned to the overlap.",
        "selected_state": "Two things that are each worth something alone and matter most where they overlap: two circles with a label each, and a caption pinned to the overlap.",
        "density": "airy",
        "columns": 1,
        "column_note": "Base metadata only; selected option can replace the base geometry."
      },
      "required_slots": [
        {
          "name": "title",
          "reader_question": "What value exists where these two domains overlap?",
          "semantic_role": "Name the relationship 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 · title · the page title, top left]",
          "layout_budget": {
            "authored": "under 6 words",
            "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": "circle-a",
          "reader_question": "What does the circle a contribute to this page’s reader outcome?",
          "semantic_role": "Define the first domain and up to two clarifying attributes.",
          "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 · circle-a · left circle: a label and up to two short dash lines]",
          "layout_budget": {
            "authored": "label 3 words or fewer, lines under 6 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "circle-a",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              10
            ]
          }
        },
        {
          "name": "circle-b",
          "reader_question": "What does the circle b contribute to this page’s reader outcome?",
          "semantic_role": "Define the second domain on the same conceptual level.",
          "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 · circle-b · right circle: a label (lines optional)]",
          "layout_budget": {
            "authored": "label 3 words or fewer",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "circle-b",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              2
            ]
          }
        },
        {
          "name": "caption",
          "reader_question": "What does the caption contribute to this page’s reader outcome?",
          "semantic_role": "Name the intersection, with a short cue explaining why it is shared.",
          "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 · caption · what the overlap is: a mono kicker and one large italic word, joined to a dot in the overlap by a leader line]",
          "layout_budget": {
            "authored": "kicker 3 words, word 1-2 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "caption",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              4
            ]
          }
        }
      ],
      "rejection_constraints": [
        "A causal relationship, quantified overlap without data or an intersection that has no distinct meaning.",
        "Using overlap as evidence of synergy without explaining the mechanism."
      ],
      "option_guidance": {
        "option": "default",
        "composition_delta": "Two things that are each worth something alone and matter most where they overlap: two circles with a label each, and a caption pinned to the overlap.",
        "semantic_change": "retains base content relationship; changes presentation or disclosure",
        "matching_instruction": "Select S74 default when the supplied material answers “What value exists where these two domains overlap?” through set intersection. Respect this state: Two things that are each worth something alone and matter most where they overlap: two circles with a label each, and a caption pinned to the overlap."
      },
      "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": [
          "0e5d58e1c8155be43aa914e24c3bf7405856fc869f472e6bce838dfa64a4f807"
        ],
        "source_export": "private source images remain outside this draft site",
        "markup_sha256": "79417da18513c8a23889f2993283c88b1b99a1926c653fcf6a17932424c60ef7",
        "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 causal relationship, quantified overlap without data or an intersection that has no distinct meaning.",
      "Using overlap as evidence of synergy without explaining the mechanism."
    ],
    "markup_inventory": {
      "file": "spread.html",
      "sha256": "79417da18513c8a23889f2993283c88b1b99a1926c653fcf6a17932424c60ef7",
      "method": "static lxml markup plus authored option description; no rendered-visibility claim",
      "all_markup_slot_counts": {
        "title": 1,
        "diagram": 1,
        "caption": 1,
        "circle-a": 1,
        "circle-b": 1
      },
      "slot_evidence": {
        "title": [
          {
            "tag": "h2",
            "classes": "title",
            "sample_word_count": 4,
            "repeated_children": 0
          }
        ],
        "diagram": [
          {
            "tag": "div",
            "classes": "venn",
            "sample_word_count": 16,
            "repeated_children": 4
          }
        ],
        "caption": [
          {
            "tag": "div",
            "classes": "cap",
            "sample_word_count": 4,
            "repeated_children": 2
          }
        ],
        "circle-a": [
          {
            "tag": "div",
            "classes": "lbl a",
            "sample_word_count": 10,
            "repeated_children": 2
          }
        ],
        "circle-b": [
          {
            "tag": "div",
            "classes": "lbl b",
            "sample_word_count": 2,
            "repeated_children": 1
          }
        ]
      },
      "option_selectors": [
        "below"
      ],
      "linked_implementation": [
        {
          "file": "../spreads.css",
          "sha256": "32da94472b0c9131e4d5dae7d5bf0498b09202a9e66294b4e4f23e6ddfbf37ba"
        },
        {
          "file": "../spread.js",
          "sha256": "3d99948b83f750bd4ae95dac08e3e50a395de7c149c90a6f1a1c0ea36a2634a4"
        }
      ]
    },
    "variations": {
      "below": {
        "audience_question": "What value exists where these two domains overlap?",
        "intent": "Distinguish each domain from their named intersection.",
        "reader_outcome": "Distinguish each domain from their named intersection.",
        "reasoning_relation": "set intersection",
        "slot_roles": {
          "title": "Name the relationship being explained.",
          "circle-a": "Define the first domain and up to two clarifying attributes.",
          "circle-b": "Define the second domain on the same conceptual level.",
          "caption": "Name the intersection, with a short cue explaining why it is shared."
        },
        "matching": {
          "audience_question": "What value exists where these two domains overlap?",
          "reader_outcome": "Distinguish each domain from their named intersection.",
          "reasoning_relation": "set intersection",
          "content_shape": {
            "composition": "Two things that are each worth something alone and matter most where they overlap: two circles with a label each, and a caption pinned to the overlap.",
            "selected_state": "Caption under the overlap, leader line running down",
            "density": "airy",
            "columns": 1,
            "column_note": "Base metadata only; selected option can replace the base geometry."
          },
          "required_slots": [
            {
              "name": "title",
              "reader_question": "What value exists where these two domains overlap?",
              "semantic_role": "Name the relationship 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 · title · the page title, top left]",
              "layout_budget": {
                "authored": "under 6 words",
                "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": "circle-a",
              "reader_question": "What does the circle a contribute to this page’s reader outcome?",
              "semantic_role": "Define the first domain and up to two clarifying attributes.",
              "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 · circle-a · left circle: a label and up to two short dash lines]",
              "layout_budget": {
                "authored": "label 3 words or fewer, lines under 6 words",
                "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
              },
              "markup": {
                "slot": "circle-a",
                "occurrences": 1,
                "annotation_status": "present",
                "visibility_status": "not asserted from static parsing",
                "sample_word_counts": [
                  10
                ]
              }
            },
            {
              "name": "circle-b",
              "reader_question": "What does the circle b contribute to this page’s reader outcome?",
              "semantic_role": "Define the second domain on the same conceptual level.",
              "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 · circle-b · right circle: a label (lines optional)]",
              "layout_budget": {
                "authored": "label 3 words or fewer",
                "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
              },
              "markup": {
                "slot": "circle-b",
                "occurrences": 1,
                "annotation_status": "present",
                "visibility_status": "not asserted from static parsing",
                "sample_word_counts": [
                  2
                ]
              }
            },
            {
              "name": "caption",
              "reader_question": "What does the caption contribute to this page’s reader outcome?",
              "semantic_role": "Name the intersection, with a short cue explaining why it is shared.",
              "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 · caption · what the overlap is: a mono kicker and one large italic word, joined to a dot in the overlap by a leader line]",
              "layout_budget": {
                "authored": "kicker 3 words, word 1-2 words",
                "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
              },
              "markup": {
                "slot": "caption",
                "occurrences": 1,
                "annotation_status": "present",
                "visibility_status": "not asserted from static parsing",
                "sample_word_counts": [
                  4
                ]
              }
            }
          ],
          "rejection_constraints": [
            "A causal relationship, quantified overlap without data or an intersection that has no distinct meaning.",
            "Using overlap as evidence of synergy without explaining the mechanism."
          ],
          "option_guidance": {
            "option": "below",
            "composition_delta": "Caption under the overlap, leader line running down",
            "semantic_change": "retains base content relationship; changes presentation or disclosure",
            "matching_instruction": "Select S74 below when the supplied material answers “What value exists where these two domains overlap?” through set intersection. Respect this state: Caption under the overlap, leader line running down"
          },
          "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": [
              "0e5d58e1c8155be43aa914e24c3bf7405856fc869f472e6bce838dfa64a4f807"
            ],
            "source_export": "private source images remain outside this draft site",
            "markup_sha256": "79417da18513c8a23889f2993283c88b1b99a1926c653fcf6a17932424c60ef7",
            "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": "The shared space between two domains has a meaning distinct from either domain alone.",
          "communication_job": "Same communication job as default. The intersection caption moves below the circles with a downward leader; the same relationship must remain explicit.",
          "audience_value": "Explanation: distinguishes overlapping membership or a shared capability without implying calibrated quantities.",
          "reading_path": [
            "The intersection caption moves below the circles with a downward leader; the same relationship must remain explicit.",
            "Read the title and each circle’s definition.",
            "Identify what each side contributes independently.",
            "Follow the caption’s leader to the overlap and test whether the named intersection truly requires both."
          ],
          "adaptation": {
            "required_inputs": [
              "Two clearly defined domains.",
              "An explicit, defensible intersection."
            ],
            "slot_guidance": {
              "title": "Name the relationship being explained.",
              "circle-a": "Define the first domain and up to two clarifying attributes.",
              "circle-b": "Define the second domain on the same conceptual level.",
              "caption": "Name the intersection, with a short cue explaining why it is shared."
            },
            "can_change": [
              "Subject, names and wording within the active slot roles.",
              "Illustrations or supporting values where present, with their provenance and limits."
            ],
            "must_survive": [
              "The overlap has a precise meaning.",
              "Circle area does not imply measured proportion.",
              "Both circles are at compatible conceptual levels."
            ]
          },
          "worked_example": {
            "fictional": true,
            "scenario": "A fictional workshop explains the relationship between tool access and practical judgment.",
            "slot_fills": {
              "title": "Where supported practice becomes possible",
              "circle-a": "Tool access · Shared equipment; Staffed bench",
              "circle-b": "Practical judgment",
              "caption": "Together enable · Supported practice"
            },
            "reasoning": "Access without judgment leaves uncertainty about safe use; judgment without access may not enable practice. The overlap is a conceptual relationship, not measured population size.",
            "qualification": "Every organization, value and assertion in this example is fictional. Replace it with approved, sourced content before use."
          },
          "narrative_fit": {
            "before": "Define the practical barrier the two domains address.",
            "after": "Show how the program supplies both and where its limits remain.",
            "good_uses": [
              "Explaining an intersection or shared capability."
            ],
            "poor_fits": [
              "A causal equation disguised as overlap.",
              "Quantitative set sizes without calibrated areas."
            ]
          },
          "evidence": {
            "observations": [
              "Current HTML labels two overlapping circles and connects the caption to their shared region.",
              "Viewed source capture is blurred; only arrangement is observable."
            ],
            "interpretations": [
              "The communication job and reuse advice are inferred from the current arrangement and slot contract, not independently confirmed source intent."
            ],
            "not_verified": [
              "Original author intent, factual accuracy of sample copy and persuasion effects are not verified.",
              "No confidential archive or proposal corpus was used.",
              "Variant-specific source playback was not independently tested; the variation reading uses its current implementation and metadata."
            ],
            "references": [
              "dist/S74-venn/spread.json",
              "dist/S74-venn/spread.html",
              "02_product/spreads/S74-venn/source.webp (viewed for arrangement)"
            ]
          },
          "review": {
            "status": "reviewed",
            "basis": "Motif inspected current metadata, active markup and the retained source arrangement, then checked the fictional example against the content roles. This is a layout-contract adaptation review."
          },
          "variation_relationship": "same-job"
        },
        "required_content": [
          "Two clearly defined domains.",
          "An explicit, defensible intersection."
        ],
        "requires_before": [
          "Define the practical barrier the two domains address."
        ],
        "enables_after": [
          "Show how the program supplies both and where its limits remain."
        ],
        "avoid_when": [
          "A causal equation disguised as overlap.",
          "Quantitative set sizes without calibrated areas."
        ]
      }
    },
    "narrative_profile": {
      "central_point": "The shared space between two domains has a meaning distinct from either domain alone.",
      "communication_job": "Answer what exists at the intersection and why both sides are necessary to understand it.",
      "audience_value": "Explanation: distinguishes overlapping membership or a shared capability without implying calibrated quantities.",
      "reading_path": [
        "Read the title and each circle’s definition.",
        "Identify what each side contributes independently.",
        "Follow the caption’s leader to the overlap and test whether the named intersection truly requires both."
      ],
      "adaptation": {
        "required_inputs": [
          "Two clearly defined domains.",
          "An explicit, defensible intersection."
        ],
        "slot_guidance": {
          "title": "Name the relationship being explained.",
          "circle-a": "Define the first domain and up to two clarifying attributes.",
          "circle-b": "Define the second domain on the same conceptual level.",
          "caption": "Name the intersection, with a short cue explaining why it is shared."
        },
        "can_change": [
          "Subject, names and wording within the active slot roles.",
          "Illustrations or supporting values where present, with their provenance and limits."
        ],
        "must_survive": [
          "The overlap has a precise meaning.",
          "Circle area does not imply measured proportion.",
          "Both circles are at compatible conceptual levels."
        ]
      },
      "worked_example": {
        "fictional": true,
        "scenario": "A fictional workshop explains the relationship between tool access and practical judgment.",
        "slot_fills": {
          "title": "Where supported practice becomes possible",
          "circle-a": "Tool access · Shared equipment; Staffed bench",
          "circle-b": "Practical judgment",
          "caption": "Together enable · Supported practice"
        },
        "reasoning": "Access without judgment leaves uncertainty about safe use; judgment without access may not enable practice. The overlap is a conceptual relationship, not measured population size.",
        "qualification": "Every organization, value and assertion in this example is fictional. Replace it with approved, sourced content before use."
      },
      "narrative_fit": {
        "before": "Define the practical barrier the two domains address.",
        "after": "Show how the program supplies both and where its limits remain.",
        "good_uses": [
          "Explaining an intersection or shared capability."
        ],
        "poor_fits": [
          "A causal equation disguised as overlap.",
          "Quantitative set sizes without calibrated areas."
        ]
      },
      "evidence": {
        "observations": [
          "Current HTML labels two overlapping circles and connects the caption to their shared region.",
          "Viewed source capture is blurred; only arrangement is observable."
        ],
        "interpretations": [
          "The communication job and reuse advice are inferred from the current arrangement and slot contract, not independently confirmed source intent."
        ],
        "not_verified": [
          "Original author intent, factual accuracy of sample copy and persuasion effects are not verified.",
          "No confidential archive or proposal corpus was used."
        ],
        "references": [
          "dist/S74-venn/spread.json",
          "dist/S74-venn/spread.html",
          "02_product/spreads/S74-venn/source.webp (viewed for arrangement)"
        ]
      },
      "review": {
        "status": "reviewed",
        "basis": "Motif inspected current metadata, active markup and the retained source arrangement, then checked the fictional example against the content roles. This is a layout-contract adaptation review."
      },
      "variation_relationship": "base"
    }
  },
  "options": [
    {
      "id": "below",
      "what": "Caption under the overlap, leader line running down"
    }
  ],
  "also_seen_in": [],
  "source": {
    "ref": "Private deck reference; original evidence retained in the private Spreads library."
  }
}
