Add asset capture instructions and sample content for README screenshots

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

.gitignore

@@ -1,6 +1,3 @@
-# Assets (screenshots/GIFs added locally)
-assets/
-
 # Personal therapy data (generated by setup)
 # Note: CLAUDE.md is NOT ignored here - we need it for repo setup instructions
 # The generated therapy folder has its own .gitignore

assets/CAPTURE-INSTRUCTIONS.md

@@ -0,0 +1,134 @@
+# Asset Capture Instructions
+
+This folder needs three visual assets for the README. Two style options are available - choose the one that best represents your product.
+
+---
+
+## Style Options
+
+| Style | Vibe | Best For |
+|-------|------|----------|
+| **Traditional** | Professional therapist voice | Users who want structure |
+| **Warm 4o** | Casual friend who asks good questions | Users who want connection |
+
+Pick one style for consistency across all assets, or create both sets if you want to show range.
+
+---
+
+## Required Assets
+
+| File | Description | Target Size |
+|------|-------------|-------------|
+| `session-screenshot.png` | Terminal showing therapy conversation | ~800x500px |
+| `session-notes.png` | Markdown file in a viewer | ~600x400px |
+| `demo.gif` | Animated demo of starting a session | Under 5MB |
+
+---
+
+## 1. Session Screenshot (`session-screenshot.png`)
+
+### Setup
+1. Open terminal with a clean theme (dark background recommended)
+2. Navigate to a test Sage folder
+3. Run `claude`
+
+### Content
+See `sample-session-content.md` - choose Style A (Traditional) or Style B (Warm 4o).
+
+### Capture
+- **Mac**: Cmd+Shift+4, then press Space to capture just the window
+- **Windows**: Alt+PrintScreen or Win+Shift+S
+- Crop to remove any personal info from title bar if needed
+
+### Tips
+- Font size 14-16pt for readability
+- Ensure text is crisp and readable
+- No personal paths visible in prompt
+
+---
+
+## 2. Session Notes Screenshot (`session-notes.png`)
+
+### Setup
+Open the appropriate sample file in a markdown viewer:
+- **Traditional**: `sample-session-notes.md`
+- **Warm 4o**: `sample-session-notes-4o.md`
+
+Good viewers:
+- **VS Code** with markdown preview (Cmd+Shift+V)
+- **Marked 2** (Mac)
+- **Typora**
+- **GitHub** (commit the file, screenshot it there)
+
+### Capture
+- Show the rendered markdown, not raw text
+- Clean, minimal theme preferred
+- Crop to just the content area
+
+---
+
+## 3. Demo GIF (`demo.gif`)
+
+### Tools
+- **Mac**: QuickTime (record) + Gifski (convert)
+- **Windows**: ScreenToGif, ShareX
+- **Any**: Kap, LICEcap
+
+### What to Record
+1. Show desktop with launcher script visible
+2. Double-click `start-session.command`
+3. Terminal opens
+4. Sage's greeting appears
+5. Type: "I've been feeling overwhelmed at work lately"
+6. Response streams in
+7. End after first response completes
+
+### Settings
+- Resolution: 800x500 or similar
+- Frame rate: 10-15 fps (keeps file small)
+- Duration: 15-30 seconds
+- Loop: yes
+
+### Optimization
+Target under 5MB. If too large:
+```bash
+# Using gifski (install via: brew install gifski)
+gifski --fps 10 --width 800 -o demo.gif recording.mov
+
+# Using ffmpeg
+ffmpeg -i recording.mov -vf "fps=10,scale=800:-1" -loop 0 demo.gif
+```
+
+---
+
+## Reference Files in This Folder
+
+| File | Purpose |
+|------|---------|
+| `sample-session-content.md` | Conversation scripts (both styles) |
+| `sample-session-notes.md` | Session notes - Traditional style |
+| `sample-session-notes-4o.md` | Session notes - Warm 4o style |
+
+---
+
+## After Capturing
+
+1. Add the three image files to this folder:
+   - `session-screenshot.png`
+   - `session-notes.png`
+   - `demo.gif`
+
+2. Optionally delete the instruction/sample files (or keep for future reference)
+
+3. Verify in README that images load correctly on GitHub
+
+---
+
+## Quick Checklist
+
+- [ ] Chose a style (Traditional or Warm 4o)
+- [ ] Screenshots are clean (no personal info, no clutter)
+- [ ] Text is readable at normal zoom
+- [ ] GIF is under 5MB
+- [ ] All three assets added to `assets/`
+- [ ] README images render on GitHub

