{
  "code": "S29",
  "name": "Bio",
  "shape": "bio",
  "family": "Evidence and pictures",
  "fits": "One person who needs a paragraph: a portrait card with a round portrait, name and role, beside a card of two to four short paragraphs.",
  "use_when": "Introducing one senior person in depth, usually near the back of a deck. Lead with the most credible fact, not a date.",
  "slots": [
    {
      "name": "title",
      "holds": "page title, top left",
      "budget": "under 4 words"
    },
    {
      "name": "tag",
      "holds": "translucent pill beside the title: their role group",
      "budget": "1-3 words"
    },
    {
      "name": "portrait",
      "holds": "round illustrated portrait, top of the left card",
      "budget": "1:1"
    },
    {
      "name": "name",
      "holds": "Name Surname (placeholder unless a real, consenting person)",
      "budget": "2-3 words"
    },
    {
      "name": "role",
      "holds": "title and desk or region, two lines",
      "budget": "under 8 words"
    },
    {
      "name": "bio",
      "holds": "2-4 short justified paragraphs in the right card",
      "budget": "under 50 words each"
    }
  ],
  "columns": 2,
  "density": "standard",
  "surface": "mint",
  "works_on": [
    "deck",
    "page"
  ],
  "library": "Hoffman",
  "dir": "S29-bio",
  "semantic": {
    "audience_question": "Why is this person relevant, beyond their job title?",
    "intent": "Connect a named person’s role to the experience that matters here.",
    "reasoning_relation": "identity and relevant credentials",
    "message_pattern": "[Person] brings [relevant expertise], demonstrated by [specific experience].",
    "required_content": [
      "Verified, authorised biography details.",
      "Current role and actual commitment to this engagement.",
      "Cleared portrait or explicitly fictional illustration."
    ],
    "narrative_positions": [
      "credentials",
      "delivery assurance"
    ],
    "requires_before": [
      "Introduce the team structure and why this role matters."
    ],
    "enables_after": [
      "Discuss the delivery method, availability or evidence of comparable work."
    ],
    "slot_roles": {
      "title": "The team context.",
      "tag": "This person’s functional group.",
      "portrait": "Cleared identity image or disclosed illustration.",
      "name": "Actual authorised name or clearly fictional example identity.",
      "role": "Current role and scope.",
      "bio": "Two to four short paragraphs: relevant experience, current remit, specialist range and working approach as needed."
    },
    "avoid_when": [
      "An audience persona",
      "Unverified claims of results",
      "A whole-team overview"
    ],
    "layout_specific_contract": "One person who needs a paragraph: a portrait card with a round portrait, name and role, beside a card of two to four short paragraphs.",
    "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": "Connect a named person’s role to the experience that matters here.",
    "matching": {
      "audience_question": "Why is this person relevant, beyond their job title?",
      "reader_outcome": "Connect a named person’s role to the experience that matters here.",
      "reasoning_relation": "identity and relevant credentials",
      "content_shape": {
        "composition": "One person who needs a paragraph: a portrait card with a round portrait, name and role, beside a card of two to four short paragraphs.",
        "selected_state": "One person who needs a paragraph: a portrait card with a round portrait, name and role, beside a card of two to four short paragraphs.",
        "density": "standard",
        "columns": 2,
        "column_note": "Base metadata only; selected option can replace the base geometry."
      },
      "required_slots": [
        {
          "name": "title",
          "reader_question": "Why is this person relevant, beyond their job title?",
          "semantic_role": "The team context.",
          "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 · page title, top left]",
          "layout_budget": {
            "authored": "under 4 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": [
              2
            ]
          }
        },
        {
          "name": "tag",
          "reader_question": "What does the tag contribute to this page’s reader outcome?",
          "semantic_role": "This person’s functional group.",
          "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 · tag · translucent pill beside the title: their role group]",
          "layout_budget": {
            "authored": "1-3 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "tag",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              2
            ]
          }
        },
        {
          "name": "portrait",
          "reader_question": "What subject, example or view must I inspect, and is it evidence or illustration?",
          "semantic_role": "Cleared identity image or disclosed illustration.",
          "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": "[CLEARED IMAGE OR LABELLED ILLUSTRATION · portrait · round illustrated portrait, top of the left card]",
          "layout_budget": {
            "authored": "1:1",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "portrait",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              0
            ]
          },
          "integrity": "Clear rights and provenance, retain meaningful alt text; generated scenes illustrate and cannot prove a historical event."
        },
        {
          "name": "name",
          "reader_question": "Which precise person, meaning, statement or response is being identified?",
          "semantic_role": "Actual authorised name or clearly fictional example identity.",
          "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 · name · Name Surname (placeholder unless a real, consenting person)]",
          "layout_budget": {
            "authored": "2-3 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "name",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              2
            ]
          }
        },
        {
          "name": "role",
          "reader_question": "Which precise person, meaning, statement or response is being identified?",
          "semantic_role": "Current role and scope.",
          "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 · role · title and desk or region, two lines]",
          "layout_budget": {
            "authored": "under 8 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "role",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              4
            ]
          }
        },
        {
          "name": "bio",
          "reader_question": "Which precise person, meaning, statement or response is being identified?",
          "semantic_role": "Two to four short paragraphs: relevant experience, current remit, specialist range and working approach as needed.",
          "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 · bio · 2-4 short justified paragraphs in the right card]",
          "layout_budget": {
            "authored": "under 50 words each",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "bio",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              99
            ]
          }
        }
      ],
      "rejection_constraints": [
        "A résumé of unrelated achievements or a biography without consent and traceable facts.",
        "Generic praise, outdated credentials or claims that experience guarantees outcomes."
      ],
      "option_guidance": {
        "option": "default",
        "composition_delta": "One person who needs a paragraph: a portrait card with a round portrait, name and role, beside a card of two to four short paragraphs.",
        "semantic_change": "retains base content relationship; changes presentation or disclosure",
        "matching_instruction": "Select S29 default when the supplied material answers “Why is this person relevant, beyond their job title?” through identity and relevant credentials. Respect this state: One person who needs a paragraph: a portrait card with a round portrait, name and role, beside a card of two to four short paragraphs."
      },
      "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": [
          "690080b9432b1f8274df1c08a960b3c83cbb08b5c462cb393584b9aeca8945e6"
        ],
        "source_export": "private source images remain outside this draft site",
        "markup_sha256": "d4f5955bbd1f704949d6137759d7e6167bb2763c411b78b45e4515e24f324b9a",
        "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 résumé of unrelated achievements or a biography without consent and traceable facts.",
      "Generic praise, outdated credentials or claims that experience guarantees outcomes."
    ],
    "markup_inventory": {
      "file": "spread.html",
      "sha256": "d4f5955bbd1f704949d6137759d7e6167bb2763c411b78b45e4515e24f324b9a",
      "method": "static lxml markup plus authored option description; no rendered-visibility claim",
      "all_markup_slot_counts": {
        "title": 1,
        "tag": 1,
        "portrait": 1,
        "name": 1,
        "role": 1,
        "bio": 1
      },
      "slot_evidence": {
        "title": [
          {
            "tag": "h2",
            "classes": "head",
            "sample_word_count": 2,
            "repeated_children": 0
          }
        ],
        "tag": [
          {
            "tag": "span",
            "classes": "pill",
            "sample_word_count": 2,
            "repeated_children": 0
          }
        ],
        "portrait": [
          {
            "tag": "figure",
            "classes": "ph r-1x1",
            "sample_word_count": 0,
            "repeated_children": 1
          }
        ],
        "name": [
          {
            "tag": "div",
            "classes": "nm",
            "sample_word_count": 2,
            "repeated_children": 0
          }
        ],
        "role": [
          {
            "tag": "div",
            "classes": "rl",
            "sample_word_count": 4,
            "repeated_children": 1
          }
        ],
        "bio": [
          {
            "tag": "div",
            "classes": "card bio",
            "sample_word_count": 99,
            "repeated_children": 4
          }
        ]
      },
      "option_selectors": [],
      "linked_implementation": [
        {
          "file": "../spreads.css",
          "sha256": "32da94472b0c9131e4d5dae7d5bf0498b09202a9e66294b4e4f23e6ddfbf37ba"
        },
        {
          "file": "../spread.js",
          "sha256": "3d99948b83f750bd4ae95dac08e3e50a395de7c149c90a6f1a1c0ea36a2634a4"
        }
      ]
    },
    "variations": {},
    "narrative_profile": {
      "central_point": "One person’s relevant experience explains the role they will perform here.",
      "communication_job": "Establish contextual credibility without turning the page into an employment chronology.",
      "audience_value": "Reassurance: gives the reader a basis for assessing suitability and accountability, not a guarantee of future results.",
      "reading_path": [
        "Identify the person and current role on the portrait card.",
        "Read biography paragraphs from relevant experience to present remit and working approach.",
        "Judge each credential against the work this audience needs done."
      ],
      "adaptation": {
        "required_inputs": [
          "Verified, authorised biography details.",
          "Current role and actual commitment to this engagement.",
          "Cleared portrait or explicitly fictional illustration."
        ],
        "slot_guidance": {
          "title": "The team context.",
          "tag": "This person’s functional group.",
          "portrait": "Cleared identity image or disclosed illustration.",
          "name": "Actual authorised name or clearly fictional example identity.",
          "role": "Current role and scope.",
          "bio": "Two to four short paragraphs: relevant experience, current remit, specialist range and working approach as needed."
        },
        "can_change": [
          "Biography length within two-to-four paragraphs.",
          "The verified facts and role description."
        ],
        "must_survive": [
          "Experience stays relevant to the promised role.",
          "Claims remain verified and authorised.",
          "Past experience does not guarantee future outcomes."
        ]
      },
      "worked_example": {
        "fictional": true,
        "scenario": "Fictional repair cooperative proposal; all events, people and evidence are invented teaching material.",
        "slot_fills": {
          "title": "The pilot team",
          "tag": "Repair lead",
          "portrait": "Clearly labelled illustration of fictional repair lead Bea Lin.",
          "name": "Bea Lin",
          "role": "Repair lead · fictional pilot",
          "bio": [
            "Bea is a fictional repair technician who has organised neighbourhood repair sessions. This example illustrates the kind of relevant experience a real biography would need to substantiate.",
            "In the proposed pilot, she would set diagnosis criteria and confirm that parts are available before staff offer an appointment.",
            "She would review jobs that fail readiness checks and explain when safe replacement is more appropriate than repair."
          ]
        },
        "reasoning": "The biography connects experience to a specific remit and decision boundary rather than listing prestigious names.",
        "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 team structure and why this role matters.",
        "after": "Discuss the delivery method, availability or evidence of comparable work.",
        "good_uses": [
          "A key-person profile",
          "Expert introduction",
          "Proposal credentials tied to a role"
        ],
        "poor_fits": [
          "An audience persona",
          "Unverified claims of results",
          "A whole-team overview"
        ]
      },
      "evidence": {
        "observations": [
          "Viewed source: identity card with portrait/name/role sits beside four biography paragraphs, organised as relevant experience and scope.",
          "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/S29-bio/source.webp",
          "dist/S29-bio/spread.html",
          "dist/S29-bio/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": [],
  "also_seen_in": [],
  "source": {
    "ref": "Hoffman L16 Bio",
    "url": "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html"
  }
}