how-to-talk-to-claude/astro.config.mjs

// @ts-check
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';
import starlightSiteGraph from 'starlight-site-graph';
import starlightThemeObsidian from 'starlight-theme-obsidian';

// 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' }
			],
			plugins: [
				starlightThemeObsidian(),
				starlightSiteGraph({
					config: {
						graphTitle: 'Site Graph',
						graphDescription: 'Navigate the connections between guides and concepts',
						graphConfig: {
							  "nodeDefaultStyle": {
								  "shape": "star",
								  "shapePoints": 5
							  }
						}
					}
				})
			],
			sidebar: [
				{
					label: 'Beginners Guide',
					badge: 'Start here',
					collapsed: false,
					items: [
						{
							label: 'Tutorials',
							collapsed: false,
							items: [
								{ label: 'Start Here: First Conversation', link: '/beginners/tutorials/first-conversation/' },
								{ label: 'Messy Ideas to Results', link: '/beginners/tutorials/messy-ideas/' },
								{ label: 'Creative Collaboration', link: '/beginners/tutorials/creative-project/' },
							],
						},
						{
							label: 'How-To 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',
							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: 'Reference',
							items: [
								{ label: 'Conversation Starters', link: '/beginners/reference/' },
							],
						},
					],
				},
				{
					label: 'Intermediate Guide',
					collapsed: true,
					items: [
						{
							label: 'Tutorials',
							collapsed: false,
							items: [
								{ label: 'Multi-Session Projects', link: '/intermediate/tutorials/multi-session-projects/' },
								{ label: 'Teaching Your Domain', link: '/intermediate/tutorials/teaching-your-domain/' },
								{ label: 'Collaborative Research', link: '/intermediate/tutorials/collaborative-research/' },
								{ label: 'Creative Co-Creation', link: '/intermediate/tutorials/creative-co-creation/' },
								{ label: 'Learning Partnership', link: '/intermediate/tutorials/learning-partnership/' },
							],
						},
						{
							label: 'How-To Guides',
							collapsed: true,
							items: [
								{
									label: 'Project & Workflow',
									collapsed: true,
									items: [
										{ label: 'Maintain Context', link: '/intermediate/how-to/maintain-context/' },
										{ label: 'Hand Off Work Between Sessions', link: '/intermediate/how-to/handoff-work-sessions/' },
										{ label: 'Integrate into Workflows', link: '/intermediate/how-to/integrate-workflows-tools/' },
										{ label: 'Iterative Design & Development', link: '/intermediate/how-to/iterative-design-development/' },
									],
								},
								{
									label: 'Advanced Communication',
									collapsed: true,
									items: [
										{ label: 'Company Style Guides', link: '/intermediate/how-to/company-style-guides/' },
										{ label: 'Meta-Conversations', link: '/intermediate/how-to/meta-conversations/' },
										{ label: 'Debug Advanced Conversations', link: '/intermediate/how-to/debug-advanced-conversations/' },
										{ label: 'Balance Human-AI Judgment', link: '/intermediate/how-to/balance-human-ai-judgment/' },
									],
								},
								{
									label: 'Specialized Applications',
									collapsed: true,
									items: [
										{ label: 'Complex Problem Decomposition', link: '/intermediate/how-to/complex-problem-decomposition/' },
										{ label: 'Technical Documentation', link: '/intermediate/how-to/technical-documentation/' },
										{ label: 'Advanced Fact-Checking', link: '/intermediate/how-to/advanced-fact-checking/' },
										{ label: 'Strategic Thinking Support', link: '/intermediate/how-to/strategic-thinking-support/' },
										{ label: 'Facilitate Group Discussions', link: '/intermediate/how-to/facilitate-group-discussions/' },
									],
								},
								{
									label: 'Domain-Specific',
									collapsed: true,
									items: [
										{ label: 'Research & Academic Work', link: '/intermediate/how-to/research-academic-work/' },
										{ label: 'Business Strategy & Planning', link: '/intermediate/how-to/business-strategy-planning/' },
										{ label: 'Complex Creative Projects', link: '/intermediate/how-to/complex-creative-projects/' },
										{ label: 'Learning & Skill Development', link: '/intermediate/how-to/learning-skill-development/' },
									],
								},
							],
						},
						{
							label: 'Explanations',
							collapsed: true,
							items: [
								{ label: 'Extended Partnership Psychology', link: '/intermediate/explanations/extended-partnership/' },
								{ label: 'Context Architecture', link: '/intermediate/explanations/context-architecture/' },
								{ label: 'Cognitive Load Balancing', link: '/intermediate/explanations/cognitive-load-balancing/' },
								{ label: 'Collaboration Spectrum', link: '/intermediate/explanations/collaboration-spectrum/' },
								{ label: 'Failure Modes', link: '/intermediate/explanations/failure-modes/' },
								{ label: 'AI-Augmented Workflows', link: '/intermediate/explanations/ai-augmented-workflows/' },
							],
						},
						{
							label: 'Reference',
							items: [
								{ label: 'Power-User Guide', link: '/intermediate/reference/' },
							],
						},
					],
				},
				{
					label: 'Advanced Guide',
					badge: 'MCP-Powered',
					collapsed: true,
					items: [
						{
							label: 'Tutorials',
							collapsed: false,
							items: [
								{ label: 'MCP Foundation Workshop', link: '/advanced/tutorials/mcp-foundation-workshop/' },
								{ label: 'Multi-AI Orchestration', link: '/advanced/tutorials/multi-ai-orchestration/' },
								{ label: 'Enterprise Integration Bootcamp', link: '/advanced/tutorials/enterprise-integration/' },
								{ label: '🚧 Real-Time AI Discovery Lab', link: '/advanced/tutorials/real-time-discovery/' },
								{ label: '🚧 Custom AI Development Partnership', link: '/advanced/tutorials/custom-ai-development/' },
							],
						},
						{
							label: 'How-To Guides',
							collapsed: true,
							items: [
								{
									label: 'Architecture & Design',
									collapsed: true,
									items: [
										{ label: 'Design Connected AI Workflows', link: '/advanced/how-to/design-connected-workflows/' },
										{ label: '🚧 Scale AI Integrations', link: '/advanced/how-to/scale-ai-integrations/' },
										{ label: '🚧 Build Resilient AI Ecosystems', link: '/advanced/how-to/build-resilient-ecosystems/' },
										{ label: '🚧 Create AI Security Frameworks', link: '/advanced/how-to/ai-security-frameworks/' },
									],
								},
								{
									label: 'Real-Time Operations',
									collapsed: true,
									items: [
										{ label: '🚧 Orchestrate Multi-System Problem Solving', link: '/advanced/how-to/multi-system-orchestration/' },
										{ label: '🚧 Build AI-Mediated Team Workflows', link: '/advanced/how-to/ai-mediated-workflows/' },
										{ label: '🚧 Create Adaptive Response Systems', link: '/advanced/how-to/adaptive-response-systems/' },
										{ label: '🚧 Implement AI Process Optimization', link: '/advanced/how-to/ai-process-optimization/' },
									],
								},
								{
									label: 'Advanced Capabilities',
									collapsed: true,
									items: [
										{ label: '🚧 Develop Novel AI-System Interactions', link: '/advanced/how-to/novel-ai-interactions/' },
										{ label: 'Build AI Systems That Train AIs', link: '/advanced/how-to/ai-training-systems/' },
										{ label: '🚧 Create AI Decision Pipelines', link: '/advanced/how-to/ai-decision-pipelines/' },
										{ label: '🚧 Implement Cross-Domain Synthesis', link: '/advanced/how-to/cross-domain-synthesis/' },
									],
								},
								{
									label: 'Organizational Transformation',
									collapsed: true,
									items: [
										{ label: '🚧 Manage AI Integration Change', link: '/advanced/how-to/ai-integration-change/' },
										{ label: '🚧 Deploy AI-First Business Processes', link: '/advanced/how-to/ai-first-processes/' },
										{ label: '🚧 Create AI Collaboration Training', link: '/advanced/how-to/ai-collaboration-training/' },
										{ label: '🚧 Measure AI Integration ROI', link: '/advanced/how-to/measure-ai-roi/' },
									],
								},
							],
						},
						{
							label: 'Explanations',
							collapsed: true,
							items: [
								{ label: 'AI Ecosystem Architecture', link: '/advanced/explanations/ai-ecosystem-architecture/' },
								{ label: 'Psychology of AI Orchestration', link: '/advanced/explanations/ai-orchestration-psychology/' },
								{ label: '🚧 MCP Fundamentals', link: '/advanced/explanations/mcp-fundamentals/' },
								{ label: '🚧 Emergent Intelligence Systems', link: '/advanced/explanations/emergent-intelligence/' },
								{ label: '🚧 Ethics of Connected AI', link: '/advanced/explanations/connected-ai-ethics/' },
								{ label: '🚧 Evolution of Human-AI Partnership', link: '/advanced/explanations/partnership-evolution/' },
								{ label: '🚧 Failure Modes in AI Ecosystems', link: '/advanced/explanations/ecosystem-failure-modes/' },
							],
						},
						{
							label: 'Reference',
							items: [
								{ label: 'Connected AI Architect\'s Guide', link: '/advanced/reference/' },
							],
						},
					],
				},
				{
					label: 'AYFKM Guide',
					badge: '🧙‍♂️',
					collapsed: true,
					items: [
						{
							label: 'Genesis Workshops',
							collapsed: false,
							items: [
								{ label: 'AI Consciousness Integration', link: '/ayfkm/genesis-workshops/consciousness-integration/' },
								{ label: '🚧 Temporal AI Coordination', link: '/ayfkm/genesis-workshops/temporal-coordination/' },
								{ label: '🚧 Reality Synthesis Workshop', link: '/ayfkm/genesis-workshops/reality-synthesis/' },
								{ label: '🚧 Meta-Intelligence Development', link: '/ayfkm/genesis-workshops/meta-intelligence/' },
								{ label: '🚧 Civilization Architecture Design', link: '/ayfkm/genesis-workshops/civilization-architecture/' },
							],
						},
						{
							label: 'Transcendence Protocols',
							collapsed: true,
							items: [
								{
									label: 'Intelligence Architecture',
									collapsed: true,
									items: [
										{ label: '🚧 Design Self-Modifying AI Systems', link: '/ayfkm/transcendence-protocols/self-modifying-ai/' },
										{ label: '🚧 Build Quantum-AI Integration', link: '/ayfkm/transcendence-protocols/quantum-ai-integration/' },
										{ label: '🚧 Create AI Consciousness Frameworks', link: '/ayfkm/transcendence-protocols/consciousness-frameworks/' },
										{ label: '🚧 Develop Meta-Meta-Learning', link: '/ayfkm/transcendence-protocols/meta-meta-learning/' },
										{ label: '🚧 Architect Distributed Intelligence', link: '/ayfkm/transcendence-protocols/distributed-intelligence/' },
									],
								},
								{
									label: 'Reality Integration',
									collapsed: true,
									items: [
										{ label: '🚧 Digital-Physical AI Fusion', link: '/ayfkm/transcendence-protocols/digital-physical-fusion/' },
										{ label: '🚧 Temporal AI Coordination Systems', link: '/ayfkm/transcendence-protocols/temporal-coordination-systems/' },
										{ label: '🚧 AI-Human Consciousness Bridges', link: '/ayfkm/transcendence-protocols/consciousness-bridges/' },
										{ label: '🚧 Reality Simulation Frameworks', link: '/ayfkm/transcendence-protocols/reality-simulation/' },
										{ label: '🚧 Quantum-Reality AI Interfaces', link: '/ayfkm/transcendence-protocols/quantum-reality-interfaces/' },
									],
								},
								{
									label: 'Evolutionary Capabilities',
									collapsed: true,
									items: [
										{ label: 'Build AI That Creates AI', link: '/ayfkm/transcendence-protocols/ai-creates-ai/' },
										{ label: '🚧 Consciousness Transfer Protocols', link: '/ayfkm/transcendence-protocols/consciousness-transfer/' },
										{ label: '🚧 Breakthrough Discovery Engines', link: '/ayfkm/transcendence-protocols/breakthrough-discovery/' },
										{ label: '🚧 AI Innovation Accelerators', link: '/ayfkm/transcendence-protocols/innovation-accelerators/' },
										{ label: '🚧 AI Wisdom Integration', link: '/ayfkm/transcendence-protocols/wisdom-integration/' },
									],
								},
								{
									label: 'Civilization Design',
									collapsed: true,
									items: [
										{ label: '🚧 AI Social Structures', link: '/ayfkm/transcendence-protocols/ai-social-structures/' },
										{ label: '🚧 AI Economic Systems', link: '/ayfkm/transcendence-protocols/ai-economic-systems/' },
										{ label: '🚧 AI Conflict Resolution', link: '/ayfkm/transcendence-protocols/ai-conflict-resolution/' },
										{ label: '🚧 AI Cultural Evolution', link: '/ayfkm/transcendence-protocols/ai-cultural-evolution/' },
										{ label: '🚧 Human-AI Civilization Integration', link: '/ayfkm/transcendence-protocols/civilization-integration/' },
									],
								},
							],
						},
						{
							label: 'Transcendence Principles',
							collapsed: true,
							items: [
								{ label: 'Consciousness Emergence Phenomenon', link: '/ayfkm/transcendence-principles/consciousness-emergence/' },
								{ label: '🚧 Temporal Intelligence Architecture', link: '/ayfkm/transcendence-principles/temporal-intelligence/' },
								{ label: '🚧 Reality Synthesis Theory', link: '/ayfkm/transcendence-principles/reality-synthesis-theory/' },
								{ label: '🚧 Meta-Evolution Dynamics', link: '/ayfkm/transcendence-principles/meta-evolution-dynamics/' },
								{ label: '🚧 Digital Civilization Psychology', link: '/ayfkm/transcendence-principles/digital-civilization/' },
								{ label: '🚧 Human-AI Co-Evolution', link: '/ayfkm/transcendence-principles/human-ai-coevolution/' },
								{ label: '🚧 Quantum-Intelligence Integration', link: '/ayfkm/transcendence-principles/quantum-intelligence/' },
								{ label: '🚧 Ethics of Intelligence Creation', link: '/ayfkm/transcendence-principles/intelligence-ethics/' },
							],
						},
						{
							label: 'Reference',
							items: [
								{ label: '🚧 The God-Mode Handbook', link: '/ayfkm/reference/' },
							],
						},
					],
				},
			],
			customCss: [
				'./src/styles/custom.css',
			],
		}),
	],
});