diff --git a/src/content/docs/beginners/how-to/ask-when-uncertain.mdx b/src/content/docs/beginners/how-to/ask-when-uncertain.mdx
index c79ff74..21a820f 100644
--- a/src/content/docs/beginners/how-to/ask-when-uncertain.mdx
+++ b/src/content/docs/beginners/how-to/ask-when-uncertain.mdx
@@ -3,26 +3,64 @@ title: "How to Ask When You Don't Know What You Want"
description: "When you know you need help but can't figure out how to ask for it"
---
+import { Card, CardGrid, LinkCard, Aside, Badge, Steps, Tabs, TabItem, Code } from '@astrojs/starlight/components';
+
*When you know you need help but can't figure out how to ask for it*
## The Problem
You're sitting there with that familiar feeling: something's bugging you, you know Claude could probably help, but you have no idea how to even start the conversation. Maybe it's work stress, a decision you need to make, a project that feels overwhelming, or just that nagging sense that you're missing something obvious.
-You've tried the obvious approaches:
-- "Can you help me with [vague thing]?" (gets generic advice)
-- "I need to figure out [unclear situation]" (Claude asks for more details you don't have)
-- Just staring at the chat wondering what to type (gets you nowhere)
+
-Sound familiar? This is one of the most common frustrations people have with AI - that gap between "I need help" and "I know what kind of help I need."
+**You've tried the obvious approaches:**
+
+
+
+
+Result: Gets generic advice that doesn't fit your situation
+
+
+
+
+Result: Claude asks for more details you don't have
+
+
+
+
+Result: Gets you absolutely nowhere
+
+
## The Solution: Start With Your Feelings, Not Your Goals
-Here's the counterintuitive approach that works: instead of trying to figure out what you want before you ask, start by describing what you're experiencing right now.
+
-### Pattern 1: "I'm feeling [emotion] about [situation] and I can't figure out why"
+
+
+**"I'm feeling [emotion] about [situation] and I can't figure out why"**
-**Instead of:** "Help me with my career"
+
+
+
+
+**"I'm stuck on [situation] and usually I [your normal approach] but that's not working"**
+
+
+
+
**Try:** "I'm feeling restless about my job lately and I can't put my finger on what's bothering me about it"
**Instead of:** "I need to make a decision"
@@ -52,68 +90,105 @@ Here's the counterintuitive approach that works: instead of trying to figure out
## Advanced Patterns for Complex Situations
-### Pattern 4: "Something's not working and I don't know what's wrong"
+
+
+**"Something's not working and I don't know what's wrong"**
-**Try:** "I've been trying to [what you're doing] but it's not working the way I expected, and I can't figure out where the disconnect is"
+
+
-**Example:** "I've been trying to be more productive with my time but somehow I feel busier and more stressed than before, and I can't figure out where the disconnect is"
+
+**"I need to learn something but don't know where to start"**
-### Pattern 5: "I need to learn something but don't know where to start"
+
+
-**Try:** "I need to understand [topic] but every time I try to research it, I get overwhelmed by how much there is to know"
+
+**"I'm stuck in a pattern and can't see my way out"**
-**Example:** "I need to understand personal finance better but every time I try to research it, I get overwhelmed by how much there is to know and conflicting advice"
-
-### Pattern 6: "I'm stuck in a pattern and can't see my way out"
-
-**Try:** "I keep finding myself in [situation] and I always handle it the same way, but I feel like there must be better approaches I'm not seeing"
-
-**Example:** "I keep finding myself in conversations where I agree to things I don't want to do, and I always handle it the same way, but I feel like there must be better approaches I'm not seeing"
+
+
+
## What to Do After You Ask
Once you've started with one of these patterns, Claude will likely ask follow-up questions or offer observations. Here's how to keep the conversation productive:
-### 1. Go with the first thing that resonates
-When Claude reflects something back or asks a question, pay attention to which part makes you think "yeah, that's it" or "huh, I hadn't thought about it that way."
+
+1. **Go with the first thing that resonates** - When Claude reflects something back or asks a question, pay attention to which part makes you think "yeah, that's it" or "huh, I hadn't thought about it that way."
-### 2. Share what feels relevant, even if it seems random
-If Claude's response reminds you of something else in your life, or makes you think of a related situation, mention it. These connections often lead to insights.
+2. **Share what feels relevant, even if it seems random** - If Claude's response reminds you of something else in your life, or makes you think of a related situation, mention it. These connections often lead to insights.
-### 3. Don't worry about staying on topic
-Sometimes the most helpful conversations wander into unexpected territory. If Claude's response sparks a thought about something seemingly unrelated, follow that thread.
+3. **Don't worry about staying on topic** - Sometimes the most helpful conversations wander into unexpected territory. If Claude's response sparks a thought about something seemingly unrelated, follow that thread.
-### 4. Ask for what you need as it becomes clear
-As the conversation progresses and you start to understand what you're actually dealing with, you can get more specific: "This is really helpful - can we focus on [specific aspect]?" or "I think I need to [specific action] - can you help me think through how to approach that?"
+4. **Ask for what you need as it becomes clear** - As the conversation progresses and you start to understand what you're actually dealing with, you can get more specific: "This is really helpful - can we focus on [specific aspect]?" or "I think I need to [specific action] - can you help me think through how to approach that?"
+
+
+
## When This Approach Works Best
+
-Copy and adapt these for your specific situation:
+## Quick Reference: Conversation Starters
+
+
+
---
## What's Next?
-**If this helped:** [How to Get Claude to Match Your Tone and Style](/how-to/match-tone-style/) - Now that you can start conversations, make them sound like you.
+
**For hands-on practice:** [Tutorial 1: From Awkward Small Talk to AI Collaboration](/tutorials/first-conversation/) - Experience these uncertain conversation starters in action.
diff --git a/src/content/docs/beginners/start/introduction.mdx b/src/content/docs/beginners/start/introduction.mdx
index 5f96ebe..187d6bd 100644
--- a/src/content/docs/beginners/start/introduction.mdx
+++ b/src/content/docs/beginners/start/introduction.mdx
@@ -3,58 +3,122 @@ title: "Welcome to How to Talk to Claude"
description: "Your complete journey from awkward AI encounters to genuine collaboration"
---
+import { Card, CardGrid, LinkCard, Aside, Badge, Steps, Tabs, TabItem, Code } from '@astrojs/starlight/components';
+
## The Moment Everything Changed
Remember the first time you sent a text message? Or joined your first online chat room? There was that moment when you suddenly realized - oh wait, this isn't just a fancy typewriter or a phone with extra steps. This is a completely new way to communicate, with its own rhythm, its own possibilities, its own social rules.
+
+
I had that exact same moment with AI, but it took me way longer than it should have.
For months, I was treating Claude like a very expensive search engine that occasionally wrote things for me. I'd type in requests like I was filing work orders: "Write a blog post about productivity." "Summarize this article." "Give me five ideas for dinner."
And Claude would dutifully respond with perfectly fine, completely generic results that felt like they could have been written by any marketing intern with a caffeine problem.
-Then one day, frustrated with yet another bland response, I tried something different. Instead of giving Claude a task, I started a conversation: "I'm struggling with this productivity article because honestly, I'm tired of all the 'wake up at 5 AM' advice. What angle am I missing here?"
+
+
+Then one day, frustrated with yet another bland response, I tried something different. Instead of giving Claude a task, I started a conversation:
+
+
+
+
+Result: Generic, could-be-written-by-anyone content
+
+
+
+
+Result: Thoughtful, personal, genuinely helpful response
+
+
What came back wasn't just better - it was *different*. Thoughtful. Personal. Like Claude had actually been thinking about the same thing and had some ideas to share.
-That's when I realized: I'd been doing the equivalent of walking into a coffee shop, slapping money on the counter, and grunting "COFFEE" instead of actually talking to the barista.
+
## What You're Really Learning Here
This guide isn't about "prompting AI correctly." It's about discovering that AI collaboration works best when you approach it like... well, collaboration.
-You know how you've learned to communicate with different technologies over the years? How you figured out that email has a different tone than texting, which is different from Slack, which is different from leaving a voicemail? You developed instincts for each medium - when to be formal, when to be casual, how much context to include, what works and what doesn't.
+
-This guide is going to give you those same instincts for AI. By the time you're done, you'll have that natural sense of how to start conversations, how to steer them when they go off track, how to get the kind of responses that actually help instead of just technically answering your question.
+By the time you're done, you'll have that natural sense of how to start conversations, how to steer them when they go off track, how to get the kind of responses that actually help instead of just technically answering your question.
-### 💡 What you'll discover
-- Why treating AI like a conversation partner gets infinitely better results than treating it like a command line
-- How to start conversations when you don't even know what you want (this is way more common than you think)
-- The psychology of why AI collaboration feels weird at first and how to get past that
-- Practical techniques for everything from brainstorming to research to personal decisions
-- Advanced methods that separate casual users from people who really know what they're doing
+
+
+- Why conversation beats commands for infinitely better results
+- How to start conversations when you don't know what you want
+- The psychology behind initial AI collaboration weirdness
+- Practical techniques from brainstorming to personal decisions
+- Advanced methods that separate experts from casual users
+
-### 📝 What you won't find here
+
- Generic "prompt templates" that work for everyone and no one
-- Technical explanations of how AI actually works under the hood
-- Advice that assumes you're a developer or tech expert
-- The usual "10 ChatGPT hacks that will change your life" clickbait
+- Technical explanations of AI's inner workings
+- Advice that assumes you're a developer or tech expert
+- The usual "10 ChatGPT hacks" clickbait nonsense
+
+
## How This Guide Actually Works
You've probably noticed that most tutorials either assume you're a complete beginner or throw you straight into advanced techniques. This guide is different - it's built around how people actually learn and what they actually need.
-We're using something called the **Diátaxis framework**, which sounds fancy but just means "different types of content for different types of learning." Here's what that looks like in practice:
+
-### When You Want to Learn by Doing: Tutorials
-These are step-by-step experiences where you'll actually have conversations with Claude and build skills naturally. Think of them like cooking lessons where you make actual food, not just read recipes.
+
+
+**When You Want to Learn by Doing**
-**Start here if:** You're new to AI, you learn better by doing than reading, or you want to build confidence through experience.
+Step-by-step experiences where you'll actually have conversations with Claude and build skills naturally. Like cooking lessons where you make actual food, not just read recipes.
+
+**Start here if:** You're new to AI, learn better by doing, or want to build confidence through experience.
+
+
+
+**When You Have a Specific Problem**
-### When You Have a Specific Problem: How-To Guides
These solve exact problems you're facing right now. Bookmark these and come back when you need them.
-**Use these when:** Claude is giving you walls of text but you want simple answers, you can't get Claude to match your tone, you need to fact-check something, you want to brainstorm but feel silly, etc.
+**Use these when:** Claude gives walls of text but you want simple answers, can't get tone matching, need fact-checking, want to brainstorm but feel silly, etc.
+
+
+
+**When You Want to Understand Why**
+
+Deep dives into the psychology and principles behind effective AI collaboration.
+
+**Perfect for:** Understanding what's happening beneath the surface, building intuition, becoming genuinely sophisticated at this.
+
+
+
+**When You Need Something Fast**
+
+Conversation starters, troubleshooting, emergency fixes. Your bookmark-worthy resource.
+
+**Use for:** "How do I start this conversation?" or "This isn't working, help!" moments.
+
+
### When You Want to Understand Why: Explanations
These dive into the psychology and principles behind why certain approaches work. Perfect for when you want deeper understanding, not just practical tips.