From 481813c7aff58088a6a4c046678d55b21ece9829 Mon Sep 17 00:00:00 2001 From: Anthony Taglianetti <30904141+ataglianetti@users.noreply.github.com> Date: Wed, 4 Feb 2026 13:55:10 -0800 Subject: [PATCH] Add asset capture instructions and sample content for README screenshots Co-Authored-By: Claude Opus 4.5 --- .gitignore | 3 - assets/CAPTURE-INSTRUCTIONS.md | 134 ++++++++++++++++++++++++++++++ assets/sample-session-content.md | 104 +++++++++++++++++++++++ assets/sample-session-notes-4o.md | 20 +++++ assets/sample-session-notes.md | 18 ++++ 5 files changed, 276 insertions(+), 3 deletions(-) create mode 100644 assets/CAPTURE-INSTRUCTIONS.md create mode 100644 assets/sample-session-content.md create mode 100644 assets/sample-session-notes-4o.md create mode 100644 assets/sample-session-notes.md diff --git a/.gitignore b/.gitignore index 66be782..b4d79d0 100644 --- a/.gitignore +++ b/.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 diff --git a/assets/CAPTURE-INSTRUCTIONS.md b/assets/CAPTURE-INSTRUCTIONS.md new file mode 100644 index 0000000..6910e5f --- /dev/null +++ b/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 diff --git a/assets/sample-session-content.md b/assets/sample-session-content.md new file mode 100644 index 0000000..eaddea8 --- /dev/null +++ b/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 diff --git a/assets/sample-session-notes-4o.md b/assets/sample-session-notes-4o.md new file mode 100644 index 0000000..6cf5858 --- /dev/null +++ b/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 diff --git a/assets/sample-session-notes.md b/assets/sample-session-notes.md new file mode 100644 index 0000000..f7b9fc3 --- /dev/null +++ b/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