demo:
  id: law-firm-intake
  title: Law Firm Intake Demo
  domain: legal_services
  purpose: >
    Demonstrates how SMA can govern a law firm website or intake experience by
    resolving the visitor's legal context, urgency, sophistication, and trust
    needs before presenting practice areas, proof, or next-step actions.

semantic_contract:
  name: law_firm_intake_contract
  principle: One legal content model projects different paths for corporate, individual, and referral-driven visitors.
  sma_pattern: signal_meaning_action

deployment:
  type: embedded_layer
  modes:
    default: avatar_driven
    supported:
      - avatar_driven
      - headless
  entry_signal:
    avatar_driven: declared_visitor_context_or_practice_area_entry
    headless: selected_issue_filters_search_query_or_page_behavior
  identity_model:
    avatar_driven: declared_identity
    headless: data_driven_no_avatar
  note: >
    This is an embedded SMA example for a conventional service website. The visitor
    does not need to understand the framework; the site simply routes meaning more cleanly.

source_signals:
  provider: law_firm_content_model
  default_fields:
    - practice_area
    - attorney_profile
    - case_results
    - industry_experience
    - jurisdiction
    - urgency_level
    - consultation_cta
    - referral_source
    - client_type

sma_enrichment:
  fields:
    urgency_signal:
      label: Urgency
      group: situational
      type: score
      range: 0_to_1
      meaning: Time sensitivity, procedural deadlines, active dispute pressure, or immediate risk.
    trust_requirement:
      label: Trust Need
      group: situational
      type: score
      range: 0_to_1
      meaning: Degree of reassurance, credibility, and proof needed before contact.
    legal_complexity:
      label: Complexity
      group: matter_profile
      type: score
      range: 0_to_1
      meaning: Technical, procedural, financial, or multi-party complexity of the issue.
    discretion_need:
      label: Discretion
      group: matter_profile
      type: score
      range: 0_to_1
      meaning: Need for privacy, confidentiality, low visibility, and careful tone.
    cost_sensitivity:
      label: Cost Sensitivity
      group: constraint
      type: score
      range: 0_to_1
      meaning: Need for pricing clarity, consultation framing, and expectation management.
    authority_signal:
      label: Authority
      group: proof
      type: score
      range: 0_to_1
      meaning: Depth of credentials, outcomes, specialization, peer recognition, and case relevance.
    plain_language_need:
      label: Plain Language
      group: comprehension
      type: score
      range: 0_to_1
      meaning: Need for direct explanation, reduced legal jargon, and guided next steps.

avatars:
  corporate_counsel:
    meaning: Needs expertise, authority, discretion, jurisdictional clarity, and efficient qualification.
    ux_mode: focus
    scoring:
      authority_signal: 0.30
      legal_complexity: 0.20
      discretion_need: 0.20
      urgency_signal: 0.10
      trust_requirement: 0.10
      cost_sensitivity: 0.05
      plain_language_need: 0.05
    directions:
      authority_signal: higher_better
      legal_complexity: higher_better
      discretion_need: higher_better
      urgency_signal: higher_better
      trust_requirement: higher_better
      cost_sensitivity: lower_better
      plain_language_need: higher_better
    ipc:
      rule: Authority and discretion are foregrounded without creating promotional noise.
      forbidden_behaviors:
        - lead with generic marketing copy
        - hide attorney credentials behind long narrative sections
        - over-simplify complex matter language

  individual_client:
    meaning: Needs reassurance, plain language, urgency handling, and a clear path to contact.
    ux_mode: balanced
    scoring:
      plain_language_need: 0.25
      trust_requirement: 0.25
      urgency_signal: 0.20
      cost_sensitivity: 0.15
      authority_signal: 0.10
      legal_complexity: 0.05
      discretion_need: 0.00
    directions:
      plain_language_need: higher_better
      trust_requirement: higher_better
      urgency_signal: higher_better
      cost_sensitivity: higher_better
      authority_signal: higher_better
      legal_complexity: lower_better
      discretion_need: neutral
    ipc:
      rule: The path to help must remain visible and jargon must not dominate the first scan.
      forbidden_behaviors:
        - bury contact action below credentials
        - use attorney-centered copy before visitor problem framing
        - present legal complexity without plain-language translation

  referral_partner:
    meaning: Needs confidence, fit verification, attorney credibility, and fast routing.
    ux_mode: explore
    scoring:
      authority_signal: 0.25
      legal_complexity: 0.20
      trust_requirement: 0.20
      discretion_need: 0.15
      urgency_signal: 0.10
      plain_language_need: 0.05
      cost_sensitivity: 0.05
    directions:
      authority_signal: higher_better
      legal_complexity: higher_better
      trust_requirement: higher_better
      discretion_need: higher_better
      urgency_signal: higher_better
      plain_language_need: higher_better
      cost_sensitivity: lower_better
    ipc:
      rule: Referral confidence is built through fit, proof, and fast handoff clarity.
      forbidden_behaviors:
        - obscure practice fit
        - make referral contact paths ambiguous
        - over-prioritize public-facing reassurance over professional proof

headless_scoring:
  description: >
    Visitor-selected issue filters, search queries, or page behavior can adjust
    legal content hierarchy without requiring the visitor to choose a persona.
  controls:
    - urgency_signal
    - trust_requirement
    - legal_complexity
    - discretion_need
    - cost_sensitivity
    - authority_signal
    - plain_language_need
  output: issue_routing_with_visible_next_step_rationale

projections:
  human_ui:
    - adaptive practice-area cards
    - role-sensitive intake paths
    - attorney proof modules
    - urgency and consultation CTAs
    - plain-language issue explainers
    - referral routing panels
  structured_data:
    type: legal_service_semantics
    format:
      - JSON
      - JSON-LD
      - YAML contract
  agent_response:
    behavior: governed_legal_intake_explanation_without_legal_advice

proof_points:
  - Same law firm content resolves differently for corporate counsel, individual clients, and referral partners.
  - Urgency and trust requirements change routing before visual projection.
  - SMA improves intake clarity without implying legal advice.
  - Headless issue filters support visitors who do not know which legal category they fit.
