adaptive-memory-multi-model-router 1.2.2 → 1.3.1

package/src/skills/TMLPD-QUICKREF.md

@@ -0,0 +1,210 @@
+# TMLPD Quick Reference Guide
+
+## What is TMLPD?
+
+**TreeQuest Multi-LLM Parallel Deployment** - A skill for deploying multiple AI agents in parallel across different LLM providers to accelerate development.
+
+## Quick Start
+
+```bash
+# From any project directory
+cd /path/to/project
+
+# Deploy 4 parallel agents (quick start)
+treequest-parallel --agents=4 --mode=category --background
+
+# Check system status first
+treequest test  # Verify all providers working
+treequest status  # Quick health check
+```
+
+## Common Use Cases
+
+### 1. Brain Spark Project Enhancement
+```bash
+cd ~/brain-spark-analysis-project
+
+# Deploy for testing tasks
+treequest-parallel \
+  --agents=4 \
+  --mode=category \
+  --filter="status=pending,category=testing" \
+  --providers="anthropic,openai,google,groq"
+```
+
+### 2. TaskMaster Integration
+```bash
+# Parse PRD and expand tasks
+task-master parse-prd .taskmaster/docs/prd.txt
+task-master expand --all --research
+
+# Deploy TreeQuest agents
+treequest-parallel --source=taskmaster --agents=5
+```
+
+### 3. Quick Feature Sprint
+```bash
+# Deploy 3 agents for feature implementation
+treequest-parallel \
+  --agents=3 \
+  --focus="implementation" \
+  --timeout=3600 \
+  --budget=25.00
+```
+
+## Configuration Templates
+
+### Copy to Project
+```bash
+# Category-based deployment
+cp ~/.claude/skills/tmlpd-category.yaml ./tmlpd-config.yaml
+
+# Phase-based deployment
+cp ~/.claude/skills/tmlpd-phase.yaml ./tmlpd-config.yaml
+
+# Monitoring only
+cp ~/.claude/skills/tmlpd-monitoring.yaml ./tmlpd-monitoring.yaml
+```
+
+## Monitoring Commands
+
+```bash
+# Real-time status
+treequest-parallel --status
+
+# View logs
+tail -f .tmlpd-output/tmlpd-logs.json
+
+# Check metrics
+treequest-parallel --metrics
+
+# Launch dashboard
+treequest-parallel --dashboard
+```
+
+## Agent Configuration Examples
+
+### Frontend Specialist
+```yaml
+- id: "frontend-agent"
+  provider: "anthropic"
+  model: "claude-sonnet-4"
+  focus: "UI components, styling"
+  tasks: ["task-ui-*"]
+```
+
+### Backend Specialist
+```yaml
+- id: "backend-agent"
+  provider: "openai"
+  model: "gpt-4-turbo"
+  focus: "API, database, logic"
+  tasks: ["task-backend-*"]
+```
+
+### Testing Specialist
+```yaml
+- id: "testing-agent"
+  provider: "google"
+  model: "gemini-2.0-flash"
+  focus: "Tests, validation"
+  tasks: ["task-test-*"]
+```
+
+### Research Specialist
+```yaml
+- id: "research-agent"
+  provider: "perplexity"
+  model: "llama-3.1-sonar-large"
+  focus: "Research, documentation"
+  tasks: ["task-docs-*"]
+```
+
+## Performance Tips
+
+1. **Start with 2-3 agents** - Scale up based on success
+2. **Set budget limits** - Prevent cost overruns
+3. **Use checkpoints** - Enable recovery for long tasks
+4. **Monitor closely** - First deployment needs close watch
+5. **Match models to tasks** - Right tool for the job
+
+## Cost Optimization
+
+| Task Type | Best Provider | Cost (per 1M tokens) |
+|-----------|--------------|---------------------|
+| Simple tests | Groq/Cerebras | $0.10 |
+| Code generation | GPT-4 Turbo | $10.00 |
+| Complex reasoning | Claude Sonnet | $3.00 |
+| Research | Perplexity Sonar | $1.00 |
+| Critical decisions | Claude Opus | $15.00 |
+
+## Troubleshooting
+
+### Agent not starting?
+```bash
+treequest test  # Check provider status
+treequest status  # Check system health
+```
+
+### Merge conflicts?
+```bash
+treequest-parallel --merge-conflicts --strategy=timestamp
+```
+
+### Need to stop?
+```bash
+treequest-parallel --shutdown --graceful
+```
+
+### Resume from checkpoint?
+```bash
+treequest-parallel --resume
+```
+
+## Expected Speedup
+
+- **2 agents:** 1.8x faster (ideal: 2x)
+- **4 agents:** 3.4x faster (ideal: 4x)
+- **6 agents:** 4.8x faster (ideal: 6x)
+
+*Real-world results vary based on task complexity and dependencies*
+
+## Advanced Features
+
+### Dynamic Load Balancing
+```yaml
+coordination:
+  load_balancing: "dynamic"
+  rebalance_interval: 120
+```
+
+### Cost Limits
+```yaml
+cost_optimization:
+  enabled: true
+  budget_limit: 50.00
+```
+
+### Auto-Retry on Failure
+```yaml
+error_handling:
+  retry_policy: "exponential_backoff"
+  max_retries: 3
+```
+
+## Full Documentation
+
+See: `~/.claude/skills/TMLPD.md`
+
+## Support
+
+- **TreeQuest Status:** `treequest status`
+- **Config Check:** `treequest config --show`
+- **Logs:** `~/.treequest/logs/`
+- **Issues:** https://github.com/treequest-ai/issues
+
+---
+
+**Version:** 1.0.0
+**Shortcut:** `/TMLPD`
+**Works from:** Any project directory

