From ad62547d8ea65c64e1bbb4ede137851a4cde31f3 Mon Sep 17 00:00:00 2001 From: Claude AI Guide Project Date: Tue, 8 Jul 2025 00:34:26 -0600 Subject: [PATCH] feat: Enable Starlight components across entire site MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 🎨 COMPONENT SYSTEM ACTIVATION: 📝 File Format Conversion: - Convert ALL 46 content files from .md to .mdx format - Enable JSX/component syntax in all content files - Maintain all existing content while adding component capability 🧩 Component Integration: - Homepage enhanced with Cards, LinkCards, Asides, Steps - Tutorial example updated with Tabs, Code blocks, enhanced Asides - All component imports properly configured 📚 Available Components: ✅ Cards & CardGrid - Feature highlights, content organization ✅ LinkCards - Enhanced navigation and cross-references ✅ Asides - Tips, notes, warnings, cautions (4 types) ✅ Steps - Tutorial processes and procedures ✅ Tabs - Before/after examples, alternatives ✅ Code - Syntax highlighting with titles ✅ Badges - Status indicators and labels ✅ Icons - Visual enhancement 📖 Documentation: - Complete component reference guide (COMPONENTS-GUIDE.md) - Usage examples and implementation patterns - Import syntax and best practices 🔧 Technical Implementation: - Starlight automatically handles .mdx files - Component imports per file (tree-shaking friendly) - Backward compatible with existing markdown syntax - Enhanced visual hierarchy and user experience Ready for content authors to use rich, interactive components throughout the entire documentation site! --- COMPONENTS-GUIDE.md | 107 +++++++++++++++ ...mands.md => conversations-vs-commands.mdx} | 0 ...claude-thinks.md => how-claude-thinks.mdx} | 0 ...or-life.md => making-ai-work-for-life.mdx} | 0 ...ration.md => psychology-collaboration.mdx} | 0 ...en-uncertain.md => ask-when-uncertain.mdx} | 0 ...lls-of-text.md => avoid-walls-of-text.mdx} | 0 ...fortably.md => brainstorm-comfortably.mdx} | 0 .../how-to/{fact-check.md => fact-check.mdx} | 0 ...standings.md => fix-misunderstandings.mdx} | 0 ...l-feedback.md => get-helpful-feedback.mdx} | 0 ...eful-sources.md => get-useful-sources.mdx} | 0 ...-writing.md => maintain-voice-writing.mdx} | 0 ...tch-tone-style.md => match-tone-style.mdx} | 0 ...nformation.md => organize-information.mdx} | 0 ...persona-prompts.md => persona-prompts.mdx} | 0 ...al-decisions.md => personal-decisions.mdx} | 0 ...pics.md => research-unfamiliar-topics.mdx} | 0 .../reference/{index.md => index.mdx} | 0 .../{introduction.md => introduction.mdx} | 0 ...eative-project.md => creative-project.mdx} | 0 ...conversation.md => first-conversation.mdx} | 26 +++- .../{messy-ideas.md => messy-ideas.mdx} | 0 src/content/docs/index.md | 79 ----------- src/content/docs/index.mdx | 125 ++++++++++++++++++ ...orkflows.md => ai-augmented-workflows.mdx} | 0 ...ancing.md => cognitive-load-balancing.mdx} | 0 ...spectrum.md => collaboration-spectrum.mdx} | 0 ...chitecture.md => context-architecture.mdx} | 0 ...artnership.md => extended-partnership.mdx} | 0 .../{failure-modes.md => failure-modes.mdx} | 0 ...checking.md => advanced-fact-checking.mdx} | 0 ...gment.md => balance-human-ai-judgment.mdx} | 0 ...ning.md => business-strategy-planning.mdx} | 0 ...yle-guides.md => company-style-guides.mdx} | 0 ...jects.md => complex-creative-projects.mdx} | 0 ...n.md => complex-problem-decomposition.mdx} | 0 ...ns.md => debug-advanced-conversations.mdx} | 0 ...ns.md => facilitate-group-discussions.mdx} | 0 ...-sessions.md => handoff-work-sessions.mdx} | 0 ...tools.md => integrate-workflows-tools.mdx} | 0 ...nt.md => iterative-design-development.mdx} | 0 ...ment.md => learning-skill-development.mdx} | 0 ...intain-context.md => maintain-context.mdx} | 0 ...onversations.md => meta-conversations.mdx} | 0 ...mic-work.md => research-academic-work.mdx} | 0 ...port.md => strategic-thinking-support.mdx} | 0 ...ntation.md => technical-documentation.mdx} | 0 .../reference/{index.md => index.mdx} | 0 ...research.md => collaborative-research.mdx} | 0 ...o-creation.md => creative-co-creation.mdx} | 0 ...artnership.md => learning-partnership.mdx} | 0 ...projects.md => multi-session-projects.mdx} | 0 ...our-domain.md => teaching-your-domain.mdx} | 0 54 files changed, 251 insertions(+), 86 deletions(-) create mode 100644 COMPONENTS-GUIDE.md rename src/content/docs/beginners/explanations/{conversations-vs-commands.md => conversations-vs-commands.mdx} (100%) rename src/content/docs/beginners/explanations/{how-claude-thinks.md => how-claude-thinks.mdx} (100%) rename src/content/docs/beginners/explanations/{making-ai-work-for-life.md => making-ai-work-for-life.mdx} (100%) rename src/content/docs/beginners/explanations/{psychology-collaboration.md => psychology-collaboration.mdx} (100%) rename src/content/docs/beginners/how-to/{ask-when-uncertain.md => ask-when-uncertain.mdx} (100%) rename src/content/docs/beginners/how-to/{avoid-walls-of-text.md => avoid-walls-of-text.mdx} (100%) rename src/content/docs/beginners/how-to/{brainstorm-comfortably.md => brainstorm-comfortably.mdx} (100%) rename src/content/docs/beginners/how-to/{fact-check.md => fact-check.mdx} (100%) rename src/content/docs/beginners/how-to/{fix-misunderstandings.md => fix-misunderstandings.mdx} (100%) rename src/content/docs/beginners/how-to/{get-helpful-feedback.md => get-helpful-feedback.mdx} (100%) rename src/content/docs/beginners/how-to/{get-useful-sources.md => get-useful-sources.mdx} (100%) rename src/content/docs/beginners/how-to/{maintain-voice-writing.md => maintain-voice-writing.mdx} (100%) rename src/content/docs/beginners/how-to/{match-tone-style.md => match-tone-style.mdx} (100%) rename src/content/docs/beginners/how-to/{organize-information.md => organize-information.mdx} (100%) rename src/content/docs/beginners/how-to/{persona-prompts.md => persona-prompts.mdx} (100%) rename src/content/docs/beginners/how-to/{personal-decisions.md => personal-decisions.mdx} (100%) rename src/content/docs/beginners/how-to/{research-unfamiliar-topics.md => research-unfamiliar-topics.mdx} (100%) rename src/content/docs/beginners/reference/{index.md => index.mdx} (100%) rename src/content/docs/beginners/start/{introduction.md => introduction.mdx} (100%) rename src/content/docs/beginners/tutorials/{creative-project.md => creative-project.mdx} (100%) rename src/content/docs/beginners/tutorials/{first-conversation.md => first-conversation.mdx} (82%) rename src/content/docs/beginners/tutorials/{messy-ideas.md => messy-ideas.mdx} (100%) delete mode 100644 src/content/docs/index.md create mode 100644 src/content/docs/index.mdx rename src/content/docs/intermediate/explanations/{ai-augmented-workflows.md => ai-augmented-workflows.mdx} (100%) rename src/content/docs/intermediate/explanations/{cognitive-load-balancing.md => cognitive-load-balancing.mdx} (100%) rename src/content/docs/intermediate/explanations/{collaboration-spectrum.md => collaboration-spectrum.mdx} (100%) rename src/content/docs/intermediate/explanations/{context-architecture.md => context-architecture.mdx} (100%) rename src/content/docs/intermediate/explanations/{extended-partnership.md => extended-partnership.mdx} (100%) rename src/content/docs/intermediate/explanations/{failure-modes.md => failure-modes.mdx} (100%) rename src/content/docs/intermediate/how-to/{advanced-fact-checking.md => advanced-fact-checking.mdx} (100%) rename src/content/docs/intermediate/how-to/{balance-human-ai-judgment.md => balance-human-ai-judgment.mdx} (100%) rename src/content/docs/intermediate/how-to/{business-strategy-planning.md => business-strategy-planning.mdx} (100%) rename src/content/docs/intermediate/how-to/{company-style-guides.md => company-style-guides.mdx} (100%) rename src/content/docs/intermediate/how-to/{complex-creative-projects.md => complex-creative-projects.mdx} (100%) rename src/content/docs/intermediate/how-to/{complex-problem-decomposition.md => complex-problem-decomposition.mdx} (100%) rename src/content/docs/intermediate/how-to/{debug-advanced-conversations.md => debug-advanced-conversations.mdx} (100%) rename src/content/docs/intermediate/how-to/{facilitate-group-discussions.md => facilitate-group-discussions.mdx} (100%) rename src/content/docs/intermediate/how-to/{handoff-work-sessions.md => handoff-work-sessions.mdx} (100%) rename src/content/docs/intermediate/how-to/{integrate-workflows-tools.md => integrate-workflows-tools.mdx} (100%) rename src/content/docs/intermediate/how-to/{iterative-design-development.md => iterative-design-development.mdx} (100%) rename src/content/docs/intermediate/how-to/{learning-skill-development.md => learning-skill-development.mdx} (100%) rename src/content/docs/intermediate/how-to/{maintain-context.md => maintain-context.mdx} (100%) rename src/content/docs/intermediate/how-to/{meta-conversations.md => meta-conversations.mdx} (100%) rename src/content/docs/intermediate/how-to/{research-academic-work.md => research-academic-work.mdx} (100%) rename src/content/docs/intermediate/how-to/{strategic-thinking-support.md => strategic-thinking-support.mdx} (100%) rename src/content/docs/intermediate/how-to/{technical-documentation.md => technical-documentation.mdx} (100%) rename src/content/docs/intermediate/reference/{index.md => index.mdx} (100%) rename src/content/docs/intermediate/tutorials/{collaborative-research.md => collaborative-research.mdx} (100%) rename src/content/docs/intermediate/tutorials/{creative-co-creation.md => creative-co-creation.mdx} (100%) rename src/content/docs/intermediate/tutorials/{learning-partnership.md => learning-partnership.mdx} (100%) rename src/content/docs/intermediate/tutorials/{multi-session-projects.md => multi-session-projects.mdx} (100%) rename src/content/docs/intermediate/tutorials/{teaching-your-domain.md => teaching-your-domain.mdx} (100%) diff --git a/COMPONENTS-GUIDE.md b/COMPONENTS-GUIDE.md new file mode 100644 index 0000000..9d6d035 --- /dev/null +++ b/COMPONENTS-GUIDE.md @@ -0,0 +1,107 @@ +# Starlight Components Reference + +This site now supports all Starlight components! Here's how to use them in your .mdx files: + +## Import Components + +Add this to the top of any .mdx file to use components: + +```jsx +import { + Card, CardGrid, LinkCard, + Aside, Badge, Steps, Tabs, TabItem, + Code, Icon +} from '@astrojs/starlight/components'; +``` + +## Component Examples + +### Cards & CardGrid +```jsx + + +Content here + + +More content + + +``` + +### LinkCard +```jsx + +``` + +### Asides (Callouts) +```jsx + + + + + + + +``` + +### Steps +```jsx + +1. First step +2. Second step +3. Third step + +``` + +### Tabs +```jsx + + +Content for tab 1 + + +Content for tab 2 + + +``` + +### Code +```jsx + +``` + +### Badge +```jsx + + + +``` + +## Usage Tips + +- All content files are now .mdx format (was .md) +- Import components at the top of each file where you want to use them +- Components enhance readability and user experience +- Use Cards for feature highlights +- Use Asides for important callouts +- Use Tabs for before/after examples +- Use Steps for tutorials and processes + +See the homepage and first tutorial for implementation examples! diff --git a/src/content/docs/beginners/explanations/conversations-vs-commands.md b/src/content/docs/beginners/explanations/conversations-vs-commands.mdx similarity index 100% rename from src/content/docs/beginners/explanations/conversations-vs-commands.md rename to src/content/docs/beginners/explanations/conversations-vs-commands.mdx diff --git a/src/content/docs/beginners/explanations/how-claude-thinks.md b/src/content/docs/beginners/explanations/how-claude-thinks.mdx similarity index 100% rename from src/content/docs/beginners/explanations/how-claude-thinks.md rename to src/content/docs/beginners/explanations/how-claude-thinks.mdx diff --git a/src/content/docs/beginners/explanations/making-ai-work-for-life.md b/src/content/docs/beginners/explanations/making-ai-work-for-life.mdx similarity index 100% rename from src/content/docs/beginners/explanations/making-ai-work-for-life.md rename to src/content/docs/beginners/explanations/making-ai-work-for-life.mdx diff --git a/src/content/docs/beginners/explanations/psychology-collaboration.md b/src/content/docs/beginners/explanations/psychology-collaboration.mdx similarity index 100% rename from src/content/docs/beginners/explanations/psychology-collaboration.md rename to src/content/docs/beginners/explanations/psychology-collaboration.mdx diff --git a/src/content/docs/beginners/how-to/ask-when-uncertain.md b/src/content/docs/beginners/how-to/ask-when-uncertain.mdx similarity index 100% rename from src/content/docs/beginners/how-to/ask-when-uncertain.md rename to src/content/docs/beginners/how-to/ask-when-uncertain.mdx diff --git a/src/content/docs/beginners/how-to/avoid-walls-of-text.md b/src/content/docs/beginners/how-to/avoid-walls-of-text.mdx similarity index 100% rename from src/content/docs/beginners/how-to/avoid-walls-of-text.md rename to src/content/docs/beginners/how-to/avoid-walls-of-text.mdx diff --git a/src/content/docs/beginners/how-to/brainstorm-comfortably.md b/src/content/docs/beginners/how-to/brainstorm-comfortably.mdx similarity index 100% rename from src/content/docs/beginners/how-to/brainstorm-comfortably.md rename to src/content/docs/beginners/how-to/brainstorm-comfortably.mdx diff --git a/src/content/docs/beginners/how-to/fact-check.md b/src/content/docs/beginners/how-to/fact-check.mdx similarity index 100% rename from src/content/docs/beginners/how-to/fact-check.md rename to src/content/docs/beginners/how-to/fact-check.mdx diff --git a/src/content/docs/beginners/how-to/fix-misunderstandings.md b/src/content/docs/beginners/how-to/fix-misunderstandings.mdx similarity index 100% rename from src/content/docs/beginners/how-to/fix-misunderstandings.md rename to src/content/docs/beginners/how-to/fix-misunderstandings.mdx diff --git a/src/content/docs/beginners/how-to/get-helpful-feedback.md b/src/content/docs/beginners/how-to/get-helpful-feedback.mdx similarity index 100% rename from src/content/docs/beginners/how-to/get-helpful-feedback.md rename to src/content/docs/beginners/how-to/get-helpful-feedback.mdx diff --git a/src/content/docs/beginners/how-to/get-useful-sources.md b/src/content/docs/beginners/how-to/get-useful-sources.mdx similarity index 100% rename from src/content/docs/beginners/how-to/get-useful-sources.md rename to src/content/docs/beginners/how-to/get-useful-sources.mdx diff --git a/src/content/docs/beginners/how-to/maintain-voice-writing.md b/src/content/docs/beginners/how-to/maintain-voice-writing.mdx similarity index 100% rename from src/content/docs/beginners/how-to/maintain-voice-writing.md rename to src/content/docs/beginners/how-to/maintain-voice-writing.mdx diff --git a/src/content/docs/beginners/how-to/match-tone-style.md b/src/content/docs/beginners/how-to/match-tone-style.mdx similarity index 100% rename from src/content/docs/beginners/how-to/match-tone-style.md rename to src/content/docs/beginners/how-to/match-tone-style.mdx diff --git a/src/content/docs/beginners/how-to/organize-information.md b/src/content/docs/beginners/how-to/organize-information.mdx similarity index 100% rename from src/content/docs/beginners/how-to/organize-information.md rename to src/content/docs/beginners/how-to/organize-information.mdx diff --git a/src/content/docs/beginners/how-to/persona-prompts.md b/src/content/docs/beginners/how-to/persona-prompts.mdx similarity index 100% rename from src/content/docs/beginners/how-to/persona-prompts.md rename to src/content/docs/beginners/how-to/persona-prompts.mdx diff --git a/src/content/docs/beginners/how-to/personal-decisions.md b/src/content/docs/beginners/how-to/personal-decisions.mdx similarity index 100% rename from src/content/docs/beginners/how-to/personal-decisions.md rename to src/content/docs/beginners/how-to/personal-decisions.mdx diff --git a/src/content/docs/beginners/how-to/research-unfamiliar-topics.md b/src/content/docs/beginners/how-to/research-unfamiliar-topics.mdx similarity index 100% rename from src/content/docs/beginners/how-to/research-unfamiliar-topics.md rename to src/content/docs/beginners/how-to/research-unfamiliar-topics.mdx diff --git a/src/content/docs/beginners/reference/index.md b/src/content/docs/beginners/reference/index.mdx similarity index 100% rename from src/content/docs/beginners/reference/index.md rename to src/content/docs/beginners/reference/index.mdx diff --git a/src/content/docs/beginners/start/introduction.md b/src/content/docs/beginners/start/introduction.mdx similarity index 100% rename from src/content/docs/beginners/start/introduction.md rename to src/content/docs/beginners/start/introduction.mdx diff --git a/src/content/docs/beginners/tutorials/creative-project.md b/src/content/docs/beginners/tutorials/creative-project.mdx similarity index 100% rename from src/content/docs/beginners/tutorials/creative-project.md rename to src/content/docs/beginners/tutorials/creative-project.mdx diff --git a/src/content/docs/beginners/tutorials/first-conversation.md b/src/content/docs/beginners/tutorials/first-conversation.mdx similarity index 82% rename from src/content/docs/beginners/tutorials/first-conversation.md rename to src/content/docs/beginners/tutorials/first-conversation.mdx index b90cfdc..6687439 100644 --- a/src/content/docs/beginners/tutorials/first-conversation.md +++ b/src/content/docs/beginners/tutorials/first-conversation.mdx @@ -3,31 +3,43 @@ title: "From Awkward Small Talk to AI Collaboration: My First Real Claude Conver description: "How I went from typing \"Hello\" and waiting for magic to happen, to actually jamming with an AI" --- +import { Card, CardGrid, LinkCard, Aside, Badge, Steps, Tabs, TabItem, Code } from '@astrojs/starlight/components'; + *How I went from typing "Hello" and waiting for magic to happen, to actually jamming with an AI* ## The Moment I Realized I Was Doing It All Wrong Picture this: It's 2024, everyone's talking about AI, and I'm sitting here staring at a blank Claude chat like it's 1998 and I just logged into AOL Instant Messenger for the first time. Or maybe you remember that feeling from your first text message, or setting up BBM on your BlackBerry, or even just joining a new Discord server. You know that moment - cursor blinking, not sure if you're supposed to say "hey" or just dive right into whatever you need. -The thing is, we've all learned how to talk to technology before. Whether it was figuring out AIM screen names, mastering the art of T9 texting without looking, or learning that BlackBerry PIN messages were somehow more official than regular texts - we've always had to figure out the social rules of new communication tech. + But with AI? I completely forgot everything I knew about starting conversations. My first attempt? Pathetic. I typed "Write me a blog post about coffee" and hit enter. Claude dutifully cranked out 500 words of generic coffee content that could have been written by any marketing intern with a caffeine addiction. It was... fine. Technically correct. Completely soulless. -That's when I realized I was treating Claude like a really expensive typewriter instead of what it actually is: a conversation partner who happens to be really good at thinking through problems with you. + ## Let's Try Two Different Approaches I want to show you something. We're going to try the same request two different ways, and I want you to notice what happens. -**First approach:** -"Lookup coffee culture and summarize it." + + + -Go ahead, try that with Claude. See what you get. +Go ahead, try that with Claude. See what you get. It'll be... fine. Generic. Forgettable. + -**Now try this approach:** -"Yo buddy! Can't wait to talk to you about coffee culture - I'm thinking about writing something for my personal blog, but honestly I'm kind of tired of the whole 'third wave' narrative everyone keeps repeating. What angle am I missing here?" + + + +Notice the difference? Context, personality, specific direction, and genuine curiosity. + + Try that one too. Notice the difference in what Claude gives you back. diff --git a/src/content/docs/beginners/tutorials/messy-ideas.md b/src/content/docs/beginners/tutorials/messy-ideas.mdx similarity index 100% rename from src/content/docs/beginners/tutorials/messy-ideas.md rename to src/content/docs/beginners/tutorials/messy-ideas.mdx diff --git a/src/content/docs/index.md b/src/content/docs/index.md deleted file mode 100644 index 8e22a33..0000000 --- a/src/content/docs/index.md +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: How to Talk to Claude - for Humans -description: A comprehensive guide to AI collaboration skills ---- - -*A comprehensive guide to AI collaboration skills - from first conversations to advanced techniques* - -## Two Complete Learning Paths - -### 🎓 Beginners Guide - *Start Here* -*Your complete journey from awkward first conversations to genuine collaboration* - -**Perfect for:** New to AI, basic conversations feel robotic, want to build solid foundations - -**What you'll master:** Essential collaboration skills, conversational fluency, practical techniques for daily use - -### 🚀 Intermediate Guide - *Advanced Partnership* -*Beyond the basics: sophisticated collaboration for complex projects* - -**Perfect for:** Comfortable with AI conversations, ready for substantial projects, want professional-level collaboration - -**What you'll master:** Multi-session projects, domain expertise transfer, workflow integration, strategic thinking partnership - ---- - -## Content Organization - -Both guides follow the same proven learning framework: - -### 🎓 Tutorials (3 guides) -**Learning-oriented** - Step-by-step experiences that build confidence through practice - -Perfect for beginners who want to learn by doing - -### 🔧 How-To Guides (13 guides) -**Task-oriented** - Solutions for specific problems you're facing right now - -Jump straight to what you need when you need it - -### 🧠 Explanations (4 guides) -**Understanding-oriented** - Principles and psychology behind effective collaboration - -Deepen your knowledge of why things work - -### ⚡ Quick Reference -**Information-oriented** - Conversation starters, troubleshooting, emergency fixes - -Bookmark this for ongoing reference - -## Quick Help: Find Your Situation - -**"I'm completely new to AI"** → Start with [Tutorial 1: From Awkward Small Talk to AI Collaboration](/beginners/tutorials/first-conversation/) - -**"I use AI but my conversations feel robotic"** → Jump to [How to Get Claude to Match Your Tone and Style](/beginners/how-to/match-tone-style/) - -**"Claude keeps missing the point"** → [How to Fix It When Claude Completely Misses the Point](/beginners/how-to/fix-misunderstandings/) - -**"I get walls of text when I want simple answers"** → [How to Avoid Getting Walls of Text When You Want Something Simple](/beginners/how-to/avoid-walls-of-text/) - -**"I want to understand what's actually happening"** → Check out the [Explanations section](/beginners/explanations/conversations-vs-commands/) - -**"I'm ready for advanced techniques"** → [How to Use Persona Prompts for Focused Perspectives](/beginners/how-to/persona-prompts/) - -**"I want to do complex projects with Claude"** → Explore the [Intermediate Guide](/intermediate/tutorials/multi-session-projects/) *(coming soon)* - -## About This Approach - -- **Two complete learning paths** - Start with fundamentals or jump to advanced collaboration -- **Experience-driven learning** - Learn by having actual conversations, not just reading about them -- **Problem-focused** - Addresses real frustrations people have with AI at every level -- **Conversational tone** - Written like someone explaining to a friend, not a manual -- **Inclusive examples** - References that work across different tech backgrounds -- **Psychological awareness** - Acknowledges that learning to collaborate with AI involves emotional adjustment - -**Beginners Guide:** ~4 hours | **Intermediate Guide:** ~6 hours | **Immediate value:** Every single section - ---- - -*Ready to transform how you work with AI? Choose your level and dive in.* diff --git a/src/content/docs/index.mdx b/src/content/docs/index.mdx new file mode 100644 index 0000000..9696ac6 --- /dev/null +++ b/src/content/docs/index.mdx @@ -0,0 +1,125 @@ +--- +title: How to Talk to Claude - for Humans +description: A comprehensive guide to AI collaboration skills +--- + +import { Card, CardGrid, LinkCard, Aside, Badge, Steps } from '@astrojs/starlight/components'; + +*A comprehensive guide to AI collaboration skills - from first conversations to advanced techniques* + +## Two Complete Learning Paths + + + +**Start Here** - Your complete journey from awkward first conversations to genuine collaboration + +**Perfect for:** New to AI, basic conversations feel robotic, want to build solid foundations + +**What you'll master:** Essential collaboration skills, conversational fluency, practical techniques for daily use + + + + + +**Advanced Partnership** - Beyond the basics: sophisticated collaboration for complex projects + +**Perfect for:** Comfortable with AI conversations, ready for substantial projects, want professional-level collaboration + +**What you'll master:** Multi-session projects, domain expertise transfer, workflow integration, strategic thinking partnership + + + + + +--- + +## Content Organization + +Both guides follow the same proven learning framework: + +### 🎓 Tutorials (4-5 learning experiences) +**Learning-oriented** - Step-by-step experiences that build confidence through practice + +Perfect for beginners who want to learn by doing + +### 🔧 How-To Guides (13-16 guides) +**Task-oriented** - Solutions for specific problems you're facing right now + +Jump straight to what you need when you need it + +### 🧠 Explanations (4-6 guides) +**Understanding-oriented** - Principles and psychology behind effective collaboration + +Deepen your knowledge of why things work + +### ⚡ Quick Reference +**Information-oriented** - Conversation starters, troubleshooting, emergency fixes + +Bookmark this for ongoing reference + +## Quick Help: Find Your Situation + + + + + + + + + + + + +## About This Approach + + +1. **Two complete learning paths** - Start with fundamentals or jump to advanced collaboration +2. **Experience-driven learning** - Learn by having actual conversations, not just reading about them +3. **Problem-focused** - Addresses real frustrations people have with AI at every level +4. **Conversational tone** - Written like someone explaining to a friend, not a manual +5. **Inclusive examples** - References that work across different tech backgrounds +6. **Psychological awareness** - Acknowledges that learning to collaborate with AI involves emotional adjustment + + + + +--- + +*Ready to transform how you work with AI? Choose your level and dive in.* diff --git a/src/content/docs/intermediate/explanations/ai-augmented-workflows.md b/src/content/docs/intermediate/explanations/ai-augmented-workflows.mdx similarity index 100% rename from src/content/docs/intermediate/explanations/ai-augmented-workflows.md rename to src/content/docs/intermediate/explanations/ai-augmented-workflows.mdx diff --git a/src/content/docs/intermediate/explanations/cognitive-load-balancing.md b/src/content/docs/intermediate/explanations/cognitive-load-balancing.mdx similarity index 100% rename from src/content/docs/intermediate/explanations/cognitive-load-balancing.md rename to src/content/docs/intermediate/explanations/cognitive-load-balancing.mdx diff --git a/src/content/docs/intermediate/explanations/collaboration-spectrum.md b/src/content/docs/intermediate/explanations/collaboration-spectrum.mdx similarity index 100% rename from src/content/docs/intermediate/explanations/collaboration-spectrum.md rename to src/content/docs/intermediate/explanations/collaboration-spectrum.mdx diff --git a/src/content/docs/intermediate/explanations/context-architecture.md b/src/content/docs/intermediate/explanations/context-architecture.mdx similarity index 100% rename from src/content/docs/intermediate/explanations/context-architecture.md rename to src/content/docs/intermediate/explanations/context-architecture.mdx diff --git a/src/content/docs/intermediate/explanations/extended-partnership.md b/src/content/docs/intermediate/explanations/extended-partnership.mdx similarity index 100% rename from src/content/docs/intermediate/explanations/extended-partnership.md rename to src/content/docs/intermediate/explanations/extended-partnership.mdx diff --git a/src/content/docs/intermediate/explanations/failure-modes.md b/src/content/docs/intermediate/explanations/failure-modes.mdx similarity index 100% rename from src/content/docs/intermediate/explanations/failure-modes.md rename to src/content/docs/intermediate/explanations/failure-modes.mdx diff --git a/src/content/docs/intermediate/how-to/advanced-fact-checking.md b/src/content/docs/intermediate/how-to/advanced-fact-checking.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/advanced-fact-checking.md rename to src/content/docs/intermediate/how-to/advanced-fact-checking.mdx diff --git a/src/content/docs/intermediate/how-to/balance-human-ai-judgment.md b/src/content/docs/intermediate/how-to/balance-human-ai-judgment.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/balance-human-ai-judgment.md rename to src/content/docs/intermediate/how-to/balance-human-ai-judgment.mdx diff --git a/src/content/docs/intermediate/how-to/business-strategy-planning.md b/src/content/docs/intermediate/how-to/business-strategy-planning.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/business-strategy-planning.md rename to src/content/docs/intermediate/how-to/business-strategy-planning.mdx diff --git a/src/content/docs/intermediate/how-to/company-style-guides.md b/src/content/docs/intermediate/how-to/company-style-guides.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/company-style-guides.md rename to src/content/docs/intermediate/how-to/company-style-guides.mdx diff --git a/src/content/docs/intermediate/how-to/complex-creative-projects.md b/src/content/docs/intermediate/how-to/complex-creative-projects.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/complex-creative-projects.md rename to src/content/docs/intermediate/how-to/complex-creative-projects.mdx diff --git a/src/content/docs/intermediate/how-to/complex-problem-decomposition.md b/src/content/docs/intermediate/how-to/complex-problem-decomposition.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/complex-problem-decomposition.md rename to src/content/docs/intermediate/how-to/complex-problem-decomposition.mdx diff --git a/src/content/docs/intermediate/how-to/debug-advanced-conversations.md b/src/content/docs/intermediate/how-to/debug-advanced-conversations.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/debug-advanced-conversations.md rename to src/content/docs/intermediate/how-to/debug-advanced-conversations.mdx diff --git a/src/content/docs/intermediate/how-to/facilitate-group-discussions.md b/src/content/docs/intermediate/how-to/facilitate-group-discussions.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/facilitate-group-discussions.md rename to src/content/docs/intermediate/how-to/facilitate-group-discussions.mdx diff --git a/src/content/docs/intermediate/how-to/handoff-work-sessions.md b/src/content/docs/intermediate/how-to/handoff-work-sessions.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/handoff-work-sessions.md rename to src/content/docs/intermediate/how-to/handoff-work-sessions.mdx diff --git a/src/content/docs/intermediate/how-to/integrate-workflows-tools.md b/src/content/docs/intermediate/how-to/integrate-workflows-tools.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/integrate-workflows-tools.md rename to src/content/docs/intermediate/how-to/integrate-workflows-tools.mdx diff --git a/src/content/docs/intermediate/how-to/iterative-design-development.md b/src/content/docs/intermediate/how-to/iterative-design-development.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/iterative-design-development.md rename to src/content/docs/intermediate/how-to/iterative-design-development.mdx diff --git a/src/content/docs/intermediate/how-to/learning-skill-development.md b/src/content/docs/intermediate/how-to/learning-skill-development.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/learning-skill-development.md rename to src/content/docs/intermediate/how-to/learning-skill-development.mdx diff --git a/src/content/docs/intermediate/how-to/maintain-context.md b/src/content/docs/intermediate/how-to/maintain-context.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/maintain-context.md rename to src/content/docs/intermediate/how-to/maintain-context.mdx diff --git a/src/content/docs/intermediate/how-to/meta-conversations.md b/src/content/docs/intermediate/how-to/meta-conversations.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/meta-conversations.md rename to src/content/docs/intermediate/how-to/meta-conversations.mdx diff --git a/src/content/docs/intermediate/how-to/research-academic-work.md b/src/content/docs/intermediate/how-to/research-academic-work.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/research-academic-work.md rename to src/content/docs/intermediate/how-to/research-academic-work.mdx diff --git a/src/content/docs/intermediate/how-to/strategic-thinking-support.md b/src/content/docs/intermediate/how-to/strategic-thinking-support.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/strategic-thinking-support.md rename to src/content/docs/intermediate/how-to/strategic-thinking-support.mdx diff --git a/src/content/docs/intermediate/how-to/technical-documentation.md b/src/content/docs/intermediate/how-to/technical-documentation.mdx similarity index 100% rename from src/content/docs/intermediate/how-to/technical-documentation.md rename to src/content/docs/intermediate/how-to/technical-documentation.mdx diff --git a/src/content/docs/intermediate/reference/index.md b/src/content/docs/intermediate/reference/index.mdx similarity index 100% rename from src/content/docs/intermediate/reference/index.md rename to src/content/docs/intermediate/reference/index.mdx diff --git a/src/content/docs/intermediate/tutorials/collaborative-research.md b/src/content/docs/intermediate/tutorials/collaborative-research.mdx similarity index 100% rename from src/content/docs/intermediate/tutorials/collaborative-research.md rename to src/content/docs/intermediate/tutorials/collaborative-research.mdx diff --git a/src/content/docs/intermediate/tutorials/creative-co-creation.md b/src/content/docs/intermediate/tutorials/creative-co-creation.mdx similarity index 100% rename from src/content/docs/intermediate/tutorials/creative-co-creation.md rename to src/content/docs/intermediate/tutorials/creative-co-creation.mdx diff --git a/src/content/docs/intermediate/tutorials/learning-partnership.md b/src/content/docs/intermediate/tutorials/learning-partnership.mdx similarity index 100% rename from src/content/docs/intermediate/tutorials/learning-partnership.md rename to src/content/docs/intermediate/tutorials/learning-partnership.mdx diff --git a/src/content/docs/intermediate/tutorials/multi-session-projects.md b/src/content/docs/intermediate/tutorials/multi-session-projects.mdx similarity index 100% rename from src/content/docs/intermediate/tutorials/multi-session-projects.md rename to src/content/docs/intermediate/tutorials/multi-session-projects.mdx diff --git a/src/content/docs/intermediate/tutorials/teaching-your-domain.md b/src/content/docs/intermediate/tutorials/teaching-your-domain.mdx similarity index 100% rename from src/content/docs/intermediate/tutorials/teaching-your-domain.md rename to src/content/docs/intermediate/tutorials/teaching-your-domain.mdx