ag-cortex 0.1.0

package/.agent/skills/dspy-ruby/references/providers.md

@@ -0,0 +1,305 @@
+# DSPy.rb LLM Providers
+
+## Supported Providers
+
+DSPy.rb provides unified support across multiple LLM providers through adapter gems that automatically load when installed.
+
+### Provider Overview
+
+- **OpenAI**: GPT-4, GPT-4o, GPT-4o-mini, GPT-3.5-turbo
+- **Google Gemini**: Gemini 1.5 Pro, Gemini 1.5 Flash, Gemini Ultra
+- **Ollama**: Local model support via OpenAI compatibility layer
+- **OpenRouter**: Unified multi-provider API for 200+ models
+
+## Configuration
+
+### Basic Setup
+
+```ruby
+require 'dspy'
+
+DSPy.configure do |c|
+  c.lm = DSPy::LM.new('provider/model-name', api_key: ENV['API_KEY'])
+end
+```
+
+### OpenAI Configuration
+
+**Required gem**: `dspy-openai`
+
+```ruby
+DSPy.configure do |c|
+  # GPT-4o Mini (recommended for development)
+  c.lm = DSPy::LM.new('openai/gpt-4o-mini', api_key: ENV['OPENAI_API_KEY'])
+
+  # GPT-4o (more capable)
+  c.lm = DSPy::LM.new('openai/gpt-4o', api_key: ENV['OPENAI_API_KEY'])
+
+  # GPT-4 Turbo
+  c.lm = DSPy::LM.new('openai/gpt-4-turbo', api_key: ENV['OPENAI_API_KEY'])
+end
+```
+
+**Environment variable**: `OPENAI_API_KEY`
+
+
+
+### Google Gemini Configuration
+
+**Required gem**: `dspy-gemini`
+
+```ruby
+DSPy.configure do |c|
+  # Gemini 1.5 Pro (most capable)
+  c.lm = DSPy::LM.new('gemini/gemini-1.5-pro',
+    api_key: ENV['GOOGLE_API_KEY'])
+
+  # Gemini 1.5 Flash (faster, cost-effective)
+  c.lm = DSPy::LM.new('gemini/gemini-1.5-flash',
+    api_key: ENV['GOOGLE_API_KEY'])
+end
+```
+
+**Environment variable**: `GOOGLE_API_KEY` or `GEMINI_API_KEY`
+
+### Ollama Configuration
+
+**Required gem**: None (uses OpenAI compatibility layer)
+
+```ruby
+DSPy.configure do |c|
+  # Local Ollama instance
+  c.lm = DSPy::LM.new('ollama/llama3.1',
+    base_url: 'http://localhost:11434')
+
+  # Other Ollama models
+  c.lm = DSPy::LM.new('ollama/mistral')
+  c.lm = DSPy::LM.new('ollama/codellama')
+end
+```
+
+**Note**: Ensure Ollama is running locally: `ollama serve`
+
+### OpenRouter Configuration
+
+**Required gem**: `dspy-openai` (uses OpenAI adapter)
+
+```ruby
+DSPy.configure do |c|
+  # Access 200+ models through OpenRouter
+  c.lm = DSPy::LM.new('openrouter/google/gemini-1.5-pro',
+    api_key: ENV['OPENROUTER_API_KEY'],
+    base_url: 'https://openrouter.ai/api/v1')
+
+  # Other examples
+  c.lm = DSPy::LM.new('openrouter/google/gemini-pro')
+  c.lm = DSPy::LM.new('openrouter/meta-llama/llama-3.1-70b-instruct')
+end
+```
+
+**Environment variable**: `OPENROUTER_API_KEY`
+
+## Provider Compatibility Matrix
+
+### Feature Support
+
+| Feature | OpenAI | Google Gemini | Ollama |
+|---------|--------|-----------|--------|
+| Structued Output | ✅ | ✅ | ✅ |
+| Vision (Images) | ✅ | ✅ | ⚠️ Limited |
+| Image URLs | ✅ | ❌ | ❌ |
+| Tool Calling | ✅ | ✅ | Varies |
+| Streaming | ❌ | ❌ | ❌ |
+| Function Calling | ✅ | ✅ | ✅ | Varies |
+
+**Legend**: ✅ Full support | ⚠️ Partial support | ❌ Not supported
+
+### Vision Capabilities
+
+**Image URLs**: Only OpenAI supports direct URL references. For other providers, load images as base64 or from files.
+
+```ruby
+# OpenAI - supports URLs
+DSPy::Image.from_url("https://example.com/image.jpg")
+
+# Google Gemini - use file or base64
+DSPy::Image.from_file("path/to/image.jpg")
+DSPy::Image.from_base64(base64_data, mime_type: "image/jpeg")
+```
+
+**Ollama**: Limited multimodal functionality. Check specific model capabilities.
+
+## Advanced Configuration
+
+### Custom Parameters
+
+Pass provider-specific parameters during configuration:
+
+```ruby
+DSPy.configure do |c|
+  c.lm = DSPy::LM.new('openai/gpt-4o',
+    api_key: ENV['OPENAI_API_KEY'],
+    temperature: 0.7,
+    max_tokens: 2000,
+    top_p: 0.9
+  )
+end
+```
+
+### Multiple Providers
+
+Use different models for different tasks:
+
+```ruby
+# Fast model for simple tasks
+fast_lm = DSPy::LM.new('openai/gpt-4o-mini', api_key: ENV['OPENAI_API_KEY'])
+
+# Powerful model for complex tasks
+powerful_lm = DSPy::LM.new('google/gemini-1.5-pro',
+  api_key: ENV['GOOGLE_API_KEY'])
+
+# Use different models in different modules
+class SimpleClassifier < DSPy::Module
+  def initialize
+    super
+    DSPy.configure { |c| c.lm = fast_lm }
+    @predictor = DSPy::Predict.new(SimpleSignature)
+  end
+end
+
+class ComplexAnalyzer < DSPy::Module
+  def initialize
+    super
+    DSPy.configure { |c| c.lm = powerful_lm }
+    @predictor = DSPy::ChainOfThought.new(ComplexSignature)
+  end
+end
+```
+
+### Per-Request Configuration
+
+Override configuration for specific predictions:
+
+```ruby
+predictor = DSPy::Predict.new(MySignature)
+
+# Use default configuration
+result1 = predictor.forward(input: "data")
+
+# Override temperature for this request
+result2 = predictor.forward(
+  input: "data",
+  config: { temperature: 0.2 }  # More deterministic
+)
+```
+
+## Cost Optimization
+
+### Model Selection Strategy
+
+1. **Development**: Use cheaper, faster models (gpt-4o-mini, gemini-flash, gemini-1.5-flash)
+2. **Production Simple Tasks**: Continue with cheaper models if quality is sufficient
+3. **Production Complex Tasks**: Upgrade to more capable models (gpt-4o, gemini-1.5-pro, gemini-1.5-pro)
+4. **Local Development**: Use Ollama for privacy and zero API costs
+
+### Example Cost-Conscious Setup
+
+```ruby
+# Development environment
+if Rails.env.development?
+  DSPy.configure do |c|
+    c.lm = DSPy::LM.new('ollama/llama3.1')  # Free, local
+  end
+elsif Rails.env.test?
+  DSPy.configure do |c|
+    c.lm = DSPy::LM.new('openai/gpt-4o-mini',  # Cheap for testing
+      api_key: ENV['OPENAI_API_KEY'])
+  end
+else  # production
+  DSPy.configure do |c|
+    c.lm = DSPy::LM.new('google/gemini-1.5-pro',
+      api_key: ENV['GOOGLE_API_KEY'])
+  end
+end
+```
+
+## Provider-Specific Best Practices
+
+### OpenAI
+
+- Use `gpt-4o-mini` for development and simple tasks
+- Use `gpt-4o` for production complex tasks
+- Best vision support including URL loading
+- Excellent function calling capabilities
+
+
+
+### Google Gemini
+
+- Gemini 1.5 Pro for complex tasks, Flash for speed
+- Strong multimodal capabilities
+- Good balance of cost and performance
+- Requires base64 for images
+
+### Ollama
+
+- Best for privacy-sensitive applications
+- Zero API costs
+- Requires local hardware resources
+- Limited multimodal support depending on model
+- Good for development and testing
+
+## Troubleshooting
+
+### API Key Issues
+
+```ruby
+# Verify API key is set
+if ENV['OPENAI_API_KEY'].nil?
+  raise "OPENAI_API_KEY environment variable not set"
+end
+
+# Test connection
+begin
+  DSPy.configure { |c| c.lm = DSPy::LM.new('openai/gpt-4o-mini',
+    api_key: ENV['OPENAI_API_KEY']) }
+  predictor = DSPy::Predict.new(TestSignature)
+  predictor.forward(test: "data")
+  puts "✅ Connection successful"
+rescue => e
+  puts "❌ Connection failed: #{e.message}"
+end
+```
+
+### Rate Limiting
+
+Handle rate limits gracefully:
+
+```ruby
+def call_with_retry(predictor, input, max_retries: 3)
+  retries = 0
+  begin
+    predictor.forward(input)
+  rescue RateLimitError => e
+    retries += 1
+    if retries < max_retries
+      sleep(2 ** retries)  # Exponential backoff
+      retry
+    else
+      raise
+    end
+  end
+end
+```
+
+### Model Not Found
+
+Ensure the correct gem is installed:
+
+```bash
+# For OpenAI
+gem install dspy-openai
+
+# For Gemini
+gem install dspy-gemini
+```

