Skip to content

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) ​

BandScoreLabel
High≥ 85High readiness
Moderate70–84Moderate readiness
Low50–69Low readiness
Poor< 50Poor readiness

Sleep recommendation ​

Derived from readiness via sleep_hours = 6 + (1 − score/100) × 4 (range 6–10 h), then bracketed:

BandScorePrompt
Normal≥ 85🟢 Normal recovery: 6–7 hrs sufficient
Moderate70–84🟡 Moderate recovery: aim for 7–8 hrs
Enhanced50–69🟠 Enhanced recovery: aim for 8.5–9.5 hrs
Maximise< 50🔴 Maximise recovery: target 10+ hrs sleep

Workload recommendation ​

BandScorePrompt
High≥ 75🟢 High readiness — OK to proceed with full workload
Moderate50–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:

  1. The exact wording of each bracket prompt (sleep × 4 bands, workload × 3 bands)
  2. Any additional prompts triggered by Moreton Blue baseline correlations once that reference data is in
  3. 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.

Internal documentation — org members only