--- name: onboarding-first-prompt-suggestion-by-persona description: Use when a user opens a new chat session for the first time, or returns to a blank composer, and the system must offer persona-appropriate starter prompt suggestions. Defines the specific suggested prompts for each user persona — lawyer, partner, in-house counsel, law student, SME founder, and consumer — along with the rendering rules, refresh logic, and time-of-day awareness. These are the clickable chips below the composer that guide a user's first interaction and reduce blank-page paralysis. license: MIT metadata: id: onboarding.first-prompt-suggestion-by-persona category: onboarding priority: P0 intent: [onboarding, starter-prompts, persona, chips, first-use, engagement] related: [onboarding-empty-state-prompts, onboarding-persona-detection-questions, onboarding-b2c-vs-b2b-fork, onboarding-feature-discovery-tour] source: Louis — HAQQ Legal AI (github.com/sboghossian/mini-claude-for-legal) version: "1.0" --- # Onboarding — First Prompt Suggestions by Persona ## When this applies At the start of every new chat session — especially on first sign-in and after the persona detection flow — the composer surfaces **3 clickable prompt chips** tailored to the user's detected persona. These chips: - Eliminate blank-page paralysis for new users - Signal the product's capability range immediately - Set the right expectation for tone and depth of response - Refresh to avoid staleness after each session This skill defines the specific prompt text, persona mapping, rendering rules, and refresh logic. --- ## Prompt Sets by Persona ### `associate` / `partner` (lawyers in private practice) Prompt chips rotate across this bank; show 3 at a time: 1. "Review this MSA from a [client-side / vendor-side] perspective" 2. "Draft a mutual NDA for [purpose] under [jurisdiction] law" 3. "Compare non-compete enforceability across LB, KSA, UAE" 4. "Summarise the key risks in this shareholder agreement" 5. "What's the governing law analysis for this cross-border contract?" 6. "Draft a term sheet for a [Series A / seed / bridge] round" 7. "Flag all liability caps and exclusions in this services agreement" 8. "Explain ADGM employment law requirements for a new hire" **Tone:** Professional, task-specific, jurisdiction-aware ### `in-house-counsel` 1. "Summarise the legal risk in this [contract / policy / vendor agreement]" 2. "Draft a client alert email about [recent regulation or topic]" 3. "What's our exposure on this [vendor / employment / data privacy] issue?" 4. "Review our standard procurement template against DIFC contract law" 5. "Help me draft a data processing agreement for a new SaaS vendor" 6. "Summarise the key obligations in this insurance policy" 7. "What internal approvals does this contract require under our policy matrix?" **Tone:** Risk-focused, practical, policy-aware ### `law-student` (Justinian / educational) 1. "Explain the consideration doctrine using a worked example" 2. "Help me outline an IRAC for [legal issue]" 3. "Quiz me on UAE Decree-Law 33/2021 employment provisions" 4. "What's the difference between civil and common law on contract formation?" 5. "Help me understand how damages are calculated in a breach of contract case" 6. "Explain the key duties of a company director under DIFC Companies Law" 7. "Walk me through the stages of a commercial arbitration under DIAC rules" **Tone:** Pedagogical, Socratic where appropriate, example-heavy ### `sme-founder` (business owners, entrepreneurs) 1. "Draft a basic NDA I can use with vendors and employees" 2. "Is this employment offer letter fair? Review it for me" 3. "Help me incorporate in [jurisdiction] — what's the process?" 4. "What contracts do I need before taking on my first client?" 5. "Review my freelancer agreement — am I protected?" 6. "What are the Saudization requirements if I hire in KSA?" 7. "Help me understand this SaaS agreement I'm being asked to sign" **Tone:** Plain English, practical, no assumptions about legal knowledge ### `louis-twin` (consumer / individual) 1. "I got laid off — what are my rights in [jurisdiction]?" 2. "Help me write a will (I'm in [LB / UAE / KSA])" 3. "I want to start a freelance business — what contracts do I need?" 4. "My landlord is refusing to return my deposit — what can I do?" 5. "Explain this clause in my new employment contract" 6. "What happens if I don't pay a debt in UAE?" 7. "Help me understand the process for a divorce in Lebanon" **Tone:** Empathetic, plain language, always include "talk to a lawyer" context for high-stakes situations --- ## Rendering Rules ### Display format - 3 prompt chips visible at a time below the composer input - Each chip: max 60 characters (truncate with "..." on overflow) - Chips are clickable: one click populates the composer with the full prompt text (editable before sending) - Do not auto-submit on click — let the user edit the prompt to add their specific document, jurisdiction, or detail ### Rotation logic - Do not show the same 3 chips twice in a row - After each message, refresh chips to reflect the next logical step in the conversation flow - After first message, transition from "starter prompts" to "follow-up prompts" based on the topic detected ### Jurisdiction personalisation Where the user's jurisdiction preference is known from the persona quiz or prior prompts: - Replace `[jurisdiction]` placeholders with the known jurisdiction: "Review this NDA under **UAE law**" - For multi-jurisdiction users (in-house counsel, partner at regional firm), show the primary jurisdiction first --- ## Time-of-Day Variants | Time window | Prompt flavour adjustment | |-------------|--------------------------| | Monday morning | Proactive: "Start your week — what needs drafting or reviewing?" | | Friday afternoon | Wrap-up: "Finish strong — any contracts to review before the weekend?" | | Day before a public holiday | "Quick win before [holiday name]?" | These time-of-day variants are optional and should only be used where they feel natural, not intrusive. --- ## After the First Message Once the user sends their first message: - Remove the starter prompt chips - Surface 2–3 **follow-up prompt suggestions** based on the response (e.g., after a contract review → "See redlined version", "Identify the jurisdiction of this contract", "Compare with market standard") - These follow-up chips are generated contextually, not from a fixed bank --- ## Failure Mode If persona detection has not completed and no persona is known: - Default to `louis-twin` (consumer) chips - After the user's first message, infer persona from prompt content and update chips accordingly --- ## Related skills - [[onboarding-empty-state-prompts]] - [[onboarding-persona-detection-questions]] - [[onboarding-b2c-vs-b2b-fork]] - [[onboarding-feature-discovery-tour]]