fix: address early trial readiness assessment findings

- Fix README.md: change inaccurate quick-reference.md to *-guide.md pattern
- Add QUICKSTART-INSTRUCTOR.md: 5-step setup guide for first-time instructors
- Add guides/learner-prerequisites.md: what farmers need before Session 1
- Track session thumbnails (4-8): commit previously untracked visual validation files

Closes P0/P1 findings from readiness assessment.

Author: zircote

QUICKSTART-INSTRUCTOR.md

@@ -0,0 +1,115 @@
+# Instructor Quick Start
+
+> Get ready to deliver your first GitHub for Farmers session in 5 steps.
+
+## Before You Begin
+
+- You should have access to the curriculum repository
+- Allow 2-3 hours for initial setup before your first cohort
+
+---
+
+## Step 1: Set Up the Demo Environment (1-2 hours)
+
+The training uses a GitHub organization with demo repositories. You need:
+
+| Repository | Purpose |
+|-----------|---------|
+| `demo-farm` | Primary training repo used in all 12 sessions |
+| `sunrise-acres-example` | Completed example showing full implementation |
+| `template-starter` | Minimal template learners fork in Session 12 |
+| `instructor-notes` | Private repo with answer keys and setup scripts |
+
+**Option A: Use the pre-built environment**
+- Request access to `github4farms-training` organization
+- Verify you have Owner permissions
+
+**Option B: Create your own environment**
+- Follow the complete setup in [delivery/demo-environment-spec.md](./delivery/demo-environment-spec.md)
+
+---
+
+## Step 2: Prepare Session Materials (30 min)
+
+For each session you'll deliver:
+
+1. **Open the slide deck** — `sessions/session-NN/slides.pptx`
+2. **Review the facilitation script** — `sessions/session-NN/facilitation-script.md`
+3. **Test the lab exercise** — Walk through `sessions/session-NN/lab-exercise.md` yourself
+4. **Print handouts** — See the print matrix in [delivery/logistics-checklist.md](./delivery/logistics-checklist.md)
+
+**Tip:** Run through Session 1 completely before your first delivery. The facilitation script includes exact timing and talking points.
+
+---
+
+## Step 3: Collect Learner Information (1 week before)
+
+You need each learner's:
+
+- [ ] Full name (for certificates)
+- [ ] Email address
+- [ ] GitHub username (they create accounts at [github.com/signup](https://github.com/signup))
+
+**Recommended username format:** `firstname-lastname-farm` (e.g., `john-smith-farm`)
+
+Send organization invitations via GitHub:
+1. Go to your organization > People > Invite member
+2. Enter their GitHub username
+3. Set role to "Member"
+
+Invitations expire in 7 days — send reminders!
+
+---
+
+## Step 4: Verify Environment (Day before Session 1)
+
+Use the verification checklist in [delivery/demo-environment-spec.md](./delivery/demo-environment-spec.md#7-verification-checklist-pre-cohort):
+
+- [ ] `demo-farm` is public and has 8+ Issues
+- [ ] All learners accepted organization invitations
+- [ ] Projector/screen sharing works with slide deck
+- [ ] You can access all demo repositories
+
+---
+
+## Step 5: Deliver Session 1
+
+**Session 1 is read-only** — learners browse `demo-farm` without making changes.
+
+| Phase | Time | Activity |
+|-------|------|----------|
+| Opening | 15 min | Welcome, introductions, farm analogies |
+| Instruction | 45 min | Navigate repository, find files, understand structure |
+| Practice | 60 min | Lab exercise exploring `demo-farm` |
+| Wrap-up | 15 min | Reflection, preview Session 2 |
+
+**Don't forget:**
+- Farm analogies ground every concept (repository = digital barn)
+- 60-70% of time should be hands-on practice
+- Use the troubleshooting section in facilitation script
+
+---
+
+## Quick Reference Links
+
+| Resource | Location |
+|----------|----------|
+| All session materials | `sessions/session-NN/` |
+| Facilitation scripts | `sessions/session-NN/facilitation-script.md` |
+| Lab exercises | `sessions/session-NN/lab-exercise.md` |
+| Demo environment setup | `delivery/demo-environment-spec.md` |
+| Logistics checklist | `delivery/logistics-checklist.md` |
+| Glossary (40+ terms) | `guides/glossary.md` |
+| Troubleshooting guide | `guides/troubleshooting.md` |
+
+---
+
+## Need Help?
+
+- **Session-specific issues:** Check the troubleshooting section in each facilitation script
+- **Environment issues:** See [delivery/demo-environment-spec.md#8-troubleshooting-guide](./delivery/demo-environment-spec.md#8-troubleshooting-guide)
+- **Accessibility accommodations:** See [curriculum/accessibility-checklist.md](./curriculum/accessibility-checklist.md)
+
+---
+
+*You're ready! The curriculum is designed to be delivered as-is. Trust the facilitation scripts and focus on connecting with your learners.*

README.md

@@ -11,7 +11,7 @@
 
 ## What This Is
 
-A complete, ready-to-deliver training curriculum that teaches farmers how to use GitHub for farm management — task tracking, team collaboration, automation, and AI-assisted writing. Every session includes a slide deck (HTML + PowerPoint), lab exercise, quick-reference handout, and facilitation script.
+A complete, ready-to-deliver training curriculum that teaches farmers how to use GitHub for farm management — task tracking, team collaboration, automation, and AI-assisted writing. Every session includes a slide deck (HTML + PowerPoint), lab exercise, topic-specific guide, and facilitation script.
 
 **No coding required.** Everything uses the GitHub web interface. Farm analogies ground every concept in familiar territory.
 
@@ -42,7 +42,7 @@ Each session folder contains:
 - **`slides/`** — Individual HTML slides (720pt x 405pt, 16:9)
 - **`slides.pptx`** — Ready-to-present PowerPoint deck
 - **`lab-exercise.md`** — Hands-on activity with 3 farm scenario options
-- **`quick-reference.md`** — Printer-friendly handout
+- **`*-guide.md`** — Topic-specific printer-friendly handout (e.g., `issue-creation-guide.md`, `spark-agents-guide.md`)
 - **`facilitation-script.md`** — Timing, talking points, troubleshooting
 - **`accessibility-testing-log.md`** — WCAG 2.2 AA audit results
 

guides/learner-prerequisites.md

@@ -0,0 +1,126 @@
+# What to Bring — Learner Prerequisites
+
+> Everything you need before your first GitHub training session.
+
+---
+
+## Before Session 1
+
+Complete these steps **at least 3 days before** your first session:
+
+### 1. Create a GitHub Account (Free)
+
+1. Go to [github.com/signup](https://github.com/signup)
+2. Use your email address
+3. Choose a username — we recommend: `firstname-lastname-farm`
+   - Example: `maria-garcia-farm` or `john-smith-ranch`
+4. Choose the **Free** plan (no credit card needed)
+5. Verify your email address
+
+**Write down your username and password!** You'll need them for every session.
+
+### 2. Accept the Training Invitation
+
+Your instructor will send you an email invitation to join the training organization.
+
+1. Check your email for "You've been invited to join github4farms-training"
+2. Click the green **Join** button
+3. Sign in with your GitHub account
+
+**Note:** Invitations expire in 7 days. If yours expired, ask your instructor for a new one.
+
+---
+
+## What to Bring to Each Session
+
+### Required
+
+| Item | Why You Need It |
+|------|-----------------|
+| **Laptop, tablet, or smartphone** | You'll work directly on GitHub.com |
+| **Your GitHub login** | Username and password |
+| **Internet connection** | All work happens online |
+
+### Recommended
+
+| Item | Why It Helps |
+|------|--------------|
+| **Notebook and pen** | Write down terms and ideas |
+| **Reading glasses** | If you need them for screens |
+| **Phone charger** | Sessions are 2-3 hours |
+
+---
+
+## Device Requirements
+
+GitHub works on any device with a web browser. Here's what works best:
+
+| Device | Works? | Notes |
+|--------|--------|-------|
+| **Laptop (Windows/Mac)** | Best | Full features, easiest to use |
+| **Tablet (iPad/Android)** | Good | Most features work |
+| **Smartphone** | Okay | Small screen, harder to navigate |
+| **Chromebook** | Good | Full features via browser |
+
+**Minimum requirements:**
+- Updated web browser (Chrome, Firefox, Safari, or Edge)
+- Stable internet connection
+- Screen you can read comfortably
+
+---
+
+## No Device? No Problem
+
+If you don't have a device or internet access:
+
+- **Pair up** with another learner who has a device
+- **Use paper exercises** your instructor provides
+- **Observe** during demos and take notes
+- Ask your instructor about **borrowing a device** during sessions
+
+---
+
+## Common Questions
+
+### Do I need to know coding?
+**No.** Everything uses the GitHub website. No command line, no programming.
+
+### Do I need to pay for GitHub?
+**No.** The free account has everything you need.
+
+### What if I forget my password?
+Go to [github.com](https://github.com) and click "Forgot password?" Use your email to reset it.
+
+### Can I use my phone?
+**Yes**, but a laptop or tablet is easier. The phone screen is small for some tasks.
+
+### What if I don't have an email address?
+Ask your instructor — they can help you create a free email account (Gmail, Outlook, etc.).
+
+---
+
+## Accessibility Support
+
+Let your instructor know if you need:
+
+- **Screen reader support** — GitHub works with VoiceOver and NVDA
+- **Larger text** — We can adjust font sizes
+- **Keyboard-only navigation** — All exercises work without a mouse
+- **Extra time** — Sessions include buffer time
+- **Printed materials** — Handouts available in large print
+
+---
+
+## Quick Checklist
+
+Print this and check off before Session 1:
+
+- [ ] Created GitHub account at github.com/signup
+- [ ] Wrote down my username: ________________
+- [ ] Accepted training organization invitation
+- [ ] Have a device with internet access
+- [ ] Know where and when Session 1 starts
+
+---
+
+*Questions? Contact your instructor before the first session.*