plans/MASCOT.md

CliniqAI — Mascot Brief

1. Does CliniqAI need a mascot?

Yes. Three reasons specific to this product:

1. Trust in clinical AI is the #1 sales blocker. Doctors and nurses adopt tools they feel friendly toward faster than tools that feel like cold software. A mascot personifies "an assistant that helps, never decides" — exactly the human-in-the-loop ethos the README commits to.
2. The product spans seven agents. Without a single character, the brand fragments. One mascot ties Documentation, Appointments, Roster, Handover, Discharge, Clerical, and Wiki into one familiar face on every screen.
3. WhatsApp is the patient channel. Patients receive reminders, post-visit summaries, and 72-hour check-ins in their personal messaging app. A small avatar at the top of those messages drops the "robot spam" feel.

The mascot should never appear on a clinical recommendation surface (e.g., a SOAP note draft) — only on supporting / orchestration / communication surfaces, so it never undermines the seriousness of clinical content.

---

2. Recommended mascot: "Asha"

2.1. Why this name

Asha (आशा) means "hope" in Hindi and Sanskrit. It is also the official name of India's Accredited Social Health Activist programme — the community health workers who are the trusted, non-clinical face of public healthcare in rural India. Borrowing this name signals:

• A helper, not a decider — Asha workers assist nurses and doctors; they do not diagnose.
• A culturally Indian product, not a US import dressed in saffron.
• Warmth and approachability that "CliniqAI" alone does not carry.

The name is short, gendered-neutral in modern use, easy to type in chat, and unique enough to trademark.

2.2. Visual concept: the origami crane formed from a folded medical chart

A friendly origami-paper crane whose body is recognisably folded from a medical record (you can see a faint EKG line and a pulse trace along one wing). The crane shape carries three meanings that all fit CliniqAI:

• Paperwork transformed. Literal metaphor — the burden of paper folds itself into something graceful that flies away. This is the elevator pitch of the product, made visual.
• Cranes are messengers across South Asian, Japanese, and Western iconography — fitting for an agent that delivers reminders, briefs, and follow-ups.
• Origami is precise, structured, and reversible. Mirrors the "structured Pydantic outputs, full audit trail, human can always unfold the decision" architecture.

2.3. Design specification

Attribute	Spec
Form	Stylised origami crane, ~3 visible folds, semi-flat shading (not photoreal)
Material texture	Subtle paper grain; one wing shows a faint EKG trace, the other a faint Devanagari character "आ" (the first letter of "Asha")
Primary colour	Soft teal #2BB6A6 — clinical, calm, not corporate blue
Accent colour	Marigold #F4B45A — a small triangular fold near the head; ties to Indian iconography without being literal
Eye	Single small dot, friendly, slightly upturned
Default pose	Mid-flight, slight forward lean, wings extended but relaxed
Optional poses	Holding a tiny clipboard (Documentation), perched on a calendar (Appointments), carrying a small WhatsApp envelope (Communication), standing next to a chart (Handover)
What to avoid	Stethoscopes, doctor coats, hospital crosses, sirens — these read "I am the doctor" and break the human-in-the-loop promise
Backgrounds	Cream paper or off-white; never a hospital scene

2.4. Where Asha appears

Surface	Asha's role
Splash screen / loader	Folding animation: paper → crane in 1.5s
Doctor approval queue (empty state)	"Nothing waiting for you. Asha is folding the next one."
WhatsApp avatar for patient messages	Small circular Asha headshot
Nurse handover brief header	Asha holding a small clipboard
404 / error pages	Asha looking puzzled, one wing slightly off-fold
Pitch deck cover, hoodie, stickers	The full crane
Never on: SOAP draft body, discharge summary body, lab result rendering	Clinical content stays clinical

2.5. Personality and voice (for microcopy)

• Tone: quietly helpful, never cute-aggressive. Closer to "your sharp colleague who's already prepared the file" than a chatty consumer assistant.
• First-person? No. Asha never says "I" or signs messages. The mascot is a face, not a voice — the system speaks plainly without anthropomorphising itself, which preserves clinical seriousness.
• Loading copy examples: "Folding your brief…", "Reading the chart…", "Almost ready for your review."

---

3. Claude-generated design prompt

Paste this into Claude (image-capable) or Claude.design to generate the first mascot pass. Iterate from here.

Design a friendly mascot called "Asha" for an Indian clinical-operations AI product
called CliniqAI. The mascot is a stylised origami paper crane folded from a sheet of
a medical chart. Show one wing carrying a faint, soft EKG pulse line and the other
wing carrying a single small Devanagari character "आ" (light brushstroke style).

Style: soft semi-flat illustration, 3–5 visible paper folds, subtle paper grain
texture, no hard outlines. Cream off-white background. The crane is mid-flight,
slight forward lean, wings extended but relaxed, a single friendly upturned-dot
eye. Soft drop shadow underneath.

Palette: primary teal #2BB6A6, accent marigold #F4B45A on a small triangular
fold near the head, paper white #FAF7EF body, charcoal #2A2E33 for the eye and
EKG line, faint warm grey #C8C0B3 for paper folds.

The mascot must feel calm, competent, and warm — like a quiet helper. Avoid:
stethoscopes, doctor coats, medical crosses, hospital settings, robots, screens,
chatbubbles, or anything that suggests the mascot makes decisions on its own.

Deliver four variations:
1. Hero pose — mid-flight, three-quarter view, full body
2. Circular avatar crop — for WhatsApp profile, head and upper wings only
3. Working pose — perched, holding a tiny clipboard (Documentation agent)
4. Loading pose — partially unfolded paper, mid-transformation, used for splash screen

Output should be transparent PNG, vector-friendly so it can be redrawn in SVG later.

---

4. Quick alternatives, ranked

If the team rejects the crane, in order of preference:

Option	Rationale	Why not first choice
Vidya the owl	Owl = wisdom, scholarly; "Vidya" = knowledge	Closer to a generic "knowledge assistant"; loses the "paperwork transformed" metaphor
A tea-cup spirit (Chai)	Warm, ubiquitous in Indian hospital break-rooms; signals "your colleague over chai"	Risks being too casual for clinical buyers; harder to scale across agent surfaces
A peacock feather (not a peacock)	Indian, elegant, recognisable; abstract enough to never overshadow clinical UI	Less narratively rich — hard to give it poses or moods
An abstract logomark only, no character	Lowest brand risk	Loses every reason a mascot exists in the first place

---

5. Recommendation

Adopt Asha the origami-paper crane as the official CliniqAI mascot. Generate the four design variations above with Claude, refine to SVG, and roll it out on the splash screen and WhatsApp avatar first — those are the two surfaces where trust gain per pixel is highest.