how-to-talk-to-claude/astro.config.mjs
Claude AI Guide Project 428a3a44b7 feat: Complete Intermediate Guide outline structure
📚 COMPLETE INTERMEDIATE GUIDE FRAMEWORK:

🎓 Tutorials (5 guides):
- Multi-Session Project Management
- Teaching Claude Your Domain
- Collaborative Analysis & Research
- Creative Co-Creation Workshop
- Learning Partnership Tutorial

🔧 How-To Guides (16 guides organized by category):

Project & Workflow Integration (4):
- Maintain context across long-term projects
- Hand off work between sessions
- Integrate Claude into existing workflows
- Collaborate on iterative design and development

Advanced Communication (4):
- Teach Claude company style guides
- Have meta-conversations about collaboration
- Debug advanced conversations gone wrong
- Balance human intuition with AI analysis

Specialized Applications (5):
- Complex problem decomposition
- Technical documentation collaboration
- Advanced fact-checking and source validation
- Strategic thinking and decision support
- Facilitate group discussions and workshops

Domain-Specific Collaboration (4):
- Research and academic work
- Business strategy and planning
- Complex creative projects
- Learning and skill development

🧠 Explanations (6 concepts):
- Psychology of Extended AI Partnership
- Context Architecture for complex collaboration
- Cognitive Load Balancing strategies
- Spectrum of AI Collaboration Styles
- Failure Modes in Advanced Collaboration
- Building AI-Augmented Workflows

 Advanced Reference:
- Power-user techniques and templates
- Troubleshooting guide for complex issues
- Integration patterns and meta-prompts

🗂️ Navigation Structure:
- Complete sidebar with organized categories
- 27 total intermediate content pieces
- Logical progression from tutorials → how-to → explanations
- Clear 'Preview' badges indicating development status

All content includes structured placeholders with 'Coming Soon'
messaging and topic outlines ready for full development.
2025-07-08 00:31:32 -06:00

195 lines
8.1 KiB
JavaScript

