feat: Restructure into Beginners and Intermediate guides

🔄 MAJOR RESTRUCTURE:
- Move all existing content under '/beginners/' path
- Create '/intermediate/' section with advanced collaboration outline
- Update navigation to support two learning tracks

📁 Beginners Guide (Complete - 20+ guides):
- All existing tutorials, how-to guides, explanations preserved
- Updated all internal links to new /beginners/ paths
- Maintains full functionality of original content

🚀 Intermediate Guide (Preview structure):
- 4 advanced tutorials (Multi-session, Domain teaching, etc.)
- Placeholder how-to guides for complex workflows
- Advanced explanations for sophisticated collaboration
- 'Coming soon' content with structured outlines

🏗️ Navigation & Structure:
- Two-tier sidebar: Beginners (start here) / Intermediate (advanced)
- Updated homepage to explain both learning paths
- Preserved all original content organization within beginners
- Added appropriate badges ('Preview', 'Coming soon', etc.)

Ready for intermediate content development while maintaining
full functionality of the complete beginners guide.
This commit is contained in:
Claude AI Guide Project 2025-07-08 00:23:55 -06:00
parent 0d6fea5528
commit fab2254318
30 changed files with 231 additions and 65 deletions

View File

@ -12,10 +12,15 @@ export default defineConfig({
{ icon: 'github', label: 'GitHub', href: 'https://github.com/your-username/how-to-talk-to-claude' } { icon: 'github', label: 'GitHub', href: 'https://github.com/your-username/how-to-talk-to-claude' }
], ],
sidebar: [ sidebar: [
{
label: 'Beginners Guide',
badge: 'Start here',
collapsed: false,
items: [
{ {
label: 'Start Here', label: 'Start Here',
items: [ items: [
{ label: 'Introduction', link: '/start/introduction/' }, { label: 'Introduction', link: '/beginners/start/introduction/' },
], ],
}, },
{ {
@ -23,9 +28,9 @@ export default defineConfig({
badge: '3 guides', badge: '3 guides',
collapsed: false, collapsed: false,
items: [ items: [
{ label: 'First Conversation', link: '/tutorials/first-conversation/', badge: 'New to AI?' }, { label: 'First Conversation', link: '/beginners/tutorials/first-conversation/', badge: 'New to AI?' },
{ label: 'Messy Ideas to Results', link: '/tutorials/messy-ideas/' }, { label: 'Messy Ideas to Results', link: '/beginners/tutorials/messy-ideas/' },
{ label: 'Creative Collaboration', link: '/tutorials/creative-project/' }, { label: 'Creative Collaboration', link: '/beginners/tutorials/creative-project/' },
], ],
}, },
{ {
@ -37,37 +42,37 @@ export default defineConfig({
label: 'Communication & Style', label: 'Communication & Style',
collapsed: true, collapsed: true,
items: [ items: [
{ label: 'Ask When Uncertain', link: '/how-to/ask-when-uncertain/' }, { label: 'Ask When Uncertain', link: '/beginners/how-to/ask-when-uncertain/' },
{ label: 'Match Your Tone', link: '/how-to/match-tone-style/' }, { label: 'Match Your Tone', link: '/beginners/how-to/match-tone-style/' },
{ label: 'Fix Misunderstandings', link: '/how-to/fix-misunderstandings/' }, { label: 'Fix Misunderstandings', link: '/beginners/how-to/fix-misunderstandings/' },
], ],
}, },
{ {
label: 'Information & Research', label: 'Information & Research',
collapsed: true, collapsed: true,
items: [ items: [
{ label: 'Fact-Check Answers', link: '/how-to/fact-check/' }, { label: 'Fact-Check Answers', link: '/beginners/how-to/fact-check/' },
{ label: 'Avoid Walls of Text', link: '/how-to/avoid-walls-of-text/' }, { label: 'Avoid Walls of Text', link: '/beginners/how-to/avoid-walls-of-text/' },
{ label: 'Get Useful Sources', link: '/how-to/get-useful-sources/' }, { label: 'Get Useful Sources', link: '/beginners/how-to/get-useful-sources/' },
{ label: 'Research Unfamiliar Topics', link: '/how-to/research-unfamiliar-topics/' }, { label: 'Research Unfamiliar Topics', link: '/beginners/how-to/research-unfamiliar-topics/' },
{ label: 'Organize Information', link: '/how-to/organize-information/' }, { label: 'Organize Information', link: '/beginners/how-to/organize-information/' },
], ],
}, },
{ {
label: 'Creative & Personal Work', label: 'Creative & Personal Work',
collapsed: true, collapsed: true,
items: [ items: [
{ label: 'Brainstorm Comfortably', link: '/how-to/brainstorm-comfortably/' }, { label: 'Brainstorm Comfortably', link: '/beginners/how-to/brainstorm-comfortably/' },
{ label: 'Get Helpful Feedback', link: '/how-to/get-helpful-feedback/' }, { label: 'Get Helpful Feedback', link: '/beginners/how-to/get-helpful-feedback/' },
{ label: 'Personal Decisions', link: '/how-to/personal-decisions/' }, { label: 'Personal Decisions', link: '/beginners/how-to/personal-decisions/' },
{ label: 'Maintain Your Voice', link: '/how-to/maintain-voice-writing/' }, { label: 'Maintain Your Voice', link: '/beginners/how-to/maintain-voice-writing/' },
], ],
}, },
{ {
label: 'Advanced Techniques', label: 'Advanced Techniques',
collapsed: true, collapsed: true,
items: [ items: [
{ label: 'Persona Prompts', link: '/how-to/persona-prompts/' }, { label: 'Persona Prompts', link: '/beginners/how-to/persona-prompts/' },
], ],
}, },
], ],
@ -77,16 +82,58 @@ export default defineConfig({
badge: '4 guides', badge: '4 guides',
collapsed: true, collapsed: true,
items: [ items: [
{ label: 'Conversations vs Commands', link: '/explanations/conversations-vs-commands/' }, { label: 'Conversations vs Commands', link: '/beginners/explanations/conversations-vs-commands/' },
{ label: 'Psychology of Collaboration', link: '/explanations/psychology-collaboration/' }, { label: 'Psychology of Collaboration', link: '/beginners/explanations/psychology-collaboration/' },
{ label: 'How Claude Thinks', link: '/explanations/how-claude-thinks/' }, { label: 'How Claude Thinks', link: '/beginners/explanations/how-claude-thinks/' },
{ label: 'Making AI Work for Life', link: '/explanations/making-ai-work-for-life/' }, { label: 'Making AI Work for Life', link: '/beginners/explanations/making-ai-work-for-life/' },
], ],
}, },
{ {
label: 'Quick Reference', label: 'Quick Reference',
items: [ items: [
{ label: 'Conversation Starters', link: '/reference/' }, { label: 'Conversation Starters', link: '/beginners/reference/' },
],
},
],
},
{
label: 'Intermediate Guide',
badge: 'Coming soon',
collapsed: true,
items: [
{
label: 'Tutorials',
badge: '4 guides',
collapsed: false,
items: [
{ label: 'Multi-Session Projects', link: '/intermediate/tutorials/multi-session-projects/', badge: 'Preview' },
{ label: 'Teaching Your Domain', link: '/intermediate/tutorials/teaching-your-domain/', badge: 'Preview' },
{ label: 'Collaborative Research', link: '/intermediate/tutorials/collaborative-research/', badge: 'Preview' },
{ label: 'Creative Co-Creation', link: '/intermediate/tutorials/creative-co-creation/', badge: 'Preview' },
],
},
{
label: 'How-To Guides',
badge: 'In development',
collapsed: true,
items: [
{
label: 'Project & Workflow',
collapsed: true,
items: [
{ label: 'Maintain Context', link: '/intermediate/how-to/maintain-context/', badge: 'Preview' },
],
},
],
},
{
label: 'Explanations',
badge: 'In development',
collapsed: true,
items: [
{ label: 'Extended Partnership', link: '/intermediate/explanations/extended-partnership/', badge: 'Preview' },
],
},
], ],
}, },
], ],

View File

@ -5,14 +5,28 @@ description: A comprehensive guide to AI collaboration skills
*A comprehensive guide to AI collaboration skills - from first conversations to advanced techniques* *A comprehensive guide to AI collaboration skills - from first conversations to advanced techniques*
## What This Guide Offers ## Two Complete Learning Paths
This isn't another "how to prompt AI" tutorial. This is the complete journey from awkward first conversations to genuinely collaborative partnerships with AI. Whether you've never touched AI before or you're already using it but want to get *actually good* at it, this guide meets you where you are and takes you where you want to go. ### 🎓 Beginners Guide - *Start Here*
*Your complete journey from awkward first conversations to genuine collaboration*
**What makes this different:** Instead of treating AI like a fancy search engine, you'll learn to collaborate with it like a thoughtful partner who happens to be excellent at thinking through problems with you. **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 ## Content Organization
Both guides follow the same proven learning framework:
### 🎓 Tutorials (3 guides) ### 🎓 Tutorials (3 guides)
**Learning-oriented** - Step-by-step experiences that build confidence through practice **Learning-oriented** - Step-by-step experiences that build confidence through practice
@ -35,28 +49,31 @@ Bookmark this for ongoing reference
## Quick Help: Find Your Situation ## Quick Help: Find Your Situation
**"I'm completely new to AI"** → Start with [Tutorial 1: From Awkward Small Talk to AI Collaboration](/tutorials/first-conversation/) **"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](/how-to/match-tone-style/) **"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](/how-to/fix-misunderstandings/) **"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](/how-to/avoid-walls-of-text/) **"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](/explanations/conversations-vs-commands/) **"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](/how-to/persona-prompts/) **"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 ## 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 - **Experience-driven learning** - Learn by having actual conversations, not just reading about them
- **Problem-focused** - Addresses real frustrations people have with AI - **Problem-focused** - Addresses real frustrations people have with AI at every level
- **Conversational tone** - Written like someone explaining to a friend, not a manual - **Conversational tone** - Written like someone explaining to a friend, not a manual
- **Inclusive examples** - References that work across different tech backgrounds - **Inclusive examples** - References that work across different tech backgrounds
- **Psychological awareness** - Acknowledges that learning to collaborate with AI involves emotional adjustment - **Psychological awareness** - Acknowledges that learning to collaborate with AI involves emotional adjustment
**Total reading time:** ~4 hours | **Immediate value:** Every single section **Beginners Guide:** ~4 hours | **Intermediate Guide:** ~6 hours | **Immediate value:** Every single section
--- ---
*Ready to transform how you work with AI? Pick your starting point above and dive in.* *Ready to transform how you work with AI? Choose your level and dive in.*

