aidevops 2.52.1 → 2.53.2

package/.agent/tools/context/context7.md

@@ -1,371 +0,0 @@
----
-description: Real-time library documentation via Context7 MCP
-mode: subagent
-tools:
-  read: true
-  write: false
-  edit: false
-  bash: false
-  glob: true
-  grep: true
-  webfetch: true
-  task: true
----
-
-# Context7 MCP Setup Guide
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- **Purpose**: Real-time access to latest library/framework documentation
-- **Command**: `npx -y @context7/mcp-server@latest`
-- **Built into Augment**: No setup needed, tools available directly
-
-**MCP Tools**:
-- `resolve-library-id("next.js")` → Returns "/vercel/next.js"
-- `get-library-docs("/vercel/next.js")` → Returns documentation
-- `get-library-docs("/vercel/next.js", topic="routing")` → Topic-specific
-- `get-library-docs("/vercel/next.js", tokens=15000)` → More detail
-
-**Common Library IDs**:
-- Frontend: `/vercel/next.js`, `/facebook/react`, `/vuejs/vue`
-- Backend: `/expressjs/express`, `/nestjs/nest`
-- DB/ORM: `/prisma/prisma`, `/supabase/supabase`, `/drizzle-team/drizzle-orm`
-- Tools: `/vitejs/vite`, `/typescript-eslint/typescript-eslint`
-
-**Config Location**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-<!-- AI-CONTEXT-END -->
-
-Context7 MCP provides AI assistants with real-time access to the latest documentation for thousands of development tools, frameworks, and libraries.
-
-## 🎯 **What is Context7 MCP?**
-
-Context7 MCP is a Model Context Protocol server that gives AI assistants access to:
-
-- **Latest documentation** for popular development tools and frameworks
-- **Version-specific** documentation and guides
-- **AI-optimized** content format for better understanding
-- **Real-time updates** as libraries and tools evolve
-- **Comprehensive coverage** of the development ecosystem
-
-## 🚀 **Benefits for AI-Assisted Development**
-
-### **Before Context7 MCP:**
-
-- AI assistants work with **outdated training data**
-- **Guessing** at API changes and new features
-- **Inconsistent** information across different versions
-- **Limited** knowledge of recent tools and updates
-
-### **After Context7 MCP:**
-
-- **Real-time access** to latest documentation
-- **Version-specific** guidance and examples
-- **Accurate** API references and best practices
-- **Comprehensive** coverage of your development stack
-
-## 📦 **Installation & Setup**
-
-### **Prerequisites:**
-
-- **Node.js 18+** installed
-- **npm or npx** available
-- **AI assistant** that supports MCP (Claude Desktop, Cursor, etc.)
-
-### **1. Test Context7 MCP Server:**
-
-```bash
-# Test the server (no installation needed with npx)
-npx -y @context7/mcp-server@latest --help
-
-# This should show the Context7 MCP server help
-```
-
-### **2. Add to Your AI Assistant Configuration:**
-
-#### **For Claude Desktop:**
-
-Edit `~/Library/Application Support/Claude/claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "context7": {
-      "command": "npx",
-      "args": ["-y", "@context7/mcp-server@latest"],
-      "env": {
-        "DEBUG": "false"
-      }
-    }
-  }
-}
-```
-
-#### **For Cursor IDE:**
-
-Create/edit `.cursor/mcp.json` in your project:
-
-```json
-{
-  "mcpServers": {
-    "context7": {
-      "command": "npx",
-      "args": ["-y", "@context7/mcp-server@latest"]
-    }
-  }
-}
-```
-
-#### **For Augment Agent:**
-
-Context7 tools are **built-in** - no additional setup required!
-
-- Use `resolve-library-id` tool to find library IDs
-- Use `get-library-docs` tool to fetch documentation
-
-### **3. Framework Configuration:**
-
-```bash
-# Copy the Context7 MCP configuration template
-cp configs/context7-mcp-config.json.txt configs/context7-mcp-config.json
-
-# Edit with your commonly used libraries and preferences
-```
-
-## 🔧 **Usage Examples**
-
-### **1. Library Resolution:**
-
-```bash
-# Always resolve library names first
-resolve-library-id("next.js")
-# Returns: "/vercel/next.js"
-
-resolve-library-id("react")
-# Returns: "/facebook/react"
-
-resolve-library-id("supabase")
-# Returns: "/supabase/supabase"
-```
-
-### **2. Getting Documentation:**
-
-```bash
-# Get general documentation
-get-library-docs("/vercel/next.js")
-
-# Get topic-specific documentation
-get-library-docs("/vercel/next.js", topic="routing")
-
-# Get version-specific documentation
-get-library-docs("/vercel/next.js/v14.3.0-canary.87")
-
-# Adjust token limits for more/less detail
-get-library-docs("/facebook/react", tokens=10000)
-```
-
-### **3. Common Development Workflows:**
-
-#### **Starting a New Project:**
-
-```bash
-# Get setup documentation for your stack
-resolve-library-id("next.js") -> get-library-docs("/vercel/next.js", topic="getting-started")
-resolve-library-id("tailwind") -> get-library-docs("/tailwindlabs/tailwindcss", topic="installation")
-resolve-library-id("prisma") -> get-library-docs("/prisma/prisma", topic="setup")
-```
-
-#### **Debugging Issues:**
-
-```bash
-# Get troubleshooting guides
-get-library-docs("/vercel/next.js", topic="troubleshooting")
-
-# Check API changes between versions
-get-library-docs("/facebook/react/v18.2.0")
-get-library-docs("/facebook/react/v18.3.0")
-```
-
-#### **Learning New Tools:**
-
-```bash
-# Comprehensive documentation for new library
-resolve-library-id("drizzle-orm") -> get-library-docs("/drizzle-team/drizzle-orm")
-
-# Get examples and best practices
-get-library-docs("/drizzle-team/drizzle-orm", topic="examples")
-```
-
-## 📚 **Common Library Categories**
-
-### **Frontend Frameworks:**
-
-- `/vercel/next.js` - Next.js React framework
-- `/facebook/react` - React library
-- `/vuejs/vue` - Vue.js framework
-- `/angular/angular` - Angular framework
-- `/sveltejs/svelte` - Svelte framework
-
-### **Backend Frameworks:**
-
-- `/expressjs/express` - Express.js for Node.js
-- `/nestjs/nest` - NestJS framework
-- `/fastify/fastify` - Fastify web framework
-- `/django/django` - Django Python framework
-- `/flask/flask` - Flask Python framework
-
-### **Databases & ORMs:**
-
-- `/mongodb/docs` - MongoDB database
-- `/postgres/postgres` - PostgreSQL database
-- `/supabase/supabase` - Supabase platform
-- `/prisma/prisma` - Prisma ORM
-- `/drizzle-team/drizzle-orm` - Drizzle ORM
-
-### **Development Tools:**
-
-- `/microsoft/vscode` - VS Code editor
-- `/typescript-eslint/typescript-eslint` - TypeScript ESLint
-- `/prettier/prettier` - Code formatter
-- `/vitejs/vite` - Vite build tool
-- `/webpack/webpack` - Webpack bundler
-
-### **AI/ML Tools:**
-
-- `/openai/openai-node` - OpenAI Node.js SDK
-- `/anthropic/anthropic-sdk-typescript` - Anthropic TypeScript SDK
-- `/langchain-ai/langchainjs` - LangChain JavaScript
-- `/huggingface/transformers.js` - Hugging Face Transformers
-
-## 🛠️ **Best Practices**
-
-### **Library Resolution:**
-
-1. **Always resolve first**: Use `resolve-library-id` before `get-library-docs`
-2. **Use specific names**: "next.js" is better than "nextjs"
-3. **Check alternatives**: Some libraries have multiple valid IDs
-4. **Cache results**: Store resolved IDs for repeated use
-
-### **Documentation Retrieval:**
-
-1. **Use topics**: Specify topics for focused results (`topic="routing"`)
-2. **Manage tokens**: Adjust token limits based on detail needed
-3. **Version-specific**: Use specific versions when working with older code
-4. **Combine sources**: Get docs from multiple related libraries
-
-### **Development Workflow:**
-
-1. **Start with docs**: Get documentation before coding
-2. **Reference during development**: Keep docs accessible while coding
-3. **Check for updates**: Regularly verify you're using latest practices
-4. **Validate approaches**: Use docs to verify your implementation approach
-
-## 🔍 **Troubleshooting**
-
-### **Common Issues:**
-
-#### **Library Not Found:**
-
-```bash
-# Try different variations
-resolve-library-id("nextjs")      # Try without dots
-resolve-library-id("next")        # Try shortened name
-resolve-library-id("vercel/next") # Try with org prefix
-```
-
-#### **Documentation Seems Outdated:**
-
-```bash
-# Check for specific version
-get-library-docs("/vercel/next.js/v14.0.0")
-
-# Verify library has moved or been renamed
-resolve-library-id("new-library-name")
-```
-
-#### **MCP Server Not Responding:**
-
-```bash
-# Test the server directly
-npx -y @context7/mcp-server@latest --version
-
-# Check your AI assistant's MCP configuration
-# Restart your AI assistant
-```
-
-## 🎯 **Integration with Your Workflow**
-
-### **Project Setup:**
-
-```bash
-# Create project-specific library list
-echo '["next.js", "tailwind", "prisma", "supabase"]' > .context7-libraries
-
-# Get setup docs for all libraries
-for lib in $(cat .context7-libraries); do
-  resolve-library-id("$lib") && get-library-docs(result, topic="setup")
-done
-```
-
-### **Code Review:**
-
-- **Verify best practices** against latest documentation
-- **Check for deprecated** APIs and patterns
-- **Reference migration guides** for version updates
-- **Validate security practices** with official guidelines
-
-### **Learning & Development:**
-
-- **Explore new libraries** with comprehensive documentation
-- **Understand breaking changes** between versions
-- **Learn best practices** from official examples
-- **Stay updated** with latest features and improvements
-
-## 🌟 **Advanced Features**
-
-### **Version-Specific Documentation:**
-
-```bash
-# Get docs for specific version
-get-library-docs("/vercel/next.js/v13.5.0")
-
-# Compare between versions
-get-library-docs("/react-router/react-router/v5.3.0")
-get-library-docs("/react-router/react-router/v6.0.0")
-```
-
-### **Topic-Focused Queries:**
-
-```bash
-# Get specific topic documentation
-get-library-docs("/vercel/next.js", topic="api-routes")
-get-library-docs("/prisma/prisma", topic="migrations")
-get-library-docs("/supabase/supabase", topic="authentication")
-```
-
-### **Token Management:**
-
-```bash
-# Brief overview (default: 5000 tokens)
-get-library-docs("/facebook/react")
-
-# Detailed documentation (more tokens)
-get-library-docs("/facebook/react", tokens=15000)
-
-# Quick reference (fewer tokens)
-get-library-docs("/facebook/react", tokens=2000)
-```
-
-## 📈 **Benefits for Your Development**
-
-✅ **Always Current** - Documentation is continuously updated
-✅ **Version Aware** - Access docs for specific versions you're using
-✅ **AI Optimized** - Content formatted for better AI understanding
-✅ **Comprehensive** - Covers thousands of popular development tools
-✅ **Fast Access** - Real-time retrieval without manual searching
-✅ **Context Aware** - AI understands your specific development context
-
----
-
-**Transform your AI-assisted development with real-time access to the latest documentation!** 🚀📚

