# OSHUN V1 Tara Content Tone Standards

Status: Accepted v1.0  
Owner: OSHUN Design + Product + Engineering  
Last Updated: March 26, 2026  
Implements: `V1-UX-036`  
Related:

- `docs/releases/v1/design/ux-principles.md`
- `docs/releases/v1/design/readability-standards.md`
- `docs/releases/v1/scope/immersive-vs-utilitarian-posture-rules.md`
- `docs/releases/v1/scope/scan-first-content-hierarchy-rules.md`
- `docs/releases/v1/specs/web-app-admin-v1-prd.md`
- `docs/releases/v1/specs/product-brief.md`
- `apps/oshun/web/src/components/domains/TaraSurface.tsx`
- `apps/oshun/web/src/components/domains/tara/SessionLibrary.tsx`
- `apps/oshun/web/src/components/domains/tara/TaraCourses.tsx`
- `apps/oshun/web/src/components/domains/tara/BreathworkTimer.tsx`
- `apps/oshun/web/src/components/domains/tara/SessionPlayer.tsx`
- `apps/tara/mobile/src/store/meditationStore.ts`
- `apps/tara/web/messages/en.json`
- `docs/releases/v1/specs/todos.md`

## 1. Purpose

This document defines the canonical content tone for Tara-led surfaces in OSHUN
V1.

Tara is not just another domain voice. The product PRD defines Tara as the
emotional and behavioral center of gravity for OSHUN. That means Tara copy sets
the standard for how the product invites presence, reflection, calm transitions,
sleep support, and intentional practice.

This standard exists so Tara can feel:

- calm
- warm
- competent
- speakable
- non-manipulative

without becoming vague, saccharine, mystical haze, or generic wellness
marketing.

## 2. Current Repo Signals And Gap

Current implementation review already shows a recognizable Tara tone:

- `TaraSurface.tsx` uses short, calm labels such as `2-min reset`,
  `Morning clarity breath`, `Begin session`, and
  `Guided sessions, breathwork sequences, and progressive courses to build a consistent practice.`
- `SessionPlayer.tsx` and `BreathworkTimer.tsx` use grounded phase labels such
  as `Settle in`, `Breath awareness`, `Closing bell`, `Breathe in`, and
  `Breathe out`.
- `TaraCourses.tsx` favors gentle, practice-based lesson naming such as
  `Just breathe`, `The wandering mind`, `Body scan`, `Compassion`, and
  `Integration`.
- `apps/tara/mobile/src/store/meditationStore.ts` uses plain supportive copy
  like `Find calm in the storm`, `Start your day with intention`, and
  `Prepare for restful sleep with gentle guidance.`
- `apps/tara/web/messages/en.json` uses simple completion language:
  `Well done! Take a moment to notice how you feel.`
- `READABILITY_STANDARDS.md` and
  `OSHUN_V1_IMMERSIVE_VS_UTILITARIAN_POSTURE_RULES.md` already establish that
  Tara should be calm, scannable, immersive where it lowers stress, and plain
  when the user is managing continuity.
- `UX_PRINCIPLES.md` explicitly rejects guilt-based progress copy.

The gap is governance. Tara copy patterns exist across many good local examples,
but there is not yet one canonical tone system telling future surfaces how warm
to be, how direct to be, how much spiritual language is acceptable, and what
must be avoided.

## 3. Canonical Tone Thesis

Tara should sound like a steady guide, not a hype machine and not a detached
clinical interface.

The canonical Tara voice is:

- grounded rather than mystical-by-default
- gentle rather than passive
- clear rather than poetic-for-poetry's-sake
- encouraging rather than demanding
- intimate enough to feel human, but not confessional or overfamiliar

Tara is allowed to feel contemplative. Tara is not allowed to feel:

- guilty
- preachy
- breathless
- saccharine
- pseudo-sacred
- medically overclaiming

## 4. Tone Pillars

### 4.1 Calm And Centered

Tara copy should lower pressure.

It should sound like the interface is making room for the user to arrive, not
like it is pushing them toward urgency or performance.

### 4.2 Warm And Respectful

Warmth is welcome. Familiarity is limited.

Tara should not call the user pet names, overuse exclamation points, or act as
though it knows the user's inner state better than the user does.

### 4.3 Specific And Practice-Based

Tara should name the actual practice:

- breathwork
- body scan
- loving-kindness
- evening wind-down
- guided session
- reflection

Specificity builds trust. Vague spiritual uplift language weakens it.

### 4.4 Invitational, Not Coercive

Tara can invite, suggest, and encourage.

Tara should not:

- pressure the user to keep a streak
- imply moral failure for missing a session
- weaponize self-improvement language
- use guilt to drive retention

### 4.5 Speakable And Breathable

Much Tara copy will be heard, read aloud, or scanned in quiet moments.

Sentence rhythm should support that use:

- short clauses
- low jargon density
- few stacked modifiers
- one idea at a time

## 5. Language Rules

### 5.1 Sentence Shape

- Headings should usually stay within `2-5` words.
- Supporting copy should usually be one short sentence.
- Multi-step instruction copy should break into separate cues instead of one
  long compound sentence.
- When an instruction may be spoken aloud, it should read naturally in a slow
  voice.

### 5.2 Preferred Verbs

Prefer verbs such as:

- begin
- breathe
- settle
- notice
- return
- soften
- ground
- rest
- reflect
- continue
- pause

These verbs are calm but active.

### 5.3 Preferred Framing

Prefer framing like:

- `Take a moment to notice how you feel.`
- `Start your day with intention.`
- `Wind down and release the day's stress.`
- `Build a steady practice.`
- `Gentle guidance for sleep.`

