admin/SuperCharged-Claude-Code-Upgrade
1
2
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Add unified agent integration with Prometheus, Every Code, and Dexto

Browse Source 
This commit adds comprehensive integration of three major AI agent platforms:

## MCP Servers (3)
- Prometheus MCP: Knowledge graph code reasoning with AST analysis
- Every Code MCP: Fast terminal-based coding agent with Auto Drive
- Dexto MCP: Agent harness with orchestration and session management

## Claude Code Skills (6)
- /agent-plan: Generate implementation plans
- /agent-fix-bug: Fix bugs end-to-end
- /agent-solve: Solve complex problems
- /agent-review: Review code quality
- /agent-context: Get code context
- /agent-orchestrate: Orchestrate workflows

## Ralph Auto-Integration
- Pattern-based auto-trigger for all three platforms
- Intelligent backend selection
- Multi-platform coordination
- Configuration in ralph/ralph.yml

## Documentation
- Complete integration guides
- Ralph auto-integration documentation
- Setup scripts
- Usage examples

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
uroma
2026-01-27 20:23:14 +00:00
Unverified
parent 0465526bf0
commit 3b128ba3bd
21 changed files with 4172 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

290
skills/unified-agents/README.md Normal file
View File

@@ -0,0 +1,290 @@
# Unified Agent Integration for Claude Code CLI
Complete integration of **Prometheus**, **Every Code**, and **Dexto** - three powerful AI agent platforms - into Claude Code CLI.
## Overview
This integration brings together the strengths of three major AI agent platforms:
| Platform | Strength | Best For |
|----------|----------|----------|
| **Prometheus** | Deep code understanding with knowledge graphs | Bug fixing, semantic search, regression testing |
| **Every Code** | Fast execution with Auto Drive | Rapid development, browser automation, multi-agent tasks |
| **Dexto** | Agent orchestration and session management | Complex workflows, custom agents, tool composition |
## Quick Start
### Automated Setup (Recommended)
```bash
# Run the setup script
bash /tmp/unified-agents-setup.sh
# Or download and run
wget https://raw.githubusercontent.com/your-org/unified-agents/main/setup.sh
bash setup.sh
```
### Manual Setup
See [COMPLETE-INTEGRATION.md](COMPLETE-INTEGRATION.md) for detailed manual setup instructions.
## Available Skills
### Core Skills
| Skill | Description | Primary Backend |
|-------|-------------|-----------------|
| `/agent-plan` | Generate implementation plans | Every Code |
| `/agent-fix-bug` | Fix bugs end-to-end | Prometheus |
| `/agent-solve` | Solve complex problems | Every Code |
| `/agent-review` | Review code quality | Every Code |
| `/agent-context` | Get code context | Prometheus |
| `/agent-orchestrate` | Orchestrate workflows | Dexto |
## Ralph Auto-Integration
The unified agents are **automatically triggered** when using `/ralph`. See [RALPH-AUTO-INTEGRATION.md](RALPH-AUTO-INTEGRATION.md) for details.
### Quick Examples with Ralph
```bash
# Auto-triggers Prometheus for bug fixing
/ralph "fix the authentication bug"
# Auto-triggers Every Code for planning
/ralph "plan and implement user notifications"
# Auto-triggers Dexto for orchestration
/ralph "orchestrate a complete CI/CD pipeline"
# Multi-platform: All agents activate
/ralph "audit, fix, and test all security issues"
```
**Pattern-Based Auto-Trigger:**
- **Prometheus**: "fix bug", "debug", "test failure", "regression"
- **Every Code**: "plan feature", "solve problem", "review code"
- **Dexto**: "orchestrate workflow", "coordinate agents", "multi-step"
## Usage Examples
### Bug Fixing
```
You: /agent-fix-bug "Users can't delete their accounts"
Claude: I'll use Prometheus to fix this bug.
✓ Issue classified as: bug
✓ Bug reproduced in Docker container
✓ Retrieved context from 12 related files
✓ Generated patch for UserService.deleteAccount
✓ Applied patch with git
✓ All 15 tests passing
✓ Regression tests verified
The bug has been fixed. The issue was a missing null check in the deleteAccount method.
```
### Feature Planning
```
You: /agent-plan "Add real-time notifications with WebSocket"
Claude: I'll generate a plan using Every Code with context from Prometheus.
## Implementation Plan
### Phase 1: Backend Setup (2 hours)
- Install WebSocket dependencies
- Create WebSocket server
- Implement connection management
### Phase 2: Frontend Integration (3 hours)
- Create WebSocket client service
- Add notification components
- Implement reconnection logic
### Phase 3: Testing (2 hours)
- Unit tests for WebSocket handlers
- Integration tests
- Load testing
Total estimated time: 7 hours
Would you like me to implement this plan with /agent-implement?
```
### Multi-Agent Orchestration
```
You: /agent-orchestrate "Audit, fix, and test all authentication issues"
Claude: I'll orchestrate a multi-agent workflow using Dexto.
## Workflow: Authentication Audit & Fix
### Agent 1: Prometheus - Code Audit
Found 3 authentication issues:
1. Missing rate limiting on login
2. Weak password requirements
3. No session timeout
### Agent 2: Every Code - Implement Fixes
Applied fixes for all 3 issues
Running tests...
### Agent 3: Every Code - Auto Review
Quality checks passed
No regressions detected
## Results
✓ 3 issues fixed
✓ 47 tests passing
✓ Code review complete
✓ Documentation updated
```
## Backend Selection
The integration automatically selects the best backend for each task:
```
┌─────────────────────┬─────────────┬─────────────┬─────────────┐
│ Task │ Prometheus │ Every Code │ Dexto │
├─────────────────────┼─────────────┼─────────────┼─────────────┤
│ Bug fixing │ ✅ Primary │ ✅ Review │ ✅ Orchest. │
│ Code planning │ ✅ Context │ ✅ Primary │ ✅ Custom │
│ Problem solving │ ✅ Analysis │ ✅ Primary │ ✅ Workflow │
│ Code review │ ✅ AST │ ✅ Primary │ │
│ Context retrieval │ ✅ Primary │ │ ✅ Memory │
│ Orchestration │ │ ✅ Auto Dr. │ ✅ Primary │
│ Semantic search │ ✅ Primary │ ✅ Grep │ │
│ Browser automation │ │ ✅ Primary │ ✅ Tools │
└─────────────────────┴─────────────┴─────────────┴─────────────┘
```
## MCP Tools
### Prometheus Tools
- `prometheus_find_file` - Find files by basename
- `prometheus_search_code` - Search code using AST
- `prometheus_search_ast` - Search by node type
- `prometheus_classify_issue` - Classify GitHub issues
- `prometheus_fix_bug` - End-to-end bug fixing
- `prometheus_run_tests` - Run tests in Docker
### Every Code Tools
- `everycode_auto_drive` - Orchestrate multi-agent tasks
- `everycode_plan` - Generate implementation plans
- `everycode_solve` - Coordinate multiple agents
- `everycode_auto_review` - Background code review
- `everycode_browser_*` - Browser automation
### Dexto Tools
- `dexto_create_agent` - Create custom agents
- `dexto_run_agent` - Run configured agents
- `dexto_orchestrate` - Orchestrate workflows
- `dexto_mcp_*` - MCP client operations
- `dexto_memory_*` - Memory management
## Architecture
```
┌─────────────────────────────────────────────────────────────┐
│ Claude Code CLI │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ Unified Agent Skills │ │
│ │ /agent-plan | /agent-fix-bug | /agent-solve │ │
│ └────────────────────────┬─────────────────────────────┘ │
│ │ MCP Client │
└───────────────────────────┼─────────────────────────────────┘
│
┌───────────────────────────┼─────────────────────────────────┐
│ Unified Agent MCP Server │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ Intelligent Router │ │
│ │ Routes to best backend per task │ │
│ └────┬──────────────┬──────────────┬────────────────────┘ │
│ │ │ │ │
│ ┌────▼────┐ ┌────▼────┐ ┌────▼────┐ │
│ │Prometheus│ │Every Code│ │ Dexto │ │
│ │ Knowledge│ │ Auto Drive│ │ Harness │ │
│ │ Graph │ │ Browser │ │ MCP │ │
│ │ AST │ │ Multi │ │ Session │ │
│ │ LangGraph│ │ Agent │ │ Tools │ │
│ └─────────┘ └───────────┘ └─────────┘ │
└─────────────────────────────────────────────────────────────┘
```
## Documentation
- [COMPLETE-INTEGRATION.md](COMPLETE-INTEGRATION.md) - Full integration guide
- [UNIFIED-INTEGRATION.md](UNIFIED-INTEGRATION.md) - Prometheus + Every Code integration
- [INTEGRATION-DESIGN.md](prometheus/INTEGRATION-DESIGN.md) - Prometheus design
## Requirements
- Python 3.11+
- Node.js 20+
- Rust + Cargo
- Docker + Docker Compose (for Prometheus)
- Neo4j (for Prometheus knowledge graph)
- API keys (OpenAI, Anthropic, or Gemini)
## Installation Paths
| Component | Location |
|-----------|----------|
| Install directory | `~/UnifiedAgents/` |
| Prometheus | `~/UnifiedAgents/Prometheus/` |
| Every Code | `~/UnifiedAgents/EveryCode/` |
| Dexto | `~/UnifiedAgents/Dexto/` |
| Claude Code skills | `~/.config/claude-code/skills/agents/` |
## Troubleshooting
### Prometheus: "Neo4j connection failed"
```bash
cd ~/UnifiedAgents/Prometheus
docker-compose up -d neo4j
```
### Every Code: "Not authenticated"
```bash
code
# Follow authentication prompts
```
### Dexto: "Config file not found"
```bash
cp ~/UnifiedAgents/Dexto/config.example.yaml ~/UnifiedAgents/Dexto/config.yaml
# Edit config.yaml with your settings
```
### MCP servers not found
```bash
# Verify Claude Code config
cat ~/.config/claude-code/config.json
# Restart Claude Code
```
## Contributing
Contributions welcome! Please see [DEVELOPMENT.md](DEVELOPMENT.md) for guidelines.
## License
Apache-2.0
## Acknowledgments
- [Prometheus](https://github.com/EuniAI/Prometheus) - Knowledge graph code reasoning
- [Every Code](https://github.com/just-every/code) - Fast coding agent
- [Dexto](https://github.com/truffle-ai/dexto) - Agent harness
- [Claude Code](https://claude.com/claude-code) - AI CLI