View File

@ -0,0 +1,17 @@
---
title: "The Psychology of Extended AI Partnership"
description: "How the relationship evolves over time and projects"
---
*How the relationship evolves over time and projects*
## Coming Soon
This explanation will explore:
- Evolution of AI collaboration relationships
- Trust and dependency patterns
- Long-term collaboration psychology
- Maintaining healthy AI partnerships
*This content is in development as part of the Advanced AI Collaboration guide.*

View File

@ -0,0 +1,17 @@
---
title: "How to Maintain Context Across Long-Term Projects"
description: "Keeping Claude up to speed on ongoing work without starting from scratch each time"
---
*Keeping Claude up to speed on ongoing work without starting from scratch each time*
## Coming Soon
This guide will provide practical techniques for:
- Context preservation strategies
- Session handoff protocols
- Project state documentation
- Context reconstruction methods
*This content is in development as part of the Advanced AI Collaboration guide.*

View File

@ -0,0 +1,17 @@
---
title: "Collaborative Analysis & Research"
description: "Working together on complex problems that require multiple approaches and iterations"
---
*Working together on complex problems that require multiple approaches and iterations*
## Coming Soon
This tutorial will guide you through sophisticated research collaboration, covering:
- Multi-angle problem analysis
- Iterative research methodologies
- Evidence synthesis and validation
- Collaborative hypothesis testing
*This content is in development as part of the Advanced AI Collaboration guide.*