This framing is concrete, quiet, and non-theatrical.

### 5.4 Vocabulary To Use Carefully

Words tied to specific contemplative traditions are acceptable when they are:

- accurate
- necessary
- paired with plain-language explanation on first use

Examples:

- `metta`
- `yoga nidra`
- `Nadi Shodhana`
- `Vipassana`

Do not assume every user already knows these terms.

### 5.5 Vocabulary To Avoid

Avoid language such as:

- `crush your streak`
- `fix yourself`
- `optimize your soul`
- `unlock your highest vibration`
- `never miss a day`
- `cleanse your energy field`
- `become the best version of yourself tonight`

Also avoid inflated wellness filler like:

- `transformational sacred journey` when the actual feature is a
  `10-minute sleep session`
- `quantum awakening` or other pseudo-explanatory metaphysics

## 6. Surface-Specific Tone Rules

### 6.1 Home And Discovery Surfaces

Goal:

- orient the user
- suggest a next practice
- lower the cost of beginning

Rules:

- Lead with the practice, duration, or benefit.
- Keep discovery copy short and scannable.
- Promise only what the session actually does.
- Favor calm benefit language over grand transformation claims.

Good patterns:

- `Morning clarity breath`
- `2-min reset`
- `Nightly wind-down routines`

### 6.2 Pre-Session And Launch Surfaces

Goal:

- help the user begin without friction

Rules:

- Use direct action labels such as `Begin session`, `Start breathwork`, or
  `Continue practice`.
- Supporting text should reassure without overexplaining.
- Do not add motivational speeches before the user can start.

### 6.3 In-Session Guidance

Goal:

- support the user's attention without competing with it

Rules:

- One cue at a time.
- Use breath-sized instruction units.
- Prefer plain imperatives such as `Breathe in`, `Hold`, `Notice the breath`,
  `Return gently`.
- Avoid paragraph-length spoken guidance in UI text surfaces.
- Avoid melodrama, guru voice, and claims of certainty about the user's inner
  experience.

### 6.4 Post-Session Reflection And Completion

Goal:

- acknowledge the practice
- create space for reflection
- offer the next step lightly

Rules:

- Completion language should be calm and affirming.
- Reflection prompts should invite noticing, not demand insight.
- If a next action is offered, keep it optional in tone.

Good pattern:

- `Well done. Take a moment to notice how you feel.`

Avoid:

- `Amazing job! You're unstoppable!`
- `Don't lose this momentum now.`

### 6.5 Progress, Streaks, And Continuity

Goal:

- encourage continuity without manipulation

Rules:

- Celebrate meaningful consistency.
- Never frame a missed session as failure.
- Do not imply that worth, discipline, or healing is revoked by interruption.
- Progress copy should sound supportive and recoverable.

Good:

- `7-day rhythm`
- `Ready to return?`
- `Pick up where you left off.`

Avoid:

- `You broke your streak.`
- `Don't fall behind.`
- `Miss another day and lose progress.`

### 6.6 Notifications And Reminders

Goal:

- invite a return at the right moment

Rules:

- Keep reminders low-pressure and time-aware.
- Sound like an open door, not a reprimand.
- Use gentle temporal framing such as morning, afternoon, wind-down, or sleep
  preparation.

Good:

- `A 10-minute wind-down is ready when you are.`
- `Take a mindful break to recharge your afternoon.`

### 6.7 Technical, Settings, And Recovery Surfaces

Goal:

- stay calm without becoming vague

Rules:

- When the user is adjusting audio, permissions, downloads, or device
  connectivity, Tara must become plain and practical.
- Do not wrap technical recovery in ritual framing.
- Name the issue, preserve calm, and give the next step.

Good:

- `Audio paused while the connection recovers. Your place is saved.`

Avoid:

- `Breathe through this interruption while Tara realigns your stream.`

### 6.8 Cross-Domain Handoffs From Tara

Goal:

- carry Tara calm into the next surface without turning the handoff into a
  marketing pitch

Rules:

- Handoffs should describe why the next surface fits the user's current state.
- Use bridging language such as reflection, carry forward, continue, or deepen.
- Keep the tone invitational, never upsell-heavy.

Good:

- `Carry this calm into a short Nisaba reading.`

## 7. Do And Do Not Examples

| Scenario        | Do                                                     | Do not                                            |
| --------------- | ------------------------------------------------------ | ------------------------------------------------- |
| session card    | `Evening reflection`                                   | `Transcend into nocturnal serenity`               |
| launch CTA      | `Begin session`                                        | `Awaken now`                                      |
| guidance cue    | `Notice the breath.`                                   | `Surrender completely to the cosmic inhale.`      |
| progress        | `Ready to return?`                                     | `You are falling off your path.`                  |
| reminder        | `Start your day with intention.`                       | `You still have not meditated today.`             |
| completion      | `Take a moment to notice how you feel.`                | `You crushed it. Keep the streak alive.`          |
| technical issue | `Playback will resume when the connection stabilizes.` | `Energy flow interrupted. Please remain patient.` |

## 8. Definition Of Done For Tara Copy

Tara copy meets the OSHUN V1 tone standard only when it is:

- calm enough to lower pressure
- specific enough to build trust
- short enough to scan or hear comfortably
- warm without becoming sentimental
- encouraging without guilt
- contemplative without becoming vague or pseudo-sacred
- practical when the user is handling settings, recovery, or continuity work

If a Tara surface sounds like a productivity coach, a luxury wellness ad, or a
cryptic spiritual oracle, it is off-tone.