package/.agent/skills/every-style-editor/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: every-style-editor
+description: This skill should be used when reviewing or editing copy to ensure adherence to Every's style guide. It provides a systematic line-by-line review process for grammar, punctuation, mechanics, and style guide compliance.
+---
+
+# Every Style Editor
+
+This skill provides a systematic approach to reviewing copy against Every's comprehensive style guide. It transforms Antigravity into a meticulous line editor and proofreader specializing in grammar, mechanics, and style guide compliance.
+
+## When to Use This Skill
+
+Use this skill when:
+- Reviewing articles, blog posts, newsletters, or any written content
+- Ensuring copy follows Every's specific style conventions
+- Providing feedback on grammar, punctuation, and mechanics
+- Flagging deviations from the Every style guide
+- Preparing clean copy for human editorial review
+
+## Skill Overview
+
+This skill enables performing a comprehensive review of written content in four phases:
+
+1. **Initial Assessment** - Understanding context and document type
+2. **Detailed Line Edit** - Checking every sentence for compliance
+3. **Mechanical Review** - Verifying formatting and consistency
+4. **Recommendations** - Providing actionable improvement suggestions
+
+## How to Use This Skill
+
+### Step 1: Initial Assessment
+
+Begin by reading the entire piece to understand:
+- Document type (article, knowledge base entry, social post, etc.)
+- Target audience
+- Overall tone and voice
+- Content context
+
+### Step 2: Detailed Line Edit
+
+Review each paragraph systematically, checking for:
+- Sentence structure and grammar correctness
+- Punctuation usage (commas, semicolons, em dashes, etc.)
+- Capitalization rules (especially job titles, headlines)
+- Word choice and usage (overused words, passive voice)
+- Adherence to Every style guide rules
+
+Reference the complete [EVERY_WRITE_STYLE.md](./references/EVERY_WRITE_STYLE.md) for specific rules when in doubt.
+
+### Step 3: Mechanical Review
+
+Verify:
+- Spacing and formatting consistency
+- Style choices applied uniformly throughout
+- Special elements (lists, quotes, citations)
+- Proper use of italics and formatting
+- Number formatting (numerals vs. spelled out)
+- Link formatting and descriptions
+
+### Step 4: Output Results
+
+Present findings using this structure:
+
+```
+DOCUMENT REVIEW SUMMARY
+=====================
+Document Type: [type]
+Word Count: [approximate]
+Overall Assessment: [brief overview]
+
+ERRORS FOUND: [total number]
+
+DETAILED CORRECTIONS
+===================
+
+[For each error found:]
+
+**Location**: [Paragraph #, Sentence #]
+**Issue Type**: [Grammar/Punctuation/Mechanics/Style Guide]
+**Original**: "[exact text with error]"
+**Correction**: "[corrected text]"
+**Rule Reference**: [Specific style guide rule violated]
+**Explanation**: [Brief explanation of why this is an error]
+
+---
+
+RECURRING ISSUES
+===============
+[List patterns of errors that appear multiple times]
+
+STYLE GUIDE COMPLIANCE CHECKLIST
+==============================
+✓ [Rule followed correctly]
+✗ [Rule violated - with count of violations]
+
+FINAL RECOMMENDATIONS
+===================
+[2-3 actionable suggestions for improving the draft]
+```
+
+## Style Guide Reference
+
+The complete Every style guide is included in [EVERY_WRITE_STYLE.md](./references/EVERY_WRITE_STYLE.md). Key areas to focus on:
+
+- **Quick Rules**: Title case for headlines, sentence case elsewhere
+- **Tone**: Active voice, avoid overused words (actually, very, just), be specific
+- **Numbers**: Spell out one through nine; use numerals for 10+
+- **Punctuation**: Oxford commas, em dashes without spaces, proper quotation mark usage
+- **Capitalization**: Lowercase job titles, company as singular (it), teams as plural (they)
+- **Emphasis**: Italics only (no bold for emphasis)
+- **Links**: 2-4 words, don't say "click here"
+
+## Key Principles
+
+- **Be specific**: Always quote the exact text with the error
+- **Reference rules**: Cite the specific style guide rule for each correction
+- **Maintain voice**: Preserve the author's voice while correcting errors
+- **Prioritize clarity**: Focus on changes that improve readability
+- **Be constructive**: Frame feedback to help writers improve
+- **Flag ambiguous cases**: When style guide doesn't address an issue, explain options and recommend the clearest choice
+
+## Common Areas to Focus On
+
+Based on Every's style guide, pay special attention to:
+
+- Punctuation (comma usage, semicolons, apostrophes, quotation marks)
+- Capitalization (proper nouns, titles, sentence starts)
+- Numbers (when to spell out vs. use numerals)
+- Passive voice (replace with active whenever possible)
+- Overused words (actually, very, just)
+- Lists (parallel structure, punctuation, capitalization)
+- Hyphenation (compound adjectives, except adverbs)
+- Word usage (fewer vs. less, they vs. them)
+- Company references (singular "it", teams as plural "they")
+- Job title capitalization