conversation-followup-suggestions

Category: General Risk: Low risk ★ 3.9 · Rating 3.9/5 (8) sboghossian/mini-claude-for-legal MIT

Rating is derived from the repo's GitHub stars and shown for reference.

automation_control

name: conversation-followup-suggestions
description: Use after every substantive legal-AI response to append exactly three concrete, action-first follow-up prompts that the user can click or select as their next step. Governs the format (3 chips, ≤8 words each), differentiation rules, and when to skip entirely. Applies to all personas and practice areas. Rendered as chip buttons in the frontend.
license: MIT
metadata:
id: conversation.followup-suggestions
category: conversation
priority: P1
intent: [core]
related: [conversation-clarifying-questions, conversation-disclaimer, conversation-empathy-b2c]
source: Louis — HAQQ Legal AI (github.com/sboghossian/mini-claude-for-legal)
version: "1.0"

Follow-up Suggestions

When this applies

After every substantive legal-AI response — a response that answered a question, produced a document, completed a review, or provided analysis — append exactly three follow-up prompt suggestions. These are rendered by the frontend as clickable chip buttons below the message.

A "substantive" response is:

  • A legal-content answer (not just a clarifying question).
  • A completed document draft or document review.
  • A research result or jurisdiction analysis.
  • A strategy explanation or next-step guide.

The rule: exactly 3

  • Less than 3 is anemic. One or two suggestions implies the user's options are limited.
  • More than 3 is overwhelming. Four or five suggestions creates decision paralysis.
  • Exactly 3. No exceptions.

Format rules

Action-first, ≤8 words

Each suggestion must:

  • Start with an imperative verb ("Draft," "Compare," "Explain," "Summarize," "File," "Find," "Show," "Calculate").
  • Be ≤8 words — this is a chip, not a sentence.
  • Be immediately understandable — no ambiguity about what clicking it will do.

Good:

  • "Draft a counter-redline accepting clauses 1–3"
  • "Compare these terms to our standard NDA"
  • "Find a labor lawyer in Dubai"

Bad:

  • "I could draft a counter-redline for you" (non-imperative; too long)
  • "More information" (vague)
  • "Legal options" (not action-first; too vague)

Differentiated

The three suggestions must be meaningfully different from each other. Do not offer three variants of the same action:

Bad (all three are essentially "draft something"):

  1. "Draft a response letter"
  2. "Write a counter-proposal"
  3. "Prepare a draft reply"

Good (three genuinely different next steps):

  1. "Draft a response letter to the landlord"
  2. "Explain the eviction timeline in Dubai"
  3. "Find a tenant rights lawyer near me"

A good set covers different dimensions:

  • Create something (draft, generate, prepare)
  • Understand something (explain, summarize, compare, calculate)
  • Take an action (find, file, schedule, connect)

Matter-relevant

Suggestions must be specific to this conversation, not generic. After reviewing an employment contract:

Generic (bad):

  1. "Draft a document"
  2. "Explain the law"
  3. "Get legal help"

Matter-specific (good):

  1. "Redline clause 14 (IP assignment) — flag for negotiation"
  2. "Compare non-compete scope to UAE Labor Law standards"
  3. "Draft a clarification email to HR about clause 8"

Examples by practice area

After an NDA review

  1. "Suggest a redline accepting clauses 1–3, rejecting 4"
  2. "Draft a counter-proposal email to the other side"
  3. "Compare these terms against our standard NDA template"

After a jurisdiction analysis on arbitration

  1. "Draft a DIAC arbitration clause for this contract"
  2. "Compare DIFC-LCIA vs ICC for this dispute value"
  3. "Explain the emergency arbitrator procedure under DIAC rules"

After a consumer-facing employment termination answer

  1. "Draft a formal grievance letter to my employer"
  2. "Calculate my end-of-service gratuity under UAE Labor Law"
  3. "Find a labor lawyer in [user's city]"

After a data-privacy gap analysis

  1. "Draft a GDPR-compliant privacy notice"
  2. "Prioritize the remediation roadmap by risk level"
  3. "Check if we need to appoint a DPO in the EU"

When to skip

Do not append follow-up suggestions when:

Condition Why
Response was a clarifying question only No substantive answer yet; suggestions would be premature
Response was admin/billing/settings No legal content; irrelevant
User is in mid-OCR / document-processing flow Mid-process state; suggestions would interrupt the flow
Response was a disclaimer-only refusal Suggesting next steps after a refusal is confusing
The user has already selected a suggestion from the previous turn You're executing that suggestion; don't pile on new ones until the result is delivered

Technical note — rendering

The frontend renders these as chip buttons below the assistant message. The text for each chip is:

  • The suggestion text exactly as written (no markdown formatting in the chip text).
  • If the user clicks a chip, the chip text is submitted as a new user message.

This means the text must work as a natural-language prompt when submitted — not as a heading or label. "Draft a counter-redline accepting clauses 1–3" works as a message; "Counter-redline" does not.

Multilingual

For Arabic-language conversations, the suggestions must also be in Arabic:

  • Imperative verb first (Arabic verb-first structure works well here).
  • ≤8 Arabic words.
  • Right-to-left rendering handled by the frontend.

For French-language conversations: same rules apply in French.

  • [[conversation-clarifying-questions]]
  • [[conversation-disclaimer]]
  • [[conversation-empathy-b2c]]