lua-cli 3.0.0-alpha.1 → 3.0.0-alpha.5

package/GETTING_STARTED.md

@@ -1,1040 +0,0 @@
-# Getting Started with Lua CLI
-
-Welcome! This guide will get you from zero to your first deployed AI skill in minutes.
-
----
-
-## 🚀 Quick Start (5 Minutes)
-
-```bash
-# 1. Install the CLI
-npm install -g lua-cli
-
-# 2. Set up authentication
-lua auth configure
-# Choose "Email" and follow prompts
-
-# 3. Create your first skill
-mkdir my-first-skill && cd my-first-skill
-lua init
-# Choose "Create new agent" and follow prompts
-
-# 4. Test it locally
-lua test
-# Select a tool and try it out
-
-# 5. Start development mode
-lua dev
-# Chat with your AI at http://localhost:3000
-```
-
-**Congratulations! You now have a working AI skill!** 🎉
-
----
-
-## 📚 What You Need to Know
-
-### Core Concepts
-
-**Lua** is a platform for building AI agents with custom capabilities. Think of it like:
-
-```
-AI Agent (ChatGPT-like)
-    └── Skills (Custom capabilities you build)
-        └── Tools (Specific functions the AI can call)
-```
-
-**Example:**
-- **Agent**: "CoffeeBot" - Your coffee shop's AI assistant
-- **Skill**: "Coffee Shop Skill" - What your AI can do
-- **Tools**: 
-  - `show_menu` - Display menu items
-  - `create_order` - Take customer orders
-  - `check_loyalty` - Check rewards points
-
-### How It Works
-
-1. **You build tools** - Functions that do specific things
-2. **You create a skill** - Collection of related tools
-3. **The AI calls your tools** - When users ask questions
-4. **Your tools return data** - The AI uses this to respond
-
----
-
-## 🎯 Your First Hour
-
-### Part 1: Setup (10 minutes)
-
-#### Install CLI
-
-```bash
-npm install -g lua-cli
-```
-
-#### Authenticate
-
-```bash
-lua auth configure
-```
-
-Choose **Email** option:
-1. Enter your email
-2. Check email for 6-digit code
-3. Enter the code
-4. Done! API key automatically generated and saved
-
----
-
-### Part 2: Create Project (15 minutes)
-
-#### Initialize
-
-```bash
-mkdir weather-skill
-cd weather-skill
-lua init
-```
-
-**Prompts:**
-1. **What would you like to do?** → "Create new agent"
-2. **Enter business name:** → "My Weather Service"
-3. **Enter agent name:** → "WeatherBot"
-4. **Select business type:** → "Personal services"
-5. **Select brand personality:** → "Friendly"
-6. **Enter brand traits:** → "Helpful and informative"
-
-**What happens:**
-- Agent created on Lua platform
-- Template project copied
-- Dependencies installed
-- `lua.skill.yaml` configured
-- Ready to customize!
-
----
-
-### Part 3: Explore the Template (15 minutes)
-
-#### Open in Your Editor
-
-```bash
-code .  # VS Code
-# or
-open .  # Finder/Explorer
-```
-
-#### Key Files to Explore
-
-**1. `src/index.ts`** - Your skills definition
-```typescript
-const generalSkill = new LuaSkill({
-  name: "general-skill",
-  description: "...",
-  context: "...",
-  tools: [
-    new GetWeatherTool(),
-    // Add more tools here
-  ]
-});
-```
-
-**2. `src/tools/GetWeatherTool.ts`** - Example tool
-```typescript
-export default class GetWeatherTool implements LuaTool {
-  name = "get_weather";
-  description = "Get weather for a city";
-  inputSchema = z.object({ city: z.string() });
-  
-  async execute(input: any) {
-    // Calls weather API
-    return { temperature, condition, city };
-  }
-}
-```
-
-**3. `lua.skill.yaml`** - Configuration (auto-managed)
-```yaml
-agent:
-  agentId: agent_abc123
-  orgId: org_xyz789
-```
-
----
-
-### Part 4: Test Your Skill (10 minutes)
-
-#### Test Individual Tools
-
-```bash
-lua test
-```
-
-1. Select a tool (e.g., "get_weather")
-2. Enter inputs (e.g., city: "London")
-3. See the results!
-
-**Example:**
-```bash
-$ lua test
-? Select a tool to test: get_weather - Get the weather for a given city
-? city (required): London
-
-🚀 Executing tool...
-✅ Tool execution successful!
-Output: {
-  "city": "London",
-  "temperature": 15.2,
-  "windSpeed": 12.3
-}
-```
-
-#### Test Conversationally
-
-```bash
-lua dev
-```
-
-Browser opens at http://localhost:3000
-
-**Try these in the chat:**
-- "What's the weather in London?"
-- "Show me all products"
-- "Create a shopping basket"
-- "Add product XYZ to my basket"
-
----
-
-### Part 5: Make It Yours (10 minutes)
-
-#### Customize the Weather Tool
-
-Edit `src/tools/GetWeatherTool.ts`:
-
-```typescript
-async execute(input: z.infer<typeof this.inputSchema>) {
-  const { city } = input;
-  
-  // Add your custom logic
-  const weather = await this.getWeather(city);
-  
-  // Return your custom format
-  return {
-    city: city,
-    temperature: weather.temp,
-    condition: weather.description,
-    recommendation: this.getRecommendation(weather.temp)
-  };
-}
-
-private getRecommendation(temp: number): string {
-  if (temp < 10) return "Bring a jacket! ��️";
-  if (temp < 20) return "Perfect weather! ☀️";
-  return "Stay cool! 🥵";
-}
-```
-
-#### Update the Skill Context
-
-Edit `src/index.ts`:
-
-```typescript
-const weatherSkill = new LuaSkill({
-  name: "weather-skill",
-  version: "1.0.0",
-  description: "Smart weather assistant with recommendations",
-  context: `
-    Use get_weather when users ask about weather.
-    Always include clothing recommendations based on temperature.
-    Mention wind conditions if windy (>20 km/h).
-  `,
-  tools: [new GetWeatherTool()]
-});
-```
-
----
-
-## 🛠️ Building Common Skills
-
-### Recipe 1: Knowledge Base Skill
-
-**Use Case**: Company FAQ, documentation search
-
-**Tools Needed:**
-- `search_knowledge` - Search documentation
-- `create_article` - Add new articles
-- `update_article` - Update existing
-
-**APIs Used:** `Data` (vector search)
-
-**Implementation:**
-```typescript
-export class SearchKnowledgeTool implements LuaTool {
-  name = "search_knowledge";
-  description = "Search company knowledge base";
-  inputSchema = z.object({ query: z.string() });
-
-  async execute(input: any) {
-    const results = await Data.search('kb_articles', input.query, 5, 0.75);
-    
-    return {
-      articles: results.data.map(entry => ({
-        title: entry.data.title,
-        content: entry.data.content,
-        category: entry.data.category,
-        relevance: entry.score
-      }))
-    };
-  }
-}
-```
-
----
-
-### Recipe 2: E-commerce Assistant
-
-**Use Case**: Product search, shopping cart, checkout
-
-**Tools Needed:**
-- `search_products`
-- `add_to_cart`
-- `view_cart`
-- `checkout`
-
-**APIs Used:** `Products`, `Baskets`, `Orders`
-
-**Skill Definition:**
-```typescript
-const ecommerceSkill = new LuaSkill({
-  name: "ecommerce-skill",
-  version: "1.0.0",
-  description: "Complete shopping experience from browse to checkout",
-  context: `
-    Help users shop efficiently.
-    
-    Flow:
-    1. search_products - When users describe what they want
-    2. add_to_cart - When they decide to buy
-    3. view_cart - To review items before checkout
-    4. checkout - To complete purchase
-    
-    Always confirm items before adding to cart.
-    Show total price before checkout.
-    Ask about gift wrapping for orders > $50.
-  `,
-  tools: [
-    new SearchProductsTool(),
-    new AddToCartTool(),
-    new ViewCartTool(),
-    new CheckoutTool()
-  ]
-});
-```
-
----
-
-### Recipe 3: CRM Assistant
-
-**Use Case**: Customer data management
-
-**Tools Needed:**
-- `find_customer` - Search customers
-- `create_customer` - Add new customer
-- `update_customer` - Update details
-- `get_customer_history` - View interactions
-
-**APIs Used:** `Data` (custom collections)
-
-**Collections:**
-- `customers` - Customer profiles
-- `interactions` - Interaction history
-- `notes` - Sales notes
-
----
-
-### Recipe 4: Booking System
-
-**Use Case**: Appointments, reservations
-
-**Tools Needed:**
-- `check_availability`
-- `create_booking`
-- `cancel_booking`
-- `list_bookings`
-
-**APIs Used:** `Data` (bookings collection)
-
----
-
-## 📖 Learning Path
-
-### Day 1: Basics
-- ✅ Install CLI
-- ✅ Run `lua init`
-- ✅ Explore template
-- ✅ Run `lua test`
-- ✅ Run `lua dev`
-
-### Day 2: Customization
-- ✅ Modify a template tool
-- ✅ Update skill context
-- ✅ Test changes
-- ✅ Understand data flow
-
-### Day 3: Build Your Own
-- ✅ Create a custom tool
-- ✅ Integrate external API
-- ✅ Add environment variables
-- ✅ Test thoroughly
-
-### Day 4: Deploy
-- ✅ Refine tool descriptions
-- ✅ Improve error handling
-- ✅ Push to server
-- ✅ Deploy to production
-
----
-
-## 🎓 Key Concepts Deep Dive
-
-### Tools vs Skills
-
-**Tool** = Single function
-```typescript
-// One specific thing
-class GetWeatherTool {
-  // Gets weather for a city
-}
-```
-
-**Skill** = Collection of related tools
-```typescript
-// Multiple related things
-new LuaSkill({
-  tools: [
-    new GetWeatherTool(),
-    new GetForecastTool(),
-    new GetAlertsIf Tool()
-  ]
-});
-```
-
----
-
-### Input Schemas (Zod)
-
-Schemas validate and type inputs:
-
-```typescript
-// Simple
-z.object({
-  city: z.string()
-})
-
-// With validation
-z.object({
-  age: z.number().min(0).max(120),
-  email: z.string().email()
-})
-
-// Optional fields
-z.object({
-  required: z.string(),
-  optional: z.string().optional(),
-  withDefault: z.string().default('default value')
-})
-
-// Nested objects
-z.object({
-  user: z.object({
-    name: z.string(),
-    email: z.string().email()
-  }),
-  settings: z.object({
-    notifications: z.boolean()
-  })
-})
-
-// Enums
-z.object({
-  status: z.enum(['pending', 'active', 'completed']),
-  priority: z.enum(['low', 'medium', 'high'])
-})
-```
-
----
-
-### Context Writing
-
-Context guides the AI. Write it like instructions to a smart assistant:
-
-**Template:**
-```
-[What this skill does]
-
-Tool Usage:
-- tool_1: [When to use] [What it returns]
-- tool_2: [When to use] [What it returns]
-
-Guidelines:
-- [Important rules]
-- [Edge cases]
-- [User experience tips]
-```
-
-**Example:**
-```
-This skill manages customer orders for a coffee shop.
-
-Tool Usage:
-- show_menu: Use when customers ask what's available. Returns drinks and food items.
-- create_order: Use when taking an order. Confirm items and sizes first.
-- modify_order: Use to add/remove items. Ask which item to modify.
-- finalize_order: Use when order is confirmed. Returns total and wait time.
-
-Guidelines:
-- Always ask about size for drinks (small/medium/large)
-- Mention daily special when showing menu
-- Confirm total before finalizing
-- Ask about dietary restrictions for food items
-```
-
----
-
-## 💡 Pro Tips
-
-### Tip 1: Start Simple
-
-Don't build everything at once:
-
-**Week 1:** 1-3 core tools  
-**Week 2:** Add 2-3 more tools  
-**Week 3:** Refine based on usage  
-
-### Tip 2: Use the Template
-
-The template includes working examples of:
-- External API calls (`GetWeatherTool`)
-- Platform API usage (`UserDataTool`, `ProductsTool`)
-- Vector search (`CustomDataTool`)
-- E-commerce flow (`BasketTool`, `OrderTool`)
-
-Copy and modify instead of starting from scratch!
-
-### Tip 3: Test in Dev Mode
-
-`lua dev` is your friend:
-- Real-time chat testing
-- Live reload on file changes
-- WebSocket logging
-- Tool testing interface
-
-Use it extensively before deploying!
-
-### Tip 4: Descriptive Names
-
-Good tool names help the AI choose correctly:
-
-✅ `search_products`, `create_order`, `cancel_booking`  
-❌ `do_search`, `make_thing`, `process`
-
-### Tip 5: Detailed Descriptions
-
-```typescript
-// ❌ Weak
-description = "Gets data"
-
-// ✅ Strong
-description = "Retrieves customer order history for the last 30 days"
-```
-
----
-
-## 🔧 Development Workflow
-
-### Recommended Flow
-
-```
-1. Edit tool in src/tools/
-    ↓
-2. Save file (auto-reload in dev mode)
-    ↓
-3. Test in chat interface
-    ↓
-4. Iterate until satisfied
-    ↓
-5. Test with lua test (edge cases)
-    ↓
-6. Push to server
-    ↓
-7. Final testing in sandbox
-    ↓
-8. Deploy to production
-```
-
-### Quick Commands
-
-```bash
-# During development
-lua dev              # Start, leave running
-# Edit files, test in browser, iterate
-
-# When ready to share
-lua push             # Upload version
-lua deploy           # Deploy to production
-
-# For quick local testing
-lua test             # Test individual tools
-```
-
----
-
-## 🎯 Example: Building a Restaurant Skill
-
-Let's build a complete skill from scratch.
-
-### Step 1: Initialize
-
-```bash
-mkdir restaurant-skill
-cd restaurant-skill
-lua init
-```
-
-### Step 2: Plan Your Tools
-
-**What should your AI do?**
-- Show menu
-- Take orders
-- Check order status
-- Make reservations
-
-**Tools needed:**
-1. `show_menu` - Display menu items
-2. `create_order` - Place food order
-3. `check_order` - Get order status
-4. `make_reservation` - Book table
-
-### Step 3: Create Menu Tool
-
-Create `src/tools/MenuTool.ts`:
-
-```typescript
-import { LuaTool, Data } from "lua-cli";
-import { z } from "zod";
-
-export default class ShowMenuTool implements LuaTool {
-  name = "show_menu";
-  description = "Display restaurant menu with prices";
-  
-  inputSchema = z.object({
-    category: z.enum(['appetizers', 'mains', 'desserts', 'drinks']).optional()
-  });
-
-  async execute(input: z.infer<typeof this.inputSchema>) {
-    const filter = input.category ? { category: input.category } : {};
-    const menuItems = await Data.get('menu_items', filter, 1, 50);
-    
-    return {
-      items: menuItems.data.map(item => ({
-        name: item.data.name,
-        description: item.data.description,
-        price: `$${item.data.price}`,
-        category: item.data.category
-      })),
-      count: menuItems.pagination.totalCount
-    };
-  }
-}
-```
-
-### Step 4: Create Order Tool
-
-Create `src/tools/OrderTool.ts`:
-
-```typescript
-import { LuaTool, Data } from "lua-cli";
-import { z } from "zod";
-
-export default class CreateOrderTool implements LuaTool {
-  name = "create_order";
-  description = "Place a food order";
-  
-  inputSchema = z.object({
-    items: z.array(z.object({
-      name: z.string(),
-      quantity: z.number().min(1)
-    })),
-    specialInstructions: z.string().optional()
-  });
-
-  async execute(input: z.infer<typeof this.inputSchema>) {
-    // Get menu items to calculate total
-    const menuData = await Data.get('menu_items');
-    const menu = menuData.data;
-    
-    let total = 0;
-    const orderItems = input.items.map(item => {
-      const menuItem = menu.find(m => m.data.name === item.name);
-      if (!menuItem) {
-        throw new Error(`Menu item not found: ${item.name}`);
-      }
-      
-      const itemTotal = menuItem.data.price * item.quantity;
-      total += itemTotal;
-      
-      return {
-        name: item.name,
-        quantity: item.quantity,
-        price: menuItem.data.price,
-        subtotal: itemTotal
-      };
-    });
-    
-    // Create order
-    const order = await Data.create('orders', {
-      items: orderItems,
-      total,
-      status: 'pending',
-      specialInstructions: input.specialInstructions,
-      orderedAt: new Date().toISOString()
-    });
-    
-    return {
-      orderId: order.id,
-      items: orderItems,
-      total: `$${total.toFixed(2)}`,
-      estimatedTime: '20-30 minutes',
-      message: 'Order placed successfully!'
-    };
-  }
-}
-```
-
-### Step 5: Create Reservation Tool
-
-Create `src/tools/ReservationTool.ts`:
-
-```typescript
-import { LuaTool, Data, User } from "lua-cli";
-import { z } from "zod";
-
-export default class MakeReservationTool implements LuaTool {
-  name = "make_reservation";
-  description = "Book a table at the restaurant";
-  
-  inputSchema = z.object({
-    date: z.string().describe("Date (YYYY-MM-DD)"),
-    time: z.string().describe("Time (HH:MM)"),
-    partySize: z.number().min(1).max(20),
-    name: z.string().optional(),
-    phone: z.string().optional()
-  });
-
-  async execute(input: z.infer<typeof this.inputSchema>) {
-    // Get user info for contact
-    const user = await User.get();
-    
-    const reservation = await Data.create('reservations', {
-      date: input.date,
-      time: input.time,
-      partySize: input.partySize,
-      contactName: input.name || user.name,
-      contactPhone: input.phone || user.phone,
-      status: 'confirmed',
-      createdAt: new Date().toISOString()
-    }, `${input.date} ${input.time} ${input.partySize} people`);
-    
-    return {
-      reservationId: reservation.id,
-      date: input.date,
-      time: input.time,
-      partySize: input.partySize,
-      message: `Reservation confirmed for ${input.partySize} people on ${input.date} at ${input.time}`
-    };
-  }
-}
-```
-
-### Step 6: Update `src/index.ts`
-
-```typescript
-import { LuaSkill } from "lua-cli";
-import ShowMenuTool from "./tools/MenuTool";
-import CreateOrderTool from "./tools/OrderTool";
-import MakeReservationTool from "./tools/ReservationTool";
-
-const restaurantSkill = new LuaSkill({
-  name: "restaurant-skill",
-  version: "1.0.0",
-  description: "Complete restaurant assistant for menu, ordering, and reservations",
-  context: `
-    This skill helps customers interact with the restaurant.
-    
-    Tool Usage:
-    - show_menu: Use when customers ask about food, menu, or what's available
-    - create_order: Use when taking a food order. Confirm items before submitting.
-    - make_reservation: Use for table bookings. Confirm date, time, and party size.
-    
-    Guidelines:
-    - Always mention daily specials when showing menu
-    - Confirm order details and total before submitting
-    - For reservations, verify availability for party size
-    - Be friendly and helpful
-  `,
-  tools: [
-    new ShowMenuTool(),
-    new CreateOrderTool(),
-    new MakeReservationTool()
-  ]
-});
-```
-
-### Step 7: Seed Menu Data
-
-Create `src/seed.ts`:
-
-```typescript
-import { Data } from "lua-cli";
-
-async function seedMenu() {
-  const menuItems = [
-    { name: 'Caesar Salad', category: 'appetizers', price: 8.99, description: 'Fresh romaine lettuce with parmesan' },
-    { name: 'Margherita Pizza', category: 'mains', price: 14.99, description: 'Classic tomato and mozzarella' },
-    { name: 'Tiramisu', category: 'desserts', price: 7.99, description: 'Italian coffee-flavored dessert' },
-    { name: 'Espresso', category: 'drinks', price: 3.50, description: 'Strong Italian coffee' }
-  ];
-  
-  for (const item of menuItems) {
-    await Data.create('menu_items', item, `${item.name} ${item.description}`);
-  }
-  
-  console.log('Menu seeded successfully!');
-}
-
-seedMenu().catch(console.error);
-```
-
-Run once:
-```bash
-npx tsx src/seed.ts
-```
-
-### Step 8: Test!
-
-```bash
-# Test tools individually
-lua test
-
-# Test conversationally
-lua dev
-```
-
-**Try in chat:**
-- "Show me your menu"
-- "I'd like to order a Margherita Pizza and an Espresso"
-- "Book a table for 4 people tomorrow at 7pm"
-
-### Step 9: Deploy
-
-```bash
-# Push to server
-lua push
-
-# Deploy to production
-lua deploy
-```
-
----
-
-## 🎨 Customization Examples
-
-### Customize Return Format
-
-```typescript
-async execute(input: any) {
-  const products = await Products.search(input.query);
-  
-  // Custom formatting for better AI responses
-  return {
-    summary: `Found ${products.data.length} matching products`,
-    topResults: products.data.slice(0, 3).map(p => ({
-      name: p.name,
-      price: `$${p.price}`,
-      description: p.description,
-      availability: p.inStock ? '✅ Available' : '❌ Out of Stock'
-    })),
-    hasMore: products.data.length > 3
-  };
-}
-```
-
-### Add Business Logic
-
-```typescript
-async execute(input: any) {
-  // Validate business rules
-  if (input.age < 18 && input.category === 'alcohol') {
-    throw new Error('Must be 18+ to purchase alcohol');
-  }
-  
-  // Check inventory
-  const product = await Products.getById(input.productId);
-  if (!product.inStock) {
-    return {
-      success: false,
-      message: `Sorry, ${product.name} is currently out of stock`,
-      alternatives: await this.getSimilarProducts(product.category)
-    };
-  }
-  
-  // Process order...
-}
-```
-
-### Add Caching
-
-```typescript
-export default class ExpensiveApiTool implements LuaTool {
-  private cache = new Map<string, any>();
-  
-  async execute(input: any) {
-    const cacheKey = JSON.stringify(input);
-    
-    // Check cache
-    if (this.cache.has(cacheKey)) {
-      return this.cache.get(cacheKey);
-    }
-    
-    // Call API
-    const result = await expensiveApi.call(input);
-    
-    // Cache result
-    this.cache.set(cacheKey, result);
-    
-    return result;
-  }
-}
-```
-
----
-
-## 📂 Template Directory Reference
-
-### Included Examples
-
-| File | Tools | Purpose |
-|------|-------|---------|
-| `GetWeatherTool.ts` | 1 | External API integration |
-| `UserDataTool.ts` | 2 | User data management |
-| `ProductsTool.ts` | 6 | Product CRUD + search |
-| `BasketTool.ts` | 9 | Shopping cart operations |
-| `OrderTool.ts` | 4 | Order management |
-| `CustomDataTool.ts` | 6 | Vector search example |
-| `PaymentTool.ts` | 1 | Payment integration |
-| `CreatePostTool.ts` | 1 | Simple example |
-
-**Total: 30 example tools** covering all major use cases!
-
----
-
-## 🚨 Common Mistakes
-
-### Mistake 1: Unclear Context
-
-❌ **Bad:**
-```typescript
-context: "A skill with tools for stuff"
-```
-
-✅ **Good:**
-```typescript
-context: `
-  Use search_products when users want to find items.
-  Use create_order when they're ready to buy.
-  Always confirm details before creating orders.
-`
-```
-
----
-
-### Mistake 2: Poor Error Handling
-
-❌ **Bad:**
-```typescript
-async execute(input: any) {
-  const result = await api.call(input);
-  return result;  // What if it fails?
-}
-```
-
-✅ **Good:**
-```typescript
-async execute(input: any) {
-  try {
-    const result = await api.call(input);
-    if (!result.success) {
-      throw new Error(result.error || 'API call failed');
-    }
-    return result.data;
-  } catch (error) {
-    throw new Error(`Failed to fetch data: ${error.message}`);
-  }
-}
-```
-
----
-
-### Mistake 3: Hardcoded Values
-
-❌ **Bad:**
-```typescript
-const apiKey = 'sk_abc123';  // Hardcoded!
-```
-
-✅ **Good:**
-```typescript
-import { env } from 'lua-cli';
-const apiKey = env('API_KEY');
-```
-
----
-
-## 🎓 Next Steps
-
-After completing this guide:
-
-1. **Read API Reference** - `API_REFERENCE.md` for detailed API docs
-2. **Read CLI Reference** - `CLI_REFERENCE.md` for all commands
-3. **Explore Examples** - Check all tools in `template/src/tools/`
-4. **Build Something** - Start with a simple skill
-5. **Join Community** - Share your skills and learn from others
-
----
-
-## 📞 Getting Help
-
-- **Documentation**: https://docs.heylua.ai
-- **Examples**: `template/src/tools/` directory
-- **Issues**: https://github.com/lua-ai/lua-cli/issues
-- **Email**: support@lua.ai
-
----
-
-## ✨ You're Ready!
-
-You now know:
-- ✅ How to set up the CLI
-- ✅ How to create a project
-- ✅ How to build tools
-- ✅ How to test locally
-- ✅ How to deploy to production
-- ✅ Best practices and patterns
-
-**Go build something amazing!** 🚀
-
----
-
-**Quick Links:**
-- [CLI Commands](CLI_REFERENCE.md) - All CLI commands
-- [API Reference](API_REFERENCE.md) - Complete API docs
-- [Developer Guide](DEVELOPER_GUIDE.md) - Advanced development
-