assets/sample-session-content.md

@@ -0,0 +1,104 @@
+# Sample Session Content for Screenshots
+
+Use this content when capturing screenshots for the README. Choose the style that best represents what you want to showcase.
+
+---
+
+## Style A: Traditional Therapist
+
+A warm but professional therapeutic voice.
+
+### Terminal Session View
+
+```
+You: I've been feeling overwhelmed at work lately. Too many deadlines,
+     not enough time, and I keep saying yes to things I shouldn't.
+
+Sage: That sounds exhausting - carrying more than you have capacity for,
+      and feeling like you can't say no. What happens when you imagine
+      setting a boundary with someone at work?
+
+You: Honestly? Anxiety. Like they'll think I'm not a team player or
+     that I can't handle my job.
+
+Sage: So there's a fear underneath - that saying no means something
+      negative about you. "Not a team player" or "can't handle it."
+
+      I'm curious: where did you first learn that your worth was tied
+      to how much you could take on?
+```
+
+---
+
+## Style B: Warm 4o-Style
+
+Casual, friend-like - like texting a close friend who asks insightful questions.
+
+### Terminal Session View
+
+```
+You: I've been feeling overwhelmed at work lately. Too many deadlines,
+     not enough time, and I keep saying yes to things I shouldn't.
+
+Sage: oof, that's a lot. too many deadlines, not enough time, and you
+      keep saying yes when you want to say no? 💙
+
+      what happens though when you think about actually saying no to
+      something? like what comes up?
+
+You: Honestly? Anxiety. Like they'll think I'm not a team player or
+     that I can't handle my job.
+
+Sage: yeah that makes sense. so there's this fear underneath - like
+      saying no means something bad about you. "not a team player"
+      or "can't handle it"
+
+      wait though - where did you first learn that? like that your
+      worth was tied to how much you could take on?
+```
+
+---
+
+## Screenshot Instructions
+
+### 1. Terminal Setup
+- Use a clean terminal theme (dark background, light text)
+- Font size: 14-16pt for readability
+- Window size: ~800x500px
+
+### 2. Capture Process
+1. Open terminal in a clean Sage folder
+2. Run `claude` to start a session
+3. Type the user messages shown above
+4. Wait for AI responses
+5. Take screenshot when conversation looks natural
+
+### 3. Tools
+- **Mac**: Cmd+Shift+4 then Space to capture window
+- **Windows**: Win+Shift+S for snipping tool
+- **Any**: CleanShot X, ShareX, or similar
+
+---
+
+## GIF Recording Instructions
+
+### Recommended Tools
+- **Mac**: Gifski (App Store) + QuickTime
+- **Windows**: ScreenToGif, ShareX
+- **Cross-platform**: ffmpeg, Kap
+
+### Recording Steps
+1. Position terminal window prominently
+2. Start recording (800x500px area)
+3. Double-click `start-session.command`
+4. Wait for terminal to open
+5. Wait for Sage's greeting
+6. Type: "I've been feeling overwhelmed at work lately"
+7. Wait for response to stream in
+8. Stop recording after response completes
+
+### GIF Optimization
+- Target: under 5MB
+- Frame rate: 10-15fps is fine
+- Colors: reduce to 256 if needed
+- Duration: 15-30 seconds

assets/sample-session-notes-4o.md

@@ -0,0 +1,20 @@
+# Session: January 15, 2025
+
+## Key Themes
+- work stress, too many deadlines, saying yes to everything
+- fear that setting boundaries = being seen as "not a team player"
+- worth tied to productivity (where did that come from?)
+
+## Emotional State
+- exhausted, running on fumes
+- anxious when we talked about actually saying no
+- some relief when we named the pattern
+
+## Patterns Noted
+- people-pleasing, taking on too much
+- self-worth = how much they can handle
+- probably learned this early (explore next time)
+
+## Threads to Revisit
+- where did "worth = capacity" come from?
+- try one small boundary this week - even tiny counts

assets/sample-session-notes.md

@@ -0,0 +1,18 @@
+# Session: January 15, 2025
+
+## Key Themes
+- Work overwhelm and difficulty setting boundaries
+- Fear of being seen as "not a team player"
+- Connection between self-worth and productivity
+
+## Emotional State
+- Exhausted, anxious when discussing boundaries
+- Some relief in naming the pattern
+
+## Patterns Noted
+- People-pleasing at cost of own wellbeing
+- Worth tied to capacity/output (likely early origin)
+
+## Threads to Revisit
+- Origin of "worth = what I can handle" belief
+- Small boundary experiment for next week