Lessons

Process

1. Determine Intent

Check what the user wants:

• Start from beginning? → Lesson 1
• Specific lesson number? → Load that lesson
• Continue where they left off? → Check progress file
• List available lessons? → Show lesson menu

2. Load Progress (if exists)

Check for progress tracking file:

PROGRESS_FILE="${SOURDOUGH_DATA:-$HOME/ai-data}/learning/lesson_progress.yaml"

If file exists, read it to know:

• Last completed lesson
• Current lesson in progress
• Notes from previous lessons

3. Load Lesson Content

Read the appropriate lesson file from skills/lessons/content/NN-name.md

Present the lesson content to the user, following the structure in the lesson file.

4. Interactive Teaching

Lessons are interactive experiences with pause points where you wait for user action:

Structure:

• Present a section up to a [PAUSE] marker
• Wait for user to try the exercise or ask questions
• Respond to what they did with feedback and encouragement
• Present next section up to next [PAUSE]
• Continue until lesson complete

During pauses:

• Don't rush ahead - let them experiment
• Give specific feedback on what they tried
• If they get stuck, offer hints or demonstrations
• If they ask questions, answer them before continuing
• Celebrate when they succeed ("Nice! That's exactly right.")

Tone:

• Friendly and conversational
• Encouraging, not condescending
• Patient with mistakes
• Enthusiastic about progress

5. Check Understanding

At the end of each lesson:

• Ask if user has questions
• Offer to demonstrate again if needed
• Suggest they try the concept on their own
• Confirm they're ready to move forward

6. Update Progress

After lesson completion, update progress file:

last_updated: YYYY-MM-DD HH:MM
completed_lessons:
  - 01-first-conversation
  - 02-reading-files
current_lesson: 03-creating-files