// @ts-check
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';
// https://astro.build/config
export default defineConfig({
integrations: [
starlight({
title: 'How to Talk to Claude',
description: 'A comprehensive guide to AI collaboration skills - for humans',
logo: {
src: './src/assets/logo.svg',
},
social: [
{ icon: 'github', label: 'GitHub', href: 'https://github.com/your-username/how-to-talk-to-claude' }
],
sidebar: [
{
label: 'Beginners Guide',
badge: 'Start here',
collapsed: false,
items: [
{
label: 'Start Here',
items: [
{ label: 'Introduction', link: '/beginners/start/introduction/' },
],
},
{
label: 'Tutorials',
badge: '3 guides',
collapsed: false,
items: [
{ label: 'First Conversation', link: '/beginners/tutorials/first-conversation/', badge: 'New to AI?' },
{ label: 'Messy Ideas to Results', link: '/beginners/tutorials/messy-ideas/' },
{ label: 'Creative Collaboration', link: '/beginners/tutorials/creative-project/' },
],
},
{
label: 'How-To Guides',
badge: '13 guides',
collapsed: true,
items: [
{
label: 'Communication & Style',
collapsed: true,
items: [
{ label: 'Ask When Uncertain', link: '/beginners/how-to/ask-when-uncertain/' },
{ label: 'Match Your Tone', link: '/beginners/how-to/match-tone-style/' },
{ label: 'Fix Misunderstandings', link: '/beginners/how-to/fix-misunderstandings/' },
],
},
{
label: 'Information & Research',
collapsed: true,
items: [
{ label: 'Fact-Check Answers', link: '/beginners/how-to/fact-check/' },
{ label: 'Avoid Walls of Text', link: '/beginners/how-to/avoid-walls-of-text/' },
{ label: 'Get Useful Sources', link: '/beginners/how-to/get-useful-sources/' },
{ label: 'Research Unfamiliar Topics', link: '/beginners/how-to/research-unfamiliar-topics/' },
{ label: 'Organize Information', link: '/beginners/how-to/organize-information/' },
],
},
{
label: 'Creative & Personal Work',
collapsed: true,
items: [
{ label: 'Brainstorm Comfortably', link: '/beginners/how-to/brainstorm-comfortably/' },
{ label: 'Get Helpful Feedback', link: '/beginners/how-to/get-helpful-feedback/' },
{ label: 'Personal Decisions', link: '/beginners/how-to/personal-decisions/' },
{ label: 'Maintain Your Voice', link: '/beginners/how-to/maintain-voice-writing/' },
],
},
{
label: 'Advanced Techniques',
collapsed: true,
items: [
{ label: 'Persona Prompts', link: '/beginners/how-to/persona-prompts/' },
],
},
],
},
{
label: 'Explanations',
badge: '4 guides',
collapsed: true,
items: [
{ label: 'Conversations vs Commands', link: '/beginners/explanations/conversations-vs-commands/' },
{ label: 'Psychology of Collaboration', link: '/beginners/explanations/psychology-collaboration/' },
{ label: 'How Claude Thinks', link: '/beginners/explanations/how-claude-thinks/' },
{ label: 'Making AI Work for Life', link: '/beginners/explanations/making-ai-work-for-life/' },
],
},
{
label: 'Quick Reference',
items: [
{ label: 'Conversation Starters', link: '/beginners/reference/' },
],
},
],
},
{
label: 'Intermediate Guide',
badge: 'Coming soon',
collapsed: true,
items: [
{
label: 'Tutorials',
badge: '5 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: 'Learning Partnership', link: '/intermediate/tutorials/learning-partnership/', badge: 'Preview' },
],
},
{
label: 'How-To Guides',
badge: '16 guides',
collapsed: true,
items: [
{
label: 'Project & Workflow',
collapsed: true,
items: [
{ label: 'Maintain Context', link: '/intermediate/how-to/maintain-context/', badge: 'Preview' },
{ label: 'Hand Off Work Between Sessions', link: '/intermediate/how-to/handoff-work-sessions/', badge: 'Preview' },
{ label: 'Integrate into Workflows', link: '/intermediate/how-to/integrate-workflows-tools/', badge: 'Preview' },
{ label: 'Iterative Design & Development', link: '/intermediate/how-to/iterative-design-development/', badge: 'Preview' },
],
},
{
label: 'Advanced Communication',
collapsed: true,
items: [
{ label: 'Company Style Guides', link: '/intermediate/how-to/company-style-guides/', badge: 'Preview' },
{ label: 'Meta-Conversations', link: '/intermediate/how-to/meta-conversations/', badge: 'Preview' },
{ label: 'Debug Advanced Conversations', link: '/intermediate/how-to/debug-advanced-conversations/', badge: 'Preview' },
{ label: 'Balance Human-AI Judgment', link: '/intermediate/how-to/balance-human-ai-judgment/', badge: 'Preview' },
],
},
{
label: 'Specialized Applications',
collapsed: true,
items: [
{ label: 'Complex Problem Decomposition', link: '/intermediate/how-to/complex-problem-decomposition/', badge: 'Preview' },
{ label: 'Technical Documentation', link: '/intermediate/how-to/technical-documentation/', badge: 'Preview' },
{ label: 'Advanced Fact-Checking', link: '/intermediate/how-to/advanced-fact-checking/', badge: 'Preview' },
{ label: 'Strategic Thinking Support', link: '/intermediate/how-to/strategic-thinking-support/', badge: 'Preview' },
{ label: 'Facilitate Group Discussions', link: '/intermediate/how-to/facilitate-group-discussions/', badge: 'Preview' },
],
},
{
label: 'Domain-Specific',
collapsed: true,
items: [
{ label: 'Research & Academic Work', link: '/intermediate/how-to/research-academic-work/', badge: 'Preview' },
{ label: 'Business Strategy & Planning', link: '/intermediate/how-to/business-strategy-planning/', badge: 'Preview' },
{ label: 'Complex Creative Projects', link: '/intermediate/how-to/complex-creative-projects/', badge: 'Preview' },
{ label: 'Learning & Skill Development', link: '/intermediate/how-to/learning-skill-development/', badge: 'Preview' },
],
},
],
},
{
label: 'Explanations',
badge: '6 guides',
collapsed: true,
items: [
{ label: 'Extended Partnership Psychology', link: '/intermediate/explanations/extended-partnership/', badge: 'Preview' },
{ label: 'Context Architecture', link: '/intermediate/explanations/context-architecture/', badge: 'Preview' },
{ label: 'Cognitive Load Balancing', link: '/intermediate/explanations/cognitive-load-balancing/', badge: 'Preview' },
{ label: 'Collaboration Spectrum', link: '/intermediate/explanations/collaboration-spectrum/', badge: 'Preview' },
{ label: 'Failure Modes', link: '/intermediate/explanations/failure-modes/', badge: 'Preview' },
{ label: 'AI-Augmented Workflows', link: '/intermediate/explanations/ai-augmented-workflows/', badge: 'Preview' },
],
},
{
label: 'Advanced Reference',
items: [
{ label: 'Power-User Guide', link: '/intermediate/reference/', badge: 'Preview' },
],
},
],
},
],
customCss: [
'./src/styles/custom.css',
],
}),
],
});