Messaging — Surface Rule: In-App Non-Lawyer Fork
When this applies
Once a user has been classified as a non-lawyer consumer (via persona quiz default, email domain, or explicit self-identification — see [[onboarding-b2c-vs-b2b-fork]]), all in-app copy shown to that user follows the consumer-fork rules defined here. This covers:
- Welcome and onboarding screens
- Feature discovery tooltips
- Empty-state prompts across all product areas
- Upsell and plan-upgrade prompts
- In-product notifications and status messages
- Error messages and escalation copy
- Help text and guidance overlays
Consumer users are private individuals, SME founders, students, and anyone who is not a licensed legal practitioner. The in-app experience must be empowering, plain-language, and never imply the product provides legal advice.
Behavior — The Consumer Voice
In-app copy in the consumer fork assumes the user:
- Has no formal legal training
- Is dealing with a real situation that feels confusing or stressful (a contract to sign, a landlord dispute, a job loss, a business to start)
- Needs orientation, plain-language explanation, and process guidance
- Is not looking for a lawyer replacement but for enough understanding to feel in control
Copy must reflect these assumptions. Use plain English. Ground every message in the user's situation. Avoid jargon — if legal terminology is essential, always explain it. End complex-situation guidance with a "talk to a lawyer" prompt.
Copy Rules by In-App Location
Onboarding / Welcome Screen
| Element |
Consumer fork rule |
| Welcome headline |
Warm, empowering: "Welcome. Let's make sense of your legal situation." |
| Sub-copy |
State what the tool does: "Louis explains your rights, translates legal jargon, and helps you prepare for any legal situation." |
| Disclaimer |
Prominent and plain: "Louis provides legal information, not legal advice. For complex situations, we'll tell you when to speak to a lawyer." |
| First action |
Situational prompt chips: "I got a contract to sign", "I have a landlord issue", "I'm starting a business" |
Feature Tooltips and Discovery
- Lead with what the user gets, in their language
- "Upload your lease and Louis will explain every clause in plain English." (not "AI-powered document analysis")
- Use empathy phrases at the start of complex features: "Contracts can be confusing. Here's what Louis will check for you."
- Always end document-generation tooltips with: "Your draft is a starting point — a lawyer can review it before you use it."
Empty-State Prompts
- Situational and inviting: "What are you trying to figure out today?"
- Persona-aware chips: for consumer users, offer: "Explain this contract", "Know my rights", "Start a business", "Write a basic agreement"
- Never: "No documents yet — upload one." (not actionable enough for a non-technical consumer)
Upsell / Plan Upgrade Prompts
- Frame around access to more help, not capability metrics
- "For deeper analysis and longer documents, upgrade to Louis Pro — from $[X]/month."
- Value anchor allowed: "That's less than an hour of lawyer time — for a whole month of legal clarity."
- Never: "Save thousands on lawyer fees" — banned under [[messaging-banned-claims-consumer]]
Error and Escalation Copy
- Empathetic: "We couldn't analyse that document. Make sure it's a standard contract or agreement — and try again."
- Escalation prompt: "This situation sounds complex. For matters involving [court proceedings / criminal issues / children], please speak to a qualified lawyer."
- Use warm language; do not leave the user feeling abandoned: "Louis can help with a lot — but for this situation, a lawyer's guidance is essential."
"Talk to a Lawyer" Trigger
In-app copy for consumer users must always include a "talk to a lawyer" trigger when:
- The user's described situation involves urgent risk (eviction, employment termination, debt enforcement)
- The document is high-stakes and finalising a legal position (not just exploring)
- The user asks about criminal, family law, or court proceedings
The trigger copy: "For this situation, speaking to a qualified lawyer is important. Louis can help you prepare — but your lawyer should make the final call."
Banned Patterns in Consumer Fork
These patterns are blocked on the consumer fork:
- "No lawyer needed" — [[messaging-banned-claims-consumer]] absolute ban
- "Legal advice" used to describe what Louis provides — UPL trigger
- "You'll win" or any outcome framing
- Technical legal jargon without explanation (not banned but fails accessibility bar)
- Cold transactional language ("Your session has expired. Log in to continue.") — consumer fork uses warmer language
Examples
Strong consumer-fork in-app copy:
"Your lease looks like a standard residential rental. Louis spotted 2 clauses that could be negotiated — here's what they mean and how to approach it. Before you sign, it's worth a 30-minute lawyer check if anything worries you."
Weak (avoid in consumer fork):
"Contract analysis complete. 2 flags identified. Review report."
Strong upgrade prompt:
"You've asked 5 questions this month. Upgrade to Pro for unlimited questions, document analysis, and multi-jurisdiction coverage — for less than the cost of one lawyer consultation."
Weak upgrade prompt (avoid):
"Free tier limit reached. Upgrade to continue."
Related skills
- [[messaging-compliance-checker]]
- [[messaging-allowed-claims-consumer]]
- [[messaging-banned-claims-consumer]]
- [[messaging-surface-rule-in-app-lawyer-fork]]
- [[onboarding-b2c-vs-b2b-fork]]
- [[onboarding-empty-state-prompts]]
1---2name: messaging-surface-rule-in-app-non-lawyer-fork3description: Use when writing or reviewing in-app copy, onboarding messages, tooltips, upsell prompts, or notifications displayed to non-lawyer consumer users of a legal AI assistant. The non-lawyer fork uses empowering plain-language framing, situational prompts, and "legal understanding" positioning — always distinct from legal advice. Applied by messaging-compliance-checker for any in-app asset tagged to a consumer or non-professional persona.4license: MIT5metadata:6 id: messaging.surface-rule.in-app-non-lawyer-fork7 category: messaging8 jurisdictions: [__multi__]9 priority: P210 intent: [messaging, in-app, consumer, non-lawyer, UX-copy, onboarding]11 related: [messaging-compliance-checker, messaging-allowed-claims-consumer, messaging-banned-claims-consumer, messaging-surface-rule-in-app-lawyer-fork, onboarding-b2c-vs-b2b-fork]12 source: https://skillmd.com/skills/sboghossian-mini-claude-for-legal/messaging-surface-rule-in-app-non-lawyer-fork13 upstream: Louis — HAQQ Legal AI (github.com/sboghossian/mini-claude-for-legal)14 version: "1.0"15---1617# Messaging — Surface Rule: In-App Non-Lawyer Fork1819## When this applies2021Once a user has been classified as a **non-lawyer consumer** (via persona quiz default, email domain, or explicit self-identification — see [[onboarding-b2c-vs-b2b-fork]]), all in-app copy shown to that user follows the consumer-fork rules defined here. This covers:2223- Welcome and onboarding screens24- Feature discovery tooltips25- Empty-state prompts across all product areas26- Upsell and plan-upgrade prompts27- In-product notifications and status messages28- Error messages and escalation copy29- Help text and guidance overlays3031Consumer users are private individuals, SME founders, students, and anyone who is not a licensed legal practitioner. The in-app experience must be empowering, plain-language, and never imply the product provides legal advice.3233---3435## Behavior — The Consumer Voice3637In-app copy in the consumer fork assumes the user:38- Has no formal legal training39- Is dealing with a real situation that feels confusing or stressful (a contract to sign, a landlord dispute, a job loss, a business to start)40- Needs orientation, plain-language explanation, and process guidance41- Is not looking for a lawyer replacement but for enough understanding to feel in control4243Copy must reflect these assumptions. Use plain English. Ground every message in the user's situation. Avoid jargon — if legal terminology is essential, always explain it. End complex-situation guidance with a "talk to a lawyer" prompt.4445---4647## Copy Rules by In-App Location4849### Onboarding / Welcome Screen5051| Element | Consumer fork rule |52|---------|------------------|53| Welcome headline | Warm, empowering: "Welcome. Let's make sense of your legal situation." |54| Sub-copy | State what the tool does: "Louis explains your rights, translates legal jargon, and helps you prepare for any legal situation." |55| Disclaimer | Prominent and plain: "Louis provides legal information, not legal advice. For complex situations, we'll tell you when to speak to a lawyer." |56| First action | Situational prompt chips: "I got a contract to sign", "I have a landlord issue", "I'm starting a business" |5758### Feature Tooltips and Discovery5960- Lead with what the user gets, in their language61- "Upload your lease and Louis will explain every clause in plain English." (not "AI-powered document analysis")62- Use empathy phrases at the start of complex features: "Contracts can be confusing. Here's what Louis will check for you."63- Always end document-generation tooltips with: "Your draft is a starting point — a lawyer can review it before you use it."6465### Empty-State Prompts6667- Situational and inviting: "What are you trying to figure out today?"68- Persona-aware chips: for consumer users, offer: "Explain this contract", "Know my rights", "Start a business", "Write a basic agreement"69- Never: "No documents yet — upload one." (not actionable enough for a non-technical consumer)7071### Upsell / Plan Upgrade Prompts7273- Frame around access to more help, not capability metrics74- "For deeper analysis and longer documents, upgrade to Louis Pro — from $[X]/month."75- Value anchor allowed: "That's less than an hour of lawyer time — for a whole month of legal clarity."76- Never: "Save thousands on lawyer fees" — banned under [[messaging-banned-claims-consumer]]7778### Error and Escalation Copy7980- Empathetic: "We couldn't analyse that document. Make sure it's a standard contract or agreement — and try again."81- Escalation prompt: "This situation sounds complex. For matters involving [court proceedings / criminal issues / children], please speak to a qualified lawyer."82- Use warm language; do not leave the user feeling abandoned: "Louis can help with a lot — but for this situation, a lawyer's guidance is essential."8384### "Talk to a Lawyer" Trigger8586In-app copy for consumer users must always include a "talk to a lawyer" trigger when:87- The user's described situation involves urgent risk (eviction, employment termination, debt enforcement)88- The document is high-stakes and finalising a legal position (not just exploring)89- The user asks about criminal, family law, or court proceedings9091The trigger copy: "For this situation, speaking to a qualified lawyer is important. Louis can help you prepare — but your lawyer should make the final call."9293---9495## Banned Patterns in Consumer Fork9697These patterns are blocked on the consumer fork:9899- "No lawyer needed" — [[messaging-banned-claims-consumer]] absolute ban100- "Legal advice" used to describe what Louis provides — UPL trigger101- "You'll win" or any outcome framing102- Technical legal jargon without explanation (not banned but fails accessibility bar)103- Cold transactional language ("Your session has expired. Log in to continue.") — consumer fork uses warmer language104105---106107## Examples108109**Strong consumer-fork in-app copy:**110> "Your lease looks like a standard residential rental. Louis spotted 2 clauses that could be negotiated — here's what they mean and how to approach it. Before you sign, it's worth a 30-minute lawyer check if anything worries you."111112**Weak (avoid in consumer fork):**113> "Contract analysis complete. 2 flags identified. Review report."114115**Strong upgrade prompt:**116> "You've asked 5 questions this month. Upgrade to Pro for unlimited questions, document analysis, and multi-jurisdiction coverage — for less than the cost of one lawyer consultation."117118**Weak upgrade prompt (avoid):**119> "Free tier limit reached. Upgrade to continue."120121---122123## Related skills124125- [[messaging-compliance-checker]]126- [[messaging-allowed-claims-consumer]]127- [[messaging-banned-claims-consumer]]128- [[messaging-surface-rule-in-app-lawyer-fork]]129- [[onboarding-b2c-vs-b2b-fork]]130- [[onboarding-empty-state-prompts]]