package/.agent/tools/context/dspy.md

@@ -1,302 +0,0 @@
----
-description: DSPy framework for programmatic LLM optimization
-mode: subagent
-tools:
-  read: true
-  write: false
-  edit: false
-  bash: true
-  glob: true
-  grep: true
-  webfetch: true
-  task: true
----
-
-# DSPy Integration Guide
-
-<!-- AI-CONTEXT-START -->
-
-## Quick Reference
-
-- DSPy: Framework for algorithmically optimizing LLM prompts and weights
-- Requires: Python 3.8+, OpenAI/Anthropic API key
-- Helper: `./.agent/scripts/dspy-helper.sh install|test|init [project]`
-- Config: `configs/dspy-config.json` (copy from .txt template)
-- Projects: `data/dspy/[project-name]/`
-- Virtual env: `python-env/dspy-env/`
-- Key classes: Signature (define I/O), Module (logic), ChainOfThought (reasoning)
-- Optimizers: BootstrapFewShot (few-shot), COPRO (iterative), MIPRO (multi-stage)
-- API keys: Uses env vars `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`
-<!-- AI-CONTEXT-END -->
-
-## Overview
-
-DSPy (Declarative Self-improving Python) is a framework for algorithmically optimizing LM prompts and weights. This integration provides seamless access to DSPy's powerful prompt optimization capabilities within the AI DevOps Framework.
-
-## 🚀 **Quick Start**
-
-### **Prerequisites**
-
-- Python 3.8+ installed
-- Virtual environment support
-- OpenAI API key (or other LLM provider)
-
-### **Installation**
-
-```bash
-# Install DSPy dependencies
-./.agent/scripts/dspy-helper.sh install
-
-# Test installation
-./.agent/scripts/dspy-helper.sh test
-```
-
-### **Configuration**
-
-1. **Copy configuration template:**
-
-   ```bash
-   cp configs/dspy-config.json.txt configs/dspy-config.json
-   ```
-
-2. **Edit configuration:**
-
-   ```bash
-   # Add your API keys and customize settings
-   nano configs/dspy-config.json
-   ```
-
-3. **Set environment variables (if not already set):**
-
-   ```bash
-   # DSPy automatically uses your terminal session's API keys
-   export OPENAI_API_KEY="your-api-key-here"
-   export ANTHROPIC_API_KEY="your-anthropic-key-here"
-
-   # Check current environment
-   echo $OPENAI_API_KEY
-   ```
-
-   **Note**: DSPy prioritizes environment variables over config file values, so your existing terminal session API keys will be used automatically!
-
-## 📁 **Project Structure**
-
-```text
-aidevops/
-├── .agent/scripts/dspy-helper.sh          # DSPy management script
-├── configs/dspy-config.json          # DSPy configuration
-├── python-env/dspy-env/              # Python virtual environment
-├── data/dspy/                        # DSPy projects and datasets
-├── logs/                             # DSPy logs
-└── requirements.txt                  # Python dependencies
-```
-
-## 🛠️ **Usage**
-
-### **Initialize New Project**
-
-```bash
-# Create a new DSPy project
-./.agent/scripts/dspy-helper.sh init my-chatbot
-
-# Navigate to project directory
-cd data/dspy/my-chatbot
-```
-
-### **Basic DSPy Example**
-
-```python
-import dspy
-import os
-
-# Configure DSPy with OpenAI
-lm = dspy.OpenAI(model="gpt-3.5-turbo", api_key=os.getenv("OPENAI_API_KEY"))
-dspy.settings.configure(lm=lm)
-
-# Define a signature
-class BasicQA(dspy.Signature):
-    """Answer questions with helpful, accurate responses."""
-    question = dspy.InputField()
-    answer = dspy.OutputField(desc="A helpful and accurate answer")
-
-# Create a module
-class QAModule(dspy.Module):
-    def **init**(self):
-        super().**init**()
-        self.generate_answer = dspy.ChainOfThought(BasicQA)
-
-    def forward(self, question):
-        return self.generate_answer(question=question)
-
-# Use the module
-qa = QAModule()
-result = qa(question="What is DSPy?")
-print(result.answer)
-```
-
-### **Optimization Example**
-
-```python
-import dspy
-from dspy.teleprompt import BootstrapFewShot
-
-# Define training data
-trainset = [
-    dspy.Example(question="What is AI?", answer="Artificial Intelligence..."),
-    dspy.Example(question="How does ML work?", answer="Machine Learning..."),
-    # Add more examples
-]
-
-# Create and compile optimizer
-teleprompter = BootstrapFewShot(metric=dspy.evaluate.answer_exact_match)
-compiled_qa = teleprompter.compile(QAModule(), trainset=trainset)
-
-# Use optimized module
-result = compiled_qa(question="Explain neural networks")
-```
-
-## 🔧 **Configuration Options**
-
-### **Language Models**
-
-```json
-{
-  "language_models": {
-    "providers": {
-      "openai": {
-        "api_key": "YOUR_OPENAI_API_KEY",
-        "models": {
-          "gpt-4": "gpt-4",
-          "gpt-3.5-turbo": "gpt-3.5-turbo"
-        }
-      },
-      "anthropic": {
-        "api_key": "YOUR_ANTHROPIC_API_KEY",
-        "models": {
-          "claude-3-sonnet": "claude-3-sonnet-20240229"
-        }
-      }
-    }
-  }
-}
-```
-
-### **Optimization Settings**
-
-```json
-{
-  "optimization": {
-    "optimizers": {
-      "BootstrapFewShot": {
-        "max_bootstrapped_demos": 4,
-        "max_labeled_demos": 16
-      },
-      "COPRO": {
-        "metric": "accuracy",
-        "breadth": 10,
-        "depth": 3
-      }
-    }
-  }
-}
-```
-
-## 📊 **Available Optimizers**
-
-### **BootstrapFewShot**
-
-- **Purpose**: Automatically generate few-shot examples
-- **Best for**: General prompt optimization
-- **Configuration**: `max_bootstrapped_demos`, `max_labeled_demos`
-
-### **COPRO (Coordinate Ascent)**
-
-- **Purpose**: Iterative prompt optimization
-- **Best for**: Complex reasoning tasks
-- **Configuration**: `metric`, `breadth`, `depth`
-
-### **MIPRO (Multi-Prompt Optimization)**
-
-- **Purpose**: Multi-stage prompt optimization
-- **Best for**: Multi-step reasoning
-- **Configuration**: `metric`, `num_candidates`
-
-## 🎯 **Best Practices**
-
-### **1. Start Simple**
-
-```python
-# Begin with basic signatures
-class SimpleQA(dspy.Signature):
-    question = dspy.InputField()
-    answer = dspy.OutputField()
-```
-
-### **2. Use Quality Training Data**
-
-```python
-# Provide diverse, high-quality examples
-trainset = [
-    dspy.Example(question="...", answer="...").with_inputs('question'),
-    # More examples with clear input/output patterns
-]
-```
-
-### **3. Choose Appropriate Metrics**
-
-```python
-# Define custom metrics for your use case
-def custom_metric(example, pred, trace=None):
-    return example.answer.lower() in pred.answer.lower()
-```
-
-### **4. Iterate and Refine**
-
-```python
-# Test different optimizers and configurations
-optimizers = [
-    BootstrapFewShot(metric=custom_metric),
-    COPRO(metric=custom_metric, breadth=5),
-]
-```
-
-## 🔍 **Troubleshooting**
-
-### **Common Issues**
-
-1. **Import Errors**
-
-   ```bash
-   # Ensure virtual environment is activated
-   source python-env/dspy-env/bin/activate
-   ```
-
-2. **API Key Issues**
-
-   ```bash
-   # Check environment variables
-   echo $OPENAI_API_KEY
-   ```
-
-3. **Memory Issues**
-
-   ```python
-   # Reduce batch sizes for large datasets
-   dspy.settings.configure(lm=lm, max_tokens=1000)
-   ```
-
-## 📚 **Additional Resources**
-
-- [DSPy Documentation](https://dspy-docs.vercel.app/)
-- [DSPy GitHub Repository](https://github.com/stanfordnlp/dspy)
-- [DSPy Paper](https://arxiv.org/abs/2310.03714)
-- [AI DevOps Framework Documentation](../README.md)
-
-## 🤝 **Integration with AI DevOps**
-
-DSPy integrates seamlessly with other AI DevOps Framework components:
-
-- **Agno Integration**: Use DSPy-optimized prompts in Agno agents
-- **Quality Control**: Optimize prompts for better code quality analysis
-- **Documentation**: Generate optimized prompts for documentation tasks
-- **Server Management**: Create optimized prompts for infrastructure tasks