{
  "code": "S34",
  "name": "Journey",
  "shape": "stages",
  "family": "Lists and comparisons",
  "fits": "A model or journey made of four to six named stages, each with a very short line in its own voice.",
  "use_when": "When the shape of the model is the point: name each stage and let the row carry it. The speaker explains; the slide only names.",
  "slots": [
    {
      "name": "eyebrow",
      "holds": "what the model is",
      "budget": "2-4 words"
    },
    {
      "name": "head",
      "holds": "the model's name or claim, top left, one italic word",
      "budget": "under 10 words"
    },
    {
      "name": "stages",
      "holds": "4-6 x (stage name + short italic line), one bordered row across the middle",
      "budget": "name 1-2 words, line 4 words or fewer"
    }
  ],
  "columns": 6,
  "density": "airy",
  "surface": "mint",
  "works_on": [
    "deck",
    "page"
  ],
  "library": "Hoffman",
  "dir": "S34-journey",
  "semantic": {
    "audience_question": "What changes as someone moves through these named stages?",
    "intent": "Recognize a state progression and the characteristic thought or action of each stage.",
    "reasoning_relation": "ordered state model",
    "message_pattern": "At [stage], [audience] thinks or does [state]; [intervention] helps them reach [next state].",
    "required_content": [
      "Four to six defined stages.",
      "A meaningful order and a named actor or system.",
      "Evidence or a disclosed hypothesis about transitions and loops."
    ],
    "narrative_positions": [
      "context",
      "explanation",
      "evidence: choose only when the page supports the surrounding argument"
    ],
    "requires_before": [
      "Define the audience and the problem the journey helps solve."
    ],
    "enables_after": [
      "Map barriers, content, owners or measures to each stage."
    ],
    "slot_roles": {
      "eyebrow": "What kind of journey or model this is.",
      "head": "The model’s governing idea.",
      "stages": "Four to six stage-name and short-state pairs; use the same actor and level of abstraction throughout."
    },
    "avoid_when": [
      "A measured funnel without counts",
      "A guaranteed linear path where loops dominate"
    ],
    "layout_specific_contract": "A model or journey made of four to six named stages, each with a very short line in its own voice.",
    "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": "Recognize a state progression and the characteristic thought or action of each stage.",
    "matching": {
      "audience_question": "What changes as someone moves through these named stages?",
      "reader_outcome": "Recognize a state progression and the characteristic thought or action of each stage.",
      "reasoning_relation": "ordered state model",
      "content_shape": {
        "composition": "A model or journey made of four to six named stages, each with a very short line in its own voice.",
        "selected_state": "A model or journey made of four to six named stages, each with a very short line in its own voice.",
        "density": "airy",
        "columns": 6,
        "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": "What kind of journey or model this is.",
          "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 model is]",
          "layout_budget": {
            "authored": "2-4 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "eyebrow",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              4
            ]
          }
        },
        {
          "name": "head",
          "reader_question": "What changes as someone moves through these named stages?",
          "semantic_role": "The model’s governing idea.",
          "content_unit_count": {
            "min": 1,
            "max": 1,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · head · the model's name or claim, top left, one italic word]",
          "layout_budget": {
            "authored": "under 10 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "head",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              5
            ]
          }
        },
        {
          "name": "stages",
          "reader_question": "What does this distinct step, state, scenario or observation contribute?",
          "semantic_role": "Four to six stage-name and short-state pairs; use the same actor and level of abstraction throughout.",
          "content_unit_count": {
            "min": 4,
            "max": 6,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · stages · 4-6 x (stage name + short italic line), one bordered row across the middle]",
          "layout_budget": {
            "authored": "name 1-2 words, line 4 words or fewer",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "stages",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              26
            ]
          }
        }
      ],
      "rejection_constraints": [
        "A project calendar, parallel capabilities or stages with no transition logic.",
        "A funnel that assumes all audiences follow the same path without evidence."
      ],
      "option_guidance": {
        "option": "default",
        "composition_delta": "A model or journey made of four to six named stages, each with a very short line in its own voice.",
        "semantic_change": "retains base content relationship; changes presentation or disclosure",
        "matching_instruction": "Select S34 default when the supplied material answers “What changes as someone moves through these named stages?” through ordered state model. Respect this state: A model or journey made of four to six named stages, each with a very short line in its own voice."
      },
      "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": [
          "97153a1f6ca935a6586e9c27303f7829b96427b1cd69829d30f718d9e8ab5ba7"
        ],
        "source_export": "private source images remain outside this draft site",
        "markup_sha256": "d4654105d2c8ecf9535325690c5d3a934d14c43d470ce4f7bad02d5754d8c501",
        "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 project calendar, parallel capabilities or stages with no transition logic.",
      "A funnel that assumes all audiences follow the same path without evidence."
    ],
    "markup_inventory": {
      "file": "spread.html",
      "sha256": "d4654105d2c8ecf9535325690c5d3a934d14c43d470ce4f7bad02d5754d8c501",
      "method": "static lxml markup plus authored option description; no rendered-visibility claim",
      "all_markup_slot_counts": {
        "eyebrow": 1,
        "head": 1,
        "stages": 1
      },
      "slot_evidence": {
        "eyebrow": [
          {
            "tag": "span",
            "classes": "eyebrow plain",
            "sample_word_count": 4,
            "repeated_children": 0
          }
        ],
        "head": [
          {
            "tag": "h2",
            "classes": "head",
            "sample_word_count": 5,
            "repeated_children": 2
          }
        ],
        "stages": [
          {
            "tag": "div",
            "classes": "row",
            "sample_word_count": 26,
            "repeated_children": 6
          }
        ]
      },
      "option_selectors": [],
      "linked_implementation": [
        {
          "file": "../spreads.css",
          "sha256": "32da94472b0c9131e4d5dae7d5bf0498b09202a9e66294b4e4f23e6ddfbf37ba"
        },
        {
          "file": "../spread.js",
          "sha256": "3d99948b83f750bd4ae95dac08e3e50a395de7c149c90a6f1a1c0ea36a2634a4"
        }
      ]
    },
    "variations": {},
    "narrative_profile": {
      "central_point": "A person or system moves through a small set of distinct stages.",
      "communication_job": "Provide an intelligible model of a journey before detailing interventions.",
      "audience_value": "Explanation: tells the audience what changes between stages and where a particular intervention belongs.",
      "reading_path": [
        "Read the model’s scope and title.",
        "Move through stages from left to right.",
        "Use the short line in each stage to distinguish its state from neighbouring stages."
      ],
      "adaptation": {
        "required_inputs": [
          "Four to six defined stages.",
          "A meaningful order and a named actor or system.",
          "Evidence or a disclosed hypothesis about transitions and loops."
        ],
        "slot_guidance": {
          "eyebrow": "What kind of journey or model this is.",
          "head": "The model’s governing idea.",
          "stages": "Four to six stage-name and short-state pairs; use the same actor and level of abstraction throughout."
        },
        "can_change": [
          "Four-to-six stages.",
          "The model’s domain, if transitions are meaningful."
        ],
        "must_survive": [
          "One actor/system and consistent stage granularity.",
          "Order is defined, not inferred merely from position.",
          "Loops or exceptions are acknowledged when material."
        ]
      },
      "worked_example": {
        "fictional": true,
        "scenario": "Fictional repair cooperative proposal; all events, people and evidence are invented teaching material.",
        "slot_fills": {
          "eyebrow": "Proposed resident journey",
          "head": "Confidence grows through clear decisions.",
          "stages": [
            "Notice | Something stops working",
            "Consider | Is repair worthwhile?",
            "Assess | What is wrong?",
            "Book | Everything is ready",
            "Repair | Work is completed",
            "Review | Did it last?"
          ]
        },
        "reasoning": "The stages describe changing questions for one resident, making room to assign service support at each point.",
        "qualification": "Fictional teaching example only. Proposed benefits and results are not verified; replace with authorised material for a real use."
      },
      "narrative_fit": {
        "before": "Define the audience and the problem the journey helps solve.",
        "after": "Map barriers, content, owners or measures to each stage.",
        "good_uses": [
          "Customer journeys",
          "A capability-building model",
          "A simple process overview"
        ],
        "poor_fits": [
          "A measured funnel without counts",
          "A guaranteed linear path where loops dominate"
        ]
      },
      "evidence": {
        "observations": [
          "Viewed source: six customer-journey stages each pair a name with a short first-person state; current default adapts the structure to capability stages.",
          "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/S34-journey/source.webp",
          "dist/S34-journey/spread.html",
          "dist/S34-journey/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 L21 Journey",
    "url": "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html"
  }
}