Wellness Coaching Style Guide
Status: Engineering draft for Matt's review. Matt will prescribe the final coaching prompts once Moreton Blue baseline reference data is provided (per Matt's 3 May 2026 Notion comment on the PPP Pulse Wellness brief).
Why this doc exists
The Wellness brief commits PPP to coaching prompts that "acknowledge that doctors have roles and responsibilities; sometimes they work at increased capacity for a period and rest later. Comms must reflect this, not lecture." This guide codifies that tone so the brackets and prompt copy are consistent across the dashboard, notifications and any future supportive-alert channel.
It is also the engineering deliverable for Q_M4 in wellness.md § Open Questions. Once Matt prescribes final prompt copy, the brackets table in wellness.md § PPP Pulse Score Brackets will be updated to match and this guide becomes the rules-of-the-road for any future coaching content.
Tone principle
Acknowledge shift realities. Never lecture.
Doctors run elective lists, on-call, and post-take rounds where capacity has to be sustained for a period and rest comes later. The app is a mirror — it reflects data and offers a single suggestion the user can take or leave. It is not a coach, parent, or compliance officer.
Forbidden patterns
- Exclamation marks. "Great job!" reads as performative.
- "You must" / "you should" / "make sure you". Directives erode trust; doctors decide for themselves.
- Emojis other than the readiness-band traffic light (🟢 🟡 🟠 🔴). No clapping hands, no muscle, no fire.
- References to specific clock times (e.g. "go to bed by 22:30"). The app does not know the user's shift pattern at message-render time.
- Generic motivational copy ("You've got this", "Keep pushing"). It signals a wellness app rather than a clinical tool.
- Lecturing on consequences ("Lack of sleep increases medical error risk"). The user knows.
Allowed patterns
- Acknowledge the data: "Your readiness is 68 today."
- Suggest, don't direct: "consider", "aim for", "target". Never "must", "should".
- One specific number: the deficit, the recommended hours, the score. Never multiple.
- One primary action. No menu of options inside a prompt.
- Acknowledge constraints: "If your shift allows, …" is preferred to a bare directive.
Bracket framework
These brackets are mirrored from wellness.md § PPP Pulse Score Brackets — keep them in sync.
Readiness score (0–100)
| Band | Score | Label |
|---|---|---|
| High | ≥ 85 | High readiness |
| Moderate | 70–84 | Moderate readiness |
| Low | 50–69 | Low readiness |
| Poor | < 50 | Poor readiness |
Sleep recommendation
Derived from readiness via sleep_hours = 6 + (1 − score/100) × 4 (range 6–10 h), then bracketed:
| Band | Score | Prompt |
|---|---|---|
| Normal | ≥ 85 | 🟢 Normal recovery: 6–7 hrs sufficient |
| Moderate | 70–84 | 🟡 Moderate recovery: aim for 7–8 hrs |
| Enhanced | 50–69 | 🟠 Enhanced recovery: aim for 8.5–9.5 hrs |
| Maximise | < 50 | 🔴 Maximise recovery: target 10+ hrs sleep |
Workload recommendation
| Band | Score | Prompt |
|---|---|---|
| High | ≥ 75 | 🟢 High readiness — OK to proceed with full workload |
| Moderate | 50–74 | 🟡 Moderate readiness — consider moderating intensity |
| Low / Poor | < 50 | 🟠 Low readiness — consider reducing demanding tasks or plan more rest |
Examples — compliant vs non-compliant
Sleep prompt (Low readiness, 58)
- ✅ Compliant: "Your readiness is 58. If your shift allows, target 8.5–9.5 hrs sleep tonight."
- ❌ Non-compliant: "You must sleep at least 9 hours tonight! 💤 Don't skimp on rest!" (directive, exclamation, generic emoji)
- ❌ Non-compliant: "Lack of sleep increases medical error risk. Go to bed by 22:30." (lecture, fixed clock time)
Workload prompt (Moderate readiness, 71)
- ✅ Compliant: "Readiness 71 — consider moderating intensity today where you can."
- ❌ Non-compliant: "You should cancel non-essential cases today!" (directive on clinical decisions)
Reference — CPD reminder copy (already approved by Matt)
The CPD Home reminder banners (cpd-home.md § CPD Reminder Banner) are written in the same tone and serve as a working example of compliant copy:
- "Your plan is still in draft. Locking it now means we can track progress automatically. → Submit plan"
- "You're hours behind your pro-rata target (%). Logging an activity takes a minute. → Log activity"
- "You've reached % of your CPD target — / hours logged. Keep going."
Each: acknowledges the data, single specific number, single primary action, no exclamation marks.
What Matt prescribes
This guide gives the rules. Matt prescribes the content — specifically:
- The exact wording of each bracket prompt (sleep × 4 bands, workload × 3 bands)
- Any additional prompts triggered by Moreton Blue baseline correlations once that reference data is in
- The cadence — how often a given user can see the same prompt before it becomes noise
Until Matt prescribes, the bracket table in wellness.md is the engineering placeholder.