docs: fix documentation for main branch release

- Remove feature branch references from CLI README
- Update installation URLs to use main branch
- Add CLI documentation section to main README
- Add comprehensive examples for CLI usage:
  - API performance analysis
  - Security audits
  - Documentation generation
  - Migration planning
  - Test coverage analysis
  - Architecture review
  - Quick fixes
- Fix markdown linting issues
- Update cursor integration with improved templates

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: avivsinai

.claude/commands/promptcode-ask-expert.md

@@ -133,94 +133,3 @@ After recent changes:
 - All tests pass - run with `cd packages/cli && bun test`
 - To release: Create a tag and push to trigger GitHub Actions
 - DO NOT make shortcuts, always use the most idiomatic and generic solution
-
-<!-- PROMPTCODE-CLI-START -->
-# PromptCode CLI Integration
-
-This project has PromptCode CLI integrated for AI-assisted code analysis. The CLI provides structured access to the codebase through presets and intelligent commands.
-
-## Available Claude Commands
-
-The following commands are available to help you work with this codebase:
-
-- `/promptcode-preset-list` - List all available code presets
-- `/promptcode-preset-info <name>` - Show details and token count for a preset
-- `/promptcode-preset-create <description>` - Create a new preset from description
-- `/promptcode-preset-to-prompt <preset>` - Export preset to a file
-- `/promptcode-ask-expert <question>` - Consult AI expert (or ensemble of experts) with code context
-
-## Quick Examples
-
-```bash
-# See what presets are available
-/promptcode-preset-list
-
-# Get details about a specific preset
-/promptcode-preset-info auth-system
-
-# Create a preset for a feature
-/promptcode-preset-create authentication and authorization system
-
-# Ask an expert about the code
-/promptcode-ask-expert How does the authentication flow work?
-```
-
-## Direct CLI Usage
-
-For simple operations, you can also use the CLI directly:
-
-```bash
-# Generate a prompt from files
-promptcode generate -f "src/**/*.ts" -o analysis.txt
-
-# Quick expert consultation (requires API key)
-promptcode expert "Find security issues" --preset api --yes
-
-# View preset information with JSON output
-promptcode preset info backend --json
-```
-
-## Ensemble Experts Mode
-
-The `/promptcode-ask-expert` command supports running multiple AI models in parallel:
-
-```bash
-# Ensemble mode activates when requesting 2+ models
-/promptcode-ask-expert Compare approaches using o3 and gpt-5
-/promptcode-ask-expert Analyze with o3, gemini-2.5-pro, and sonnet-4
-```
-
-**Features:**
-
-- Runs 2-4 models in parallel with same question
-- Synthesizes results showing consensus and unique insights
-- Compares cost, speed, and quality across models
-- Identifies best value and most comprehensive answers
-
-## Configuration
-
-Set API keys via environment variables for expert consultations:
-```bash
-export OPENAI_API_KEY=sk-...      # For O3/O3-pro models
-export ANTHROPIC_API_KEY=sk-...   # For Claude models
-export GOOGLE_API_KEY=...         # For Gemini models
-export XAI_API_KEY=...            # For Grok models
-```
-
-## Cost Protection
-
-The expert command has built-in cost protection:
-
-- Operations over $0.50 require explicit approval
-- Premium models (e.g., o3-pro) always require confirmation
-- Use `--yes` flag only after getting user approval
-
-<details>
-<summary>⚠️ Troubleshooting</summary>
-
-• **Command not found** – The CLI auto-installs to `~/.local/bin`. Ensure it's in PATH  
-• **Missing API key** – Set environment variables as shown above  
-• **Context too large** – Use more specific file patterns or focused presets  
-• **Preset not found** – Check `.promptcode/presets/` directory exists
-</details>
-<!-- PROMPTCODE-CLI-END -->