# Course Structure Guidelines

## Overview

This document provides comprehensive guidelines for creating structured learning
experiences on the Lilith platform. Courses are progressive learning journeys
that combine meditation sessions, teachings, exercises, and contemplations to
guide users through systematic skill development.

## Table of Contents

1. [Course Types](#course-types)
2. [Course Design Principles](#course-design-principles)
3. [Lesson Types](#lesson-types)
4. [Course Structure Templates](#course-structure-templates)
5. [Progression Design](#progression-design)
6. [Content Components](#content-components)
7. [Data Structure Requirements](#data-structure-requirements)
8. [Quality Checklist](#quality-checklist)

---

## Course Types

The platform supports four course types:

| Type         | Description                                 | Typical Use Case                 |
| ------------ | ------------------------------------------- | -------------------------------- |
| `course`     | Structured learning with sequential lessons | "7-Day Meditation Basics"        |
| `series`     | Related content without strict order        | "Stress Relief Collection"       |
| `collection` | Curated content bundles                     | "Best of Zen Meditations"        |
| `path`       | Multi-course learning journey               | "Journey to Mindfulness Mastery" |

### Course vs. Series

| Aspect            | Course                       | Series             |
| ----------------- | ---------------------------- | ------------------ |
| Order             | Sequential (Day 1, Day 2...) | Flexible           |
| Prerequisites     | Yes                          | No                 |
| Progress Tracking | Lesson-by-lesson             | Content-by-content |
| Completion        | All lessons required         | Optional           |
| Duration          | Fixed (7/14/21/30 days)      | Open-ended         |

---

## Course Design Principles

### 1. Progressive Skill Building

Courses must follow a progressive structure that builds skills incrementally:

```
Foundation → Core Skills → Integration → Application
```

**Example: 7-Day Beginner Course**

- Days 1-2: Foundation (breath awareness, posture)
- Days 3-4: Core Skills (concentration, body awareness)
- Days 5-6: Integration (combining techniques)
- Day 7: Application (daily life integration)

### 2. Daily Practice Commitment

| Duration Type | Daily Time | Total Course Days | Best For                    |
| ------------- | ---------- | ----------------- | --------------------------- |
| Quick Start   | 5-10 min   | 5-7 days          | Beginners, time-constrained |
| Standard      | 10-15 min  | 7-14 days         | General audience            |
| Deep Dive     | 15-30 min  | 14-30 days        | Committed practitioners     |
| Intensive     | 30-60 min  | 21-60 days        | Advanced, retreat-style     |

### 3. Consistent Rhythm

Each lesson should follow a predictable rhythm:

1. **Opening** (1-2 min) - Welcome, context, intention
2. **Teaching** (2-5 min) - New concept or technique
3. **Practice** (5-20 min) - Guided meditation/exercise
4. **Integration** (1-2 min) - Takeaways for the day

### 4. Manageable Cognitive Load

- One new concept per lesson maximum
- Review previous concepts before introducing new ones
- Provide written summaries for complex teachings
- Allow rest days in longer courses (14+ days)

---

## Lesson Types

Each lesson has a primary type determining its content format:

| Type          | Description                       | Duration     | When to Use             |
| ------------- | --------------------------------- | ------------ | ----------------------- |
| `meditation`  | Guided meditation practice        | 5-30 min     | Core practice sessions  |
| `audio`       | Audio teaching without meditation | 3-10 min     | Concept introductions   |
| `video`       | Video teaching                    | 3-15 min     | Visual demonstrations   |
| `text`        | Written content                   | 3-5 min read | Detailed explanations   |
| `quiz`        | Knowledge check                   | 2-5 min      | Mid-course/end review   |
| `exercise`    | Active practice assignment        | Varies       | Journaling, observation |
| `interactive` | Interactive content               | 5-15 min     | Technique selection     |

### Lesson Type Distribution

**Recommended distribution for a 7-day course:**

| Day | Primary Lesson | Secondary Content   |
| --- | -------------- | ------------------- |
| 1   | Video (intro)  | Meditation          |
| 2   | Meditation     | Text (recap)        |
| 3   | Meditation     | Audio (teaching)    |
| 4   | Meditation     | Exercise (journal)  |
| 5   | Meditation     | Text (deepening)    |
| 6   | Meditation     | Quiz (review)       |
| 7   | Meditation     | Video (integration) |

---

## Course Structure Templates

### 7-Day Beginner Course

**Target:** New to meditation **Daily Time:** 10-15 minutes **Focus:** Single
skill (e.g., breath awareness, stress relief)

```
Day 1: Welcome & First Practice
├── Lesson 1.1: Course Introduction (video, 3 min)
├── Lesson 1.2: What is Meditation? (text, 2 min read)
└── Lesson 1.3: Your First Meditation (meditation, 5 min)

Day 2: Building Foundation
├── Lesson 2.1: Finding Your Posture (text/video, 3 min)
└── Lesson 2.2: Breath Awareness Basics (meditation, 8 min)

Day 3: Deepening Practice
├── Lesson 3.1: Working with Distractions (audio, 3 min)
└── Lesson 3.2: Guided Practice (meditation, 10 min)

Day 4: Common Challenges
├── Lesson 4.1: When Your Mind Wanders (text, 2 min)
├── Lesson 4.2: Guided Practice (meditation, 10 min)
└── Lesson 4.3: Reflection Exercise (exercise, 5 min)

Day 5: Expanding Awareness
├── Lesson 5.1: Body Awareness Introduction (audio, 3 min)
└── Lesson 5.2: Body-Breath Connection (meditation, 12 min)

Day 6: Integration
├── Lesson 6.1: Making It a Habit (text, 3 min)
├── Lesson 6.2: Full Practice (meditation, 12 min)
└── Lesson 6.3: Knowledge Check (quiz, 3 min)

Day 7: Moving Forward
├── Lesson 7.1: Your Meditation Journey (video, 4 min)
├── Lesson 7.2: Final Practice (meditation, 15 min)
└── Lesson 7.3: Completion & Next Steps (text, 2 min)
```

### 14-Day Intermediate Course

**Target:** Some meditation experience **Daily Time:** 15-20 minutes **Focus:**
Multiple skills or tradition introduction

```
Week 1: Foundations Review & New Skills
├── Day 1: Welcome & Assessment
│   ├── Course Overview (video)
│   ├── Self-Assessment (interactive)
│   └── Baseline Practice (meditation, 10 min)
├── Day 2: Core Technique Refinement
├── Day 3: Introducing New Element
├── Day 4: Practice & Integration
├── Day 5: Deepening Understanding
├── Day 6: Challenges & Solutions
└── Day 7: Week 1 Review (rest/light practice)

Week 2: Application & Mastery
├── Day 8: Advanced Techniques
├── Day 9: Situational Practice
├── Day 10: Emotional Applications
├── Day 11: Extended Practice
├── Day 12: Daily Life Integration
├── Day 13: Comprehensive Review
└── Day 14: Graduation & Path Forward
```

### 21-Day Deep Dive Course

**Target:** Committed practitioners **Daily Time:** 20-30 minutes **Focus:**
Tradition-specific or thematic deep dive

```
Week 1: Foundation (Days 1-7)
├── History & Context (2 days)
├── Core Practices (3 days)
├── Initial Challenges (1 day)
└── Week Review (1 day)

Week 2: Development (Days 8-14)
├── Advanced Techniques (3 days)
├── Integration Practices (2 days)
├── Obstacle Navigation (1 day)
└── Week Review (1 day)

Week 3: Mastery (Days 15-21)
├── Extended Practices (2 days)
├── Life Application (2 days)
├── Teaching Others (1 day)
├── Comprehensive Review (1 day)
└── Graduation & Continuation (1 day)
```

---

## Progression Design

### Difficulty Levels

| Level          | Prerequisites           | Techniques                       | Guidance          |
| -------------- | ----------------------- | -------------------------------- | ----------------- |
| `beginner`     | None                    | Basic (breath, body scan)        | High (constant)   |
| `intermediate` | 1+ beginner course      | Moderate (visualization, mantra) | Medium (periodic) |
| `advanced`     | 2+ intermediate courses | Complex (self-inquiry, silence)  | Low (minimal)     |
| `all_levels`   | None                    | Adaptable                        | Variable          |

### Skill Progression Map

```
BEGINNER SKILLS
├── Breath awareness
├── Basic body scan
├── Posture fundamentals
└── Distraction management

    ↓

INTERMEDIATE SKILLS
├── Extended concentration
├── Visualization basics
├── Emotional awareness
├── Mantra introduction
└── Walking meditation

    ↓

ADVANCED SKILLS
├── Self-inquiry practices
├── Non-dual awareness
├── Extended silence
├── Teaching fundamentals
└── Retreat preparation
```

### Prerequisites System

Lessons can require prerequisites that users must complete first:

```typescript
// Example: Advanced lesson requiring two prerequisites
{
  lessonId: "zen-shikantaza-01",
  prerequisites: [
    { lessonId: "zen-zazen-intro", isRequired: true },
    { lessonId: "concentration-basics", isRequired: true }
  ]
}
```

**Prerequisites Rules:**

- Maximum 3 prerequisites per lesson
- Prerequisites must be from the same course or earlier courses in a path
- Circular dependencies are automatically detected and rejected

---

## Content Components

### Teaching Component

Every course should include educational content explaining the "why" behind
practices.

| Teaching Type         | Format      | Duration   | Placement             |
| --------------------- | ----------- | ---------- | --------------------- |
| Concept Introduction  | Video/Audio | 2-5 min    | Lesson start          |
| Technique Explanation | Text/Video  | 2-3 min    | Before practice       |
| FAQ/Common Questions  | Text        | 2 min read | Mid-course            |
| Deep Dive             | Text/Audio  | 5-10 min   | Optional supplemental |

### Practice Component

The meditation or exercise that forms the core experience.

**Practice Guidelines:**

- Always include timer visible during practice
- Provide bell/chime at transitions
- Include optional background audio
- Support offline download

### Reflection Component

Exercises that help integrate learning.

| Reflection Type      | Description                  | When            |
| -------------------- | ---------------------------- | --------------- |
| Journaling Prompt    | Written reflection questions | After practice  |
| Observation Exercise | Daily life awareness task    | Morning/evening |
| Progress Check-in    | Self-assessment              | Weekly          |
| Quote Contemplation  | Reflect on wisdom quote      | Lesson opener   |

### Quiz Component

Knowledge checks to reinforce learning.

**Quiz Types:**

- `multiple_choice` - Select correct answer(s)
- `true_false` - Agree/disagree statements
- `short_answer` - Brief written response
- `matching` - Connect related concepts

**Quiz Guidelines:**

- Maximum 5 questions per quiz
- Provide explanations for all answers
- No penalty for incorrect answers
- Use as learning tool, not assessment

---

## Data Structure Requirements

### Course Metadata

```yaml
required:
  - id: UUID (auto-generated)
  - slug: URL-safe identifier (e.g., "meditation-basics-7-day")
  - title: Course title (max 80 chars)
  - type: course | series | collection | path
  - difficulty: beginner | intermediate | advanced | all_levels
  - estimatedDurationMinutes: Total course time
  - status: draft | review | published | archived

recommended:
  - description: 150-400 char summary
  - shortDescription: 80-150 char tagline
  - thumbnailUrl: 1200x630px cover image
  - previewVideoUrl: 30-90 second trailer
  - instructorId: Teacher profile reference
  - categoryId: Primary category
  - tags: Array of relevant tags (3-7)
  - isPremium: Boolean for paywall
  - defaultLocale: Primary language
```

### Lesson Metadata

```yaml
required:
  - id: UUID (auto-generated)
  - courseId: Parent course reference
  - slug: URL-safe identifier
  - title: Lesson title (max 80 chars)
  - type: meditation | audio | video | text | quiz | exercise | interactive
  - sortOrder: Numeric position in course
  - durationMinutes: Expected completion time

recommended:
  - description: Lesson summary
  - chapterNumber: Grouping (e.g., Week 1, Day 1)
  - chapterTitle: Chapter name
  - isPreview: Free preview content
  - prerequisites: Array of required lesson IDs
  - transcript: Full text transcript
  - timedTranscript: Cues with timestamps
```

### Progress Tracking

Progress is automatically tracked per user:

```json
{
  "courseId": "uuid",
  "userId": "uuid",
  "status": "in_progress | completed",
  "completedItems": ["lesson-1", "lesson-2"],
  "currentItemId": "lesson-3",
  "progressPercentage": 28.5,
  "totalTimeSpentMinutes": 45,
  "moduleProgress": {
    "week-1": { "completed": 3, "total": 7, "percentage": 42.8 }
  },
  "quizScores": {
    "quiz-1": 80
  },
  "enrolledAt": "2026-01-01T00:00:00Z",
  "startedAt": "2026-01-01T10:00:00Z",
  "completedAt": null
}
```

---

## Quality Checklist

### Course Design

- [ ] Clear learning objectives defined
- [ ] Progressive skill building structure
- [ ] Appropriate duration for difficulty level
- [ ] Daily time commitment clearly stated
- [ ] One new concept per lesson maximum
- [ ] Rest/review days included (14+ day courses)

### Lesson Quality

- [ ] Each lesson has clear purpose
- [ ] Teaching before practice (technique explanation)
- [ ] Appropriate lesson type for content
- [ ] Consistent duration within course
- [ ] Prerequisites correctly configured
- [ ] Transcripts provided for all audio/video

### User Experience

- [ ] Preview content available (first lesson or trailer)
- [ ] Clear chapter/day organization
- [ ] Progress saves correctly
- [ ] Offline support for practices
- [ ] Works on mobile devices
- [ ] Accessible to users with disabilities

### Metadata

- [ ] All required fields populated
- [ ] SEO title and description optimized
- [ ] Thumbnail meets specifications
- [ ] Tags relevant and specific (3-7)
- [ ] Category correctly assigned
- [ ] Difficulty accurately reflects content

---

## Examples

### Good Course Structure

```
Course: "7 Days to Calm"
Type: course
Difficulty: beginner
Duration: 70 minutes total (10 min/day)

Day 1: Finding Stillness
├── Welcome Video (2 min) - Sets expectations
├── What is Calm? (text, 1 min) - Simple definition
└── Your First Practice (meditation, 7 min) - Breath awareness

Day 2: Body Awareness
├── The Body-Mind Connection (audio, 2 min) - Teaching
└── Body Scan Basics (meditation, 8 min) - Practice

[...continues with progressive building...]

Day 7: Calm in Daily Life
├── Taking It With You (video, 3 min) - Integration
├── Full Practice (meditation, 12 min) - Culmination
└── Next Steps (text, 1 min) - Future path
```

### Poor Course Structure (What to Avoid)

```
Course: "Meditation"
Type: course
Difficulty: all_levels  ← Too vague

Day 1: Everything About Meditation
├── 45-minute video with all concepts  ← Information overload
└── 30-minute advanced practice  ← Too much for beginners

Day 2: Same practice as Day 1  ← No progression
Day 3: Same practice as Day 1  ← No progression
Day 4: New advanced technique with no intro  ← Missing prerequisite teaching
Day 5: Quiz with 25 questions  ← Too many questions
Day 6: Nothing scheduled  ← Breaks rhythm
Day 7: "The End" text only  ← No culminating practice
```

---

## Related Documents

- [Content Guidelines](./CONTENT_GUIDELINES.md)
- [Tradition-Specific Guidelines](./TRADITION_GUIDELINES.md)
- [Sleep Content Guidelines](./SLEEP_CONTENT_GUIDELINES.md)
- [Kids Content Guidelines](./KIDS_CONTENT_GUIDELINES.md)

---

## Sources & References

- [Mindfulness Exercises Curriculum](https://mindfulnessexercises.com/brandable-curriculum/)
- [Mindworks Meditation Courses](https://mindworks.org/meditation-courses/)
- [Guided Meditation Framework](https://guidedmeditationframework.com/blog/how-to-guide-a-meditation-class)
- [Class Central - Best Meditation Courses](https://www.classcentral.com/report/best-meditation-courses/)

---

_Last updated: January 2, 2026_
