# Interactive Guides and Quick Reference (v3.3.0)\n\n## 🚀 Guide System Added (2025-09-30)\n\nA comprehensive interactive guide system providing copy-paste ready commands and step-by-step walkthroughs.\n\n## Available Guides\n\n**Quick Reference:**\n\n- `provisioning sc` - Quick command reference (fastest, no pager)\n- `provisioning guide quickstart` - Full command reference with examples\n\n**Step-by-Step Guides:**\n\n- `provisioning guide from-scratch` - Complete deployment from zero to production\n- `provisioning guide update` - Update existing infrastructure safely\n- `provisioning guide customize` - Customize with layers and templates\n\n**List All Guides:**\n\n- `provisioning guide list` - Show all available guides\n- `provisioning howto` - Same as guide list (shortcut)\n\n## Guide Features\n\n- **Copy-Paste Ready**: All commands include placeholders you can adjust\n- **Complete Examples**: Full workflows from start to finish\n- **Best Practices**: Production-ready patterns and recommendations\n- **Troubleshooting**: Common issues and solutions included\n- **Shortcuts Reference**: Comprehensive shortcuts for fast operations\n- **Beautiful Rendering**: Uses `glow`, `bat`, or `less` for formatted display\n\n## Recommended Setup\n\nFor best viewing experience, install `glow` (markdown terminal renderer):\n\n```\n# macOS\nbrew install glow\n\n# Ubuntu/Debian\napt install glow\n\n# Fedora\ndnf install glow\n\n# Using Go\ngo install github.com/charmbracelet/glow@latest\n```\n\n**Without glow**: Guides fallback to `bat` (syntax highlighting) or `less` (pagination).\n**All systems**: Basic pagination always works, even without external tools.\n\n## Quick Start with Guides\n\n```\n# Show quick reference (fastest)\nprovisioning sc\n\n# Show full command reference\nprovisioning guide quickstart\n\n# Step-by-step deployment\nprovisioning guide from-scratch\n\n# Update infrastructure\nprovisioning guide update\n\n# Customize with layers\nprovisioning guide customize\n\n# List all guides\nprovisioning guide list\n```\n\n## Guide Content\n\n**Quick Reference** (`provisioning sc`)\n\n- Condensed command reference (fastest access)\n- Essential shortcuts and commands\n- Common flags and operations\n- No pager, instant display\n\n**Quickstart Guide** (`docs/guides/quickstart-cheatsheet.md`)\n\n- Complete shortcuts reference (80+ mappings)\n- Copy-paste command examples\n- Common workflows (deploy, update, customize)\n- Debug and check mode examples\n- Output format options\n\n**From Scratch Guide** (`docs/guides/from-scratch.md`)\n\n- Prerequisites and setup\n- Workspace initialization\n- Module discovery and configuration\n- Server deployment\n- Task service installation\n- Cluster creation\n- Verification steps\n\n**Update Guide** (`docs/guides/update-infrastructure.md`)\n\n- Check for updates\n- Update strategies (in-place, rolling, blue-green)\n- Task service updates\n- Database migrations\n- Rollback procedures\n- Post-update verification\n\n**Customize Guide** (`docs/guides/customize-infrastructure.md`)\n\n- Layer system explained (Core → Workspace → Infrastructure)\n- Using templates\n- Creating custom modules\n- Configuration inheritance\n- Advanced customization patterns\n\n## Access from Help System\n\nThe guide system is integrated into the help system:\n\n```\n# Show guide help\nprovisioning help guides\n\n# Help topic access\nprovisioning help guide\nprovisioning help howto\n```\n\n## Guide Shortcuts\n\n| Full Command | Shortcuts |\n| -------------- | ----------- |\n| `sc` | - (quick reference, fastest) |\n| `guide` | `guides` |\n| `guide quickstart` | `shortcuts`, `quick` |\n| `guide from-scratch` | `scratch`, `start`, `deploy` |\n| `guide update` | `upgrade` |\n| `guide customize` | `custom`, `layers`, `templates` |\n| `guide list` | `howto` |\n\n## Documentation Location\n\nAll guide markdown files are in `guides/`:\n\n- `quickstart-cheatsheet.md` - Quick reference\n- `from-scratch.md` - Complete deployment\n- `update-infrastructure.md` - Update procedures\n- `customize-infrastructure.md` - Customization patterns