package/src/skills/TMLPD-SETUP-SUMMARY.md

@@ -0,0 +1,157 @@
+# TMLPD Skill - Installation Complete ✅
+
+## What Was Created
+
+The **TreeQuest Multi-LLM Parallel Deployment (TMLPD)** skill has been successfully created and is ready to use from any project.
+
+### Created Files
+
+1. **Main Skill Documentation**
+   - `~/.claude/skills/TMLPD.md` (540 lines)
+   - Complete guide with deployment strategies, configurations, and examples
+
+2. **Quick Reference**
+   - `~/.claude/skills/TMLPD-QUICKREF.md` (210 lines)
+   - Fast lookup for common commands and patterns
+
+3. **Configuration Templates**
+   - `~/.claude/skills/tmlpd-category.yaml` - Category-based parallelization
+   - `~/.claude/skills/tmlpd-phase.yaml` - Phase-based parallelization
+   - `~/.claude/skills/tmlpd-monitoring.yaml` - Advanced monitoring setup
+
+4. **Test & Verification**
+   - `~/.claude/skills/test-tmlpd.sh` - Automated verification script
+
+## How to Use
+
+### From Any Project
+
+```bash
+cd /path/to/your-project
+
+# Invoke the skill
+/TMLPD
+
+# Or use TreeQuest directly
+treequest-parallel --agents=4 --mode=category
+```
+
+### Brain Spark Example
+
+```bash
+cd ~/brain-spark-analysis-project
+
+# Copy template
+cp ~/.claude/skills/tmlpd-category.yaml ./tmlpd-config.yaml
+
+# Edit config as needed
+vim tmlpd-config.yaml
+
+# Deploy parallel agents
+treequest-parallel --config=tmlpd-config.yaml --background
+
+# Monitor progress
+treequest-parallel --status
+```
+
+### With TaskMaster
+
+```bash
+cd ~/brain-spark-analysis-project
+
+# Parse PRD and create tasks
+task-master parse-prd .taskmaster/docs/prd.txt
+task-master expand --all --research
+
+# Deploy TreeQuest agents on tasks
+treequest-parallel --source=taskmaster --agents=4
+```
+
+## Key Features
+
+### 3 Deployment Modes
+1. **Category Mode** - Split by task type (frontend, backend, testing, docs)
+2. **Phase Mode** - Execute project phases in parallel
+3. **Verification Mode** - Run tasks on multiple models for consensus
+
+### Multi-Provider Support
+- **Anthropic** (Claude) - Complex reasoning and architecture
+- **OpenAI** (GPT-4) - Code generation and debugging
+- **Google** (Gemini) - Research and documentation
+- **Perplexity** (Llama Sonar) - Web-connected research
+- **Groq/Cerebras** - Fast execution for simple tasks
+
+### Advanced Capabilities
+- Dynamic load balancing
+- Cost optimization with budget limits
+- Error recovery with auto-retry
+- Checkpoint-based resume
+- Real-time monitoring dashboard
+
+## Expected Performance
+
+| Agents | Speedup | Cost Efficiency |
+|--------|---------|-----------------|
+| 2 | 1.8x | High |
+| 4 | 3.4x | Medium |
+| 6 | 4.8x | Low |
+
+## Prerequisites Met
+
+✅ TreeQuest CLI installed
+✅ Configuration file exists
+✅ Multiple providers configured
+✅ Skill files created
+✅ Templates ready to use
+
+## Quick Verification
+
+Run the test script:
+```bash
+~/.claude/skills/test-tmlpd.sh
+```
+
+## Documentation Locations
+
+- **Full Guide:** `~/.claude/skills/TMLPD.md`
+- **Quick Reference:** `~/.claude/skills/TMLPD-QUICKREF.md`
+- **Templates:** `~/.claude/skills/tmlpd-*.yaml`
+- **Test Script:** `~/.claude/skills/test-tmlpd.sh`
+
+## Next Steps
+
+1. **Try it out:**
+   ```bash
+   cd ~/brain-spark-analysis-project
+   /TMLPD
+   ```
+
+2. **Customize a config:**
+   ```bash
+   cp ~/.claude/skills/tmlpd-category.yaml ./tmlpd-config.yaml
+   # Edit for your project needs
+   ```
+
+3. **Deploy parallel agents:**
+   ```bash
+   treequest-parallel --config=tmlpd-config.yaml --background
+   ```
+
+4. **Monitor progress:**
+   ```bash
+   treequest-parallel --status
+   tail -f .tmlpd-output/tmlpd-logs.json
+   ```
+
+## Support
+
+- **TreeQuest Status:** `treequest status`
+- **Config:** `treequest config --show`
+- **Test Providers:** `treequest test`
+- **Full Help:** `/TMLPD`
+
+---
+
+**Installation Date:** 2026-01-01
+**Version:** 1.0.0
+**Status:** ✅ Ready to Use