View File

@ -0,0 +1,17 @@
---
title: "Creative Co-Creation Workshop"
description: "Moving from 'help me write' to genuine creative partnership on original work"
---
*Moving from "help me write" to genuine creative partnership on original work*
## Coming Soon
This tutorial will explore advanced creative collaboration, covering:
- Co-creation methodologies
- Balancing human creativity with AI capabilities
- Iterative creative development
- Original work partnership patterns
*This content is in development as part of the Advanced AI Collaboration guide.*

View File

@ -0,0 +1,17 @@
---
title: "Multi-Session Project Management"
description: "Building something substantial over multiple conversations while maintaining context and momentum"
---
*Building something substantial over multiple conversations while maintaining context and momentum*
## Coming Soon
This tutorial will guide you through managing complex projects that span multiple conversations with Claude, covering:
- Context management strategies
- Maintaining project momentum across sessions
- Handoff techniques for ongoing work
- Documentation patterns for long-term collaboration
*This content is in development as part of the Advanced AI Collaboration guide.*

View File

@ -0,0 +1,17 @@
---
title: "Teaching Claude Your Domain"
description: "Getting Claude up to speed on your specific field/expertise for ongoing collaboration"
---
*Getting Claude up to speed on your specific field/expertise for ongoing collaboration*
## Coming Soon
This tutorial will show you how to effectively onboard Claude into your domain expertise, covering:
- Domain knowledge transfer techniques
- Building shared vocabulary and context
- Creating reusable knowledge bases
- Maintaining expertise across conversations
*This content is in development as part of the Advanced AI Collaboration guide.*