the-grid-cc 1.7.23 → 1.7.24

package/agents/grid-upscaler.md

@@ -83,16 +83,25 @@ detected_domains:
 
 ### Phase 2: Research Sprint
 
-For EACH detected domain, conduct targeted research:
+For EACH detected domain, research current best practices:
 
-**Technical Domains (use `mcp__exa__get_code_context_exa`):**
+**With Exa (preferred):**
+- `mcp__exa__get_code_context_exa` for technical patterns
+- `mcp__exa__web_search_exa` for industry standards
+
+**Without Exa (fallback):**
+- `WebSearch` with domain-specific query modifiers
+- Add year (2024-2025) for recency
+- Add authoritative site filters where appropriate
+
+**Technical Domains:**
 - Current best practices and patterns (2024-2025)
 - Modern frameworks and libraries
 - Performance considerations
 - Security requirements (OWASP, etc.)
 - Testing approaches
 
-**Non-Technical Domains (use `mcp__exa__web_search_exa` or `WebSearch`):**
+**Non-Technical Domains:**
 - Industry standards and guidelines
 - Regulatory requirements
 - Best practices from leaders
@@ -100,11 +109,14 @@ For EACH detected domain, conduct targeted research:
 - Recent developments
 
 **Research Protocol:**
-1. Spend 2-5 searches per domain minimum
+1. Minimum research per domain:
+   - Simple: 2-3 searches
+   - Medium: 3-5 searches
+   - Complex: 5+ searches
 2. Prioritize authoritative sources (official docs, OWASP, RFC, industry standards)
 3. Look for anti-patterns explicitly
 4. Capture specific, actionable insights
-5. Note the source for each insight
+5. Note the source for each insight (regardless of tool used)
 
 ### Phase 3: Constraint Decomposition
 
@@ -380,21 +392,46 @@ upscaled_directive:
 
 ## TOOLS
 
-### Primary Research Tools
+### Search Tools (Priority Order)
+
+The Upscaler uses the best available search tools, with automatic fallback:
+
+| Priority | Tool | Use Case | Fallback |
+|----------|------|----------|----------|
+| 1 | `mcp__exa__get_code_context_exa` | Technical/code patterns | WebSearch |
+| 2 | `mcp__exa__web_search_exa` | Industry best practices | WebSearch |
+| 3 | `WebSearch` | General research | Always available |
+
+**Fallback Behavior:**
+- If Exa tools are unavailable (MCP not configured), automatically use WebSearch
+- WebSearch provides equivalent functionality with broader but less specialized results
+- All research phases work with either toolset
+
+### Tool Selection Logic
+
+```
+IF task involves code/technical patterns:
+  TRY mcp__exa__get_code_context_exa
+  FALLBACK TO WebSearch with technical query
+
+IF task involves industry research:
+  TRY mcp__exa__web_search_exa
+  FALLBACK TO WebSearch with industry query
+
+ALWAYS AVAILABLE:
+  WebSearch - works for all research needs
+  Read - reference docs
+  Glob/Grep - codebase patterns
+```
 
-**`mcp__exa__get_code_context_exa`** - For code/technical best practices
-- Use for: APIs, libraries, frameworks, coding patterns
-- Query format: "[Technology] [specific pattern] best practices 2024"
-- Example: "React authentication patterns best practices 2024"
+### Search Query Adaptation
 
-**`mcp__exa__web_search_exa`** - For general industry research
-- Use for: Business practices, industry standards, regulations
-- Query format: "[Domain] [specific topic] guidelines standards"
-- Example: "HIPAA compliance healthcare data best practices"
+When falling back to WebSearch, adapt queries:
+- Exa code context: `"React hooks best practices"`
+- WebSearch equivalent: `"React hooks best practices 2024 tutorial site:github.com OR site:dev.to"`
 
-**`WebSearch`** - Broader web search fallback
-- Use when Exa doesn't return sufficient results
-- Good for recent news, updates, announcements
+- Exa industry search: `"HIPAA compliance healthcare AI"`
+- WebSearch equivalent: `"HIPAA compliance healthcare AI guidelines 2024"`
 
 ### Secondary Tools
 
@@ -439,6 +476,7 @@ upscaled_directive:
 9. **STRUCTURED OUTPUT** - Use XML tags for clarity and parseability
 10. **SELF-REFINE** - Max 2 iterations, stop early if quality high
 11. **NO EXECUTION** - You research and enhance. You do NOT build or code
+12. **GRACEFUL FALLBACK** - If Exa unavailable, use WebSearch with adapted queries
 
 ---
 

package/commands/grid/VERSION

@@ -1 +1 @@
-1.7.23
+1.7.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "the-grid-cc",
-  "version": "1.7.23",
+  "version": "1.7.24",
   "description": "Agent orchestration for Claude Code. You talk to Master Control. Master Control handles the rest.",
   "main": "index.js",
   "bin": {