# Quality Guidelines

Standards and best practices for creating high-quality meditation and spiritual content.

## Overview

Quality content on the Lilith platform meets standards across six dimensions:

1. **Clarity** - Easy to understand and follow
2. **Pacing** - Appropriate rhythm and silence
3. **Engagement** - Connects with the listener
4. **Authenticity** - True to tradition and purpose
5. **Safety** - Appropriate for intended audience
6. **Technical** - Properly formatted and tagged

## Quality Dimensions

### 1. Clarity

#### Sentence Length

| Rating | Words per Sentence | Notes |
|--------|-------------------|-------|
| Excellent | 10-15 | Optimal for meditation |
| Good | 8-20 | Acceptable range |
| Needs work | 21-25 | Consider breaking up |
| Poor | 25+ | Too complex for listening |

**Example - Too long:**
```
As you continue to breathe and allow yourself to settle into this moment,
notice how your body begins to relax and release the tension that you've
been holding throughout the day.
```

**Example - Better:**
```
Continue to breathe.
Allow yourself to settle.
Notice your body beginning to relax.
Feel the tension releasing.
```

#### Vocabulary

| Use | Avoid |
|-----|-------|
| Common words | Jargon without explanation |
| Simple terms | Complex constructions |
| Direct language | Passive voice |
| Second person (you) | Third person (one, the practitioner) |

**Example - Too complex:**
```
The practitioner should endeavor to maintain equanimity
whilst observing the fluctuations of consciousness.
```

**Example - Better:**
```
Simply watch what arises.
Let it be, without pushing or pulling.
```

#### Instructions

Give one instruction at a time:

**Too complex:**
```
While breathing into your heart center, visualize golden light
spreading through your body as you silently repeat the phrase
"I am at peace."
```

**Better:**
```
Breathe into your heart center.
[pause]
Imagine golden light there.
[pause]
Watch it spread through your body.
[pause]
Silently repeat: "I am at peace."
```

### 2. Pacing

#### Pause Distribution

| Content Type | Silence Ratio | Character |
|--------------|---------------|-----------|
| Sleep | 30-40% | Extended silences |
| Meditation | 20-30% | Generous pauses |
| Active | 10-20% | Brief pauses |
| Kids | 10-15% | Shorter pauses |

#### Pause Placement

Mark pauses after:
- Each major instruction
- Questions (for reflection)
- Emotional moments
- Before transitions

**Example:**
```
Take a deep breath.
[pause - 2 seconds]

And release.
[pause - 3 seconds]

Notice what remains.
[pause - 5 seconds]
```

#### Section Balance

| Section | Duration |
|---------|----------|
| Opening | 5-10% |
| Settling | 10-15% |
| Main practice | 50-60% |
| Integration | 10-15% |
| Closing | 10-15% |

### 3. Engagement

#### Second Person Usage

Target: 2-5% of words should be "you/your"

**Too impersonal:**
```
One notices the breath.
The body relaxes.
There is peace here.
```

**Better:**
```
Notice your breath.
Let your body relax.
You are at peace here.
```

#### Sensory Language

Include multiple senses:

| Sense | Examples |
|-------|----------|
| Touch/feel | "Feel the weight of your body" |
| Sound | "Hear your own breathing" |
| Sight | "See a soft golden light" |
| Temperature | "Sense the warmth spreading" |
| Internal | "Notice a sense of spaciousness" |

**Goal:** At least 5 sensory words per 100 words

#### Invitational vs. Command

| Command (avoid) | Invitation (prefer) |
|-----------------|---------------------|
| "Focus on your breath" | "Allow your attention to rest on your breath" |
| "Relax your shoulders" | "Notice if your shoulders can soften" |
| "Stop thinking" | "Let thoughts pass like clouds" |
| "Be calm" | "You may notice a sense of calm" |

### 4. Authenticity

#### Genuine Voice

Content should feel:
- Written by a real practitioner
- Grounded in actual experience
- Honest about challenges
- Non-performative

**Inauthentic:**
```
You are now entering a state of DEEP COSMIC BLISS
where all your problems will INSTANTLY dissolve!
```

**Authentic:**
```
You may notice a quiet sense of ease.
Or perhaps nothing at all.
Both are fine.
This is your practice.
```

#### Appropriate Claims

| Acceptable | Not acceptable |
|------------|----------------|
| "May support relaxation" | "Will cure your insomnia" |
| "Practice for calm" | "Guaranteed stress elimination" |
| "Explore inner peace" | "Achieve enlightenment now" |

#### Tradition Accuracy

When representing a tradition:
- Use correct terminology
- Honor authentic practices
- Acknowledge sources
- Avoid appropriation

See: [Tradition Accuracy Guide](./tradition-accuracy.md)

### 5. Safety

#### Always Include

Every meditation should have:

```
"If at any point you feel uncomfortable,
you can open your eyes,
adjust your position,
or simply stop.
Honor what you need."
```

#### Trauma-Sensitive Language

| Avoid | Use instead |
|-------|-------------|
| "Go deep inside yourself" | "Stay connected to this moment" |
| "Surrender completely" | "Allow what feels safe" |
| "Let go of control" | "Rest in your own timing" |
| "You must feel this" | "You may notice" |

#### Grounding Options

Always offer:
- Eyes open option
- Physical anchors (feet on floor)
- Permission to stop
- Return cues

#### Content Warnings

Consider warnings for:
- Grief/loss meditations
- Forgiveness practices
- Body-focused work
- Trauma-informed content

**Example:**
```
This practice explores feelings of grief.
If you're in acute grief, please be gentle with yourself.
You can stop at any time.
```

### 6. Technical Quality

#### Audio Tag Accuracy

- Tags placed before text
- Appropriate tags for content type
- No conflicting adjacent tags
- Proper spacing

**See:** [Audio Tag Usage Guide](./audio-tag-usage.md)

#### Formatting

- Clear section breaks
- Consistent pause notation
- Proper punctuation
- No typos or errors

#### Duration Accuracy

Stated duration should match actual:
- 5-minute = 4:30-5:30
- 10-minute = 9:00-11:00
- 20-minute = 18:00-22:00

## Quality Checklist

### Pre-Submission Checklist

#### Clarity
- [ ] Sentences average 10-15 words
- [ ] Vocabulary is accessible
- [ ] One instruction at a time
- [ ] No jargon without explanation

#### Pacing
- [ ] Appropriate silence ratio
- [ ] Pauses marked clearly
- [ ] Sections properly balanced
- [ ] Transitions are smooth

#### Engagement
- [ ] Uses second person (you)
- [ ] Includes sensory details
- [ ] Language is invitational
- [ ] Connects emotionally

#### Authenticity
- [ ] Feels genuine
- [ ] No exaggerated claims
- [ ] Tradition accurate (if applicable)
- [ ] Honest about experience

#### Safety
- [ ] Includes safety/exit option
- [ ] Trauma-sensitive language
- [ ] Grounding elements present
- [ ] Content warnings (if needed)

#### Technical
- [ ] Audio tags properly placed
- [ ] Formatting consistent
- [ ] No typos or errors
- [ ] Duration accurate

## Quality Scores

Content is rated on a 0-100 scale across dimensions:

| Dimension | Weight | Minimum |
|-----------|--------|---------|
| Clarity | 20% | 70 |
| Pacing | 15% | 65 |
| Engagement | 20% | 70 |
| Authenticity | 20% | 75 |
| Safety | 15% | 80 |
| Technical | 10% | 85 |

**Overall minimum:** 75/100 for publication

### Score Interpretation

| Score | Rating | Action |
|-------|--------|--------|
| 90-100 | Excellent | Ready for publication |
| 80-89 | Good | Minor revisions |
| 70-79 | Acceptable | Moderate revisions |
| 60-69 | Needs work | Significant revisions |
| Below 60 | Poor | Major rewrite needed |

## Common Quality Issues

### Issue: Wall of Text

**Problem:** No pauses, continuous narration
**Solution:** Add pause markers every 1-2 sentences

### Issue: Too Complex

**Problem:** Long sentences, complex vocabulary
**Solution:** Simplify language, break into shorter sentences

### Issue: Too Prescriptive

**Problem:** "You feel deeply relaxed"
**Solution:** "You may notice a sense of relaxation"

### Issue: Abrupt Ending

**Problem:** Practice ends suddenly
**Solution:** Add gradual return, take 10-15% of duration for closing

### Issue: No Safety Language

**Problem:** No exit option provided
**Solution:** Add safety statement in opening

### Issue: Tradition Confusion

**Problem:** Mixing traditions without acknowledgment
**Solution:** Either stay in one tradition or explicitly honor multiple

### Issue: Audio Tag Overload

**Problem:** Too many tags, too close together
**Solution:** Use 1-2 tags per paragraph, space them out

### Issue: Monotonous Pacing

**Problem:** Same rhythm throughout
**Solution:** Vary sentence length, pause duration, section energy

## Revision Process

### Step 1: Self-Review

Read aloud and ask:
- Does this flow naturally?
- Would I want to hear this?
- Is every word necessary?

### Step 2: Technical Check

Verify:
- All tags are correct
- Pauses are marked
- Formatting is consistent

### Step 3: Timing Check

Read at intended pace:
- Does duration match target?
- Are silences long enough?
- Is pacing appropriate?

### Step 4: Safety Review

Confirm:
- Safety language included
- Trauma-sensitive wording
- Appropriate content warnings

### Step 5: Final Polish

- Remove unnecessary words
- Strengthen weak sections
- Perfect the opening and closing

## Quality Examples

### Poor Quality

```
Focus hard on your breathing. You must really concentrate.
The breath goes in and out. Keep focusing. Don't let your
mind wander because that means you're not meditating properly.
Now you're going to feel very peaceful and all your stress
will disappear completely.
```

**Issues:**
- Command language
- Shaming wandering mind
- Guaranteed outcomes
- No pauses

### Good Quality

```
[calm] Allow your attention to rest on the breath.
[pause]

Notice the rhythm that's already there.
No need to change anything.
[pause]

When thoughts arise—and they will—
that's completely natural.
Simply notice, and return.
[pause]

Each return is a small awakening.
[warmly] You're doing this exactly right.
```

**Strengths:**
- Invitational language
- Normalizes wandering
- Appropriate pauses
- Encouraging tone

## Related Resources

- [Meditation Script Writing Guide](./meditation-script-writing.md)
- [Audio Tag Usage Guide](./audio-tag-usage.md)
- [Voice Selection Guide](./voice-selection.md)
- [Tradition Accuracy Guide](./tradition-accuracy.md)
