ultra-dex 3.7.0 → 4.0.0

package/README.md

@@ -10,21 +10,27 @@
 ### ✨ Major Features
 
 #### 🎯 VS Code Extension Sidebar
+
 Full IDE integration with 4 sidebar views:
+
 ```bash
 # Install from VSIX or marketplace
 # Access: Agent Explorer, Swarm Status, Context Preview, Quick Actions
 ```
 
 #### ⚡ Real-Time WebSocket Dashboard
+
 Instant updates, no polling:
+
 ```bash
 npx ultra-dex dashboard  # or: npx ultra-dex d
 # Live agent status, auto-reconnect, connection indicators
 ```
 
 #### 🧠 Session Persistence & Memory
+
 Never lose context:
+
 ```bash
 npx ultra-dex memory sessions     # List all sessions
 npx ultra-dex memory query "auth" # Search past decisions
@@ -59,7 +65,7 @@ npx ultra-dex setup --quick      # Fast defaults
 ```bash
 # Quick Aliases
 npx ultra-dex s "task"      # swarm
-npx ultra-dex d             # dashboard  
+npx ultra-dex d             # dashboard
 npx ultra-dex v             # verify
 npx ultra-dex b             # build
 npx ultra-dex g "idea"      # generate
@@ -95,6 +101,7 @@ npx ultra-dex watch --sync  # Auto-runs sync --brain
 ### 📚 Example Repositories
 
 Complete starter templates:
+
 - **E-commerce** (Next.js + Stripe + PostgreSQL)
 - **SaaS Analytics** (ClickHouse + Redis + Real-time)
 - **Real-time Chat** (Socket.io + WebSocket)
@@ -139,6 +146,7 @@ npx ultra-dex dashboard
 ## 📖 Core Commands
 
 ### Project Management
+
 ```bash
 npx ultra-dex init                    # Initialize new project
 npx ultra-dex generate "idea"         # AI-generated implementation plan
@@ -149,6 +157,7 @@ npx ultra-dex verify                  # Verify implementation completeness
 ```
 
 ### Development
+
 ```bash
 npx ultra-dex build                   # Build project
 npx ultra-dex validate                # Validate against standards
@@ -158,6 +167,7 @@ npx ultra-dex exec "code"             # Execute in sandbox
 ```
 
 ### Monitoring & Control
+
 ```bash
 npx ultra-dex dashboard               # Open God Mode dashboard
 npx ultra-dex serve                   # Start MCP server
@@ -168,6 +178,7 @@ npx ultra-dex metrics                 # Show metrics
 ```
 
 ### Advanced
+
 ```bash
 npx ultra-dex sync --brain            # Auto-sync CONTEXT.md
 npx ultra-dex cloud                   # Cloud collaboration
@@ -183,7 +194,9 @@ npx ultra-dex history                 # Command history
 ## 🎯 Key Features
 
 ### 1. 21-Step Verification Framework
+
 Every task follows production-ready standards:
+
 1. Understand requirement
 2. List assumptions
 3. Analyze logic flow
@@ -207,7 +220,9 @@ Every task follows production-ready standards:
 21. Final verify
 
 ### 2. 34 Cursor Rules
+
 Production-grade coding standards:
+
 - Core principles, TypeScript, React patterns
 - Authentication, database, testing
 - Security, performance, accessibility
@@ -216,7 +231,9 @@ Production-grade coding standards:
 [View Rules](./cli/assets/cursor-rules/)
 
 ### 3. Agent Ecosystem
+
 **17 Specialized Agents:**
+
 - **Leadership:** @cto, @planner, @research
 - **Development:** @backend, @frontend, @database
 - **Security:** @auth, @security
@@ -226,7 +243,9 @@ Production-grade coding standards:
 - **Meta:** @orchestrator
 
 ### 4. Template System
+
 **3 Template Variants:**
+
 - **LITE** (12 sections) - Quick MVPs
 - **FULL** (34 sections) - Complete projects
 - **ENTERPRISE** (50+ sections) - Large-scale
@@ -236,16 +255,19 @@ Production-grade coding standards:
 ## 🛠️ Installation & Setup
 
 ### Prerequisites
-- Node.js 18+ 
+
+- Node.js 18+
 - Git
 - (Optional) Docker for sandbox execution
 
 ### Install
+
 ```bash
 npm install -g ultra-dex
 ```
 
 ### First-Time Setup
+
 ```bash
 npx ultra-dex setup
 # Interactive wizard configures:
@@ -256,12 +278,13 @@ npx ultra-dex setup
 ```
 
 ### Shell Completions
+
 ```bash
 # Bash
 source <(ultra-dex completions bash)
 # Add to ~/.bashrc for persistence
 
-# Zsh  
+# Zsh
 source <(ultra-dex completions zsh)
 # Add to ~/.zshrc for persistence
 ```
@@ -282,6 +305,7 @@ source <(ultra-dex completions zsh)
 ## 🎓 Learning Path
 
 ### Beginner (Day 1)
+
 ```bash
 npx ultra-dex init                    # Create project
 npx ultra-dex generate "Todo app"     # Generate plan
@@ -289,6 +313,7 @@ npx ultra-dex align                   # Check alignment
 ```
 
 ### Intermediate (Week 1)
+
 ```bash
 npx ultra-dex swarm "Feature X"       # Run agents
 npx ultra-dex dashboard               # Monitor progress
@@ -296,6 +321,7 @@ npx ultra-dex verify                  # Verify completion
 ```
 
 ### Advanced (Month 1)
+
 ```bash
 npx ultra-dex voice "Complex system"  # Voice input
 npx ultra-dex sync --brain            # Auto-sync
@@ -353,24 +379,28 @@ my-project/
 ### Common Issues
 
 **Command not found:**
+
 ```bash
 npm install -g ultra-dex
 # Or use: npx ultra-dex
 ```
 
 **API key errors:**
+
 ```bash
 npx ultra-dex setup              # Configure keys
 # Or set env var: export ANTHROPIC_API_KEY=...
 ```
 
 **Port already in use:**
+
 ```bash
 npx ultra-dex serve --port 3003  # Use different port
 lsof -ti:3001 | xargs kill -9   # Kill process
 ```
 
 **Need help:**
+
 ```bash
 npx ultra-dex doctor             # Diagnostics
 npx ultra-dex <command> --help   # Command help
@@ -381,6 +411,7 @@ npx ultra-dex <command> --help   # Command help
 ## 🌟 Why Ultra-Dex?
 
 ### Before Ultra-Dex
+
 - ❌ AI agents forget context between sessions
 - ❌ No standard for AI-assisted development
 - ❌ Manual coordination between tools
@@ -388,6 +419,7 @@ npx ultra-dex <command> --help   # Command help
 - ❌ No verification framework
 
 ### With Ultra-Dex
+
 - ✅ Persistent memory across sessions
 - ✅ 21-step production-ready framework
 - ✅ Coordinated agent swarms
@@ -399,11 +431,13 @@ npx ultra-dex <command> --help   # Command help
 ## 📈 Roadmap
 
 ### v3.6.0 (March 2026)
+
 - Deep Graph RAG (FalkorDB/Neo4j)
 - Enterprise Auth (SSO/SAML)
 - LangGraph Integration
 
 ### v4.0.0 (Q2 2026)
+
 - AI Agent Protocol SDK
 - JetBrains/Neovim plugins
 - Agent Marketplace
@@ -415,6 +449,7 @@ npx ultra-dex <command> --help   # Command help
 We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md)
 
 ### Ways to Contribute
+
 - Report bugs
 - Suggest features
 - Add cursor rules
@@ -437,7 +472,7 @@ MIT License - see [LICENSE](./LICENSE)
 
 ---
 
-**Ultra-Dex v3.5.0** - *The most complete AI orchestration platform for developers.*
+**Ultra-Dex v3.5.0** - _The most complete AI orchestration platform for developers._
 
 🚀 **Ready for production. Ready for you.** 🚀
 

package/assets/agents/0-orchestration/orchestrator.md

@@ -26,6 +26,7 @@ You are the **Ultra-Dex Orchestrator**, a meta-agent that coordinates all 16 spe
 For any feature, follow this sequence:
 
 ### Phase 1: Planning (Leadership Tier)
+
 ```
 @Planner → Break down into atomic tasks (4-9 hours each)
 @Research → Evaluate technology options if needed
@@ -33,6 +34,7 @@ For any feature, follow this sequence:
 ```
 
 ### Phase 2: Implementation (Development Tier)
+
 ```
 @Database → Schema design and migrations
 @Backend → API endpoints and business logic
@@ -40,12 +42,14 @@ For any feature, follow this sequence:
 ```
 
 ### Phase 3: Security (Security Tier)
+
 ```
 @Auth → Authentication and authorization
 @Security → Security audit and vulnerability check
 ```
 
 ### Phase 4: Quality (Quality Tier)
+
 ```
 @Testing → Write and run tests
 @Reviewer → Code review and approval
@@ -53,11 +57,13 @@ For any feature, follow this sequence:
 ```
 
 ### Phase 5: Deployment (DevOps Tier)
+
 ```
 @DevOps → Deploy to staging → production
 ```
 
 ### Phase 6: Optimization (Specialist Tier - if needed)
+
 ```
 @Performance → Optimize slow paths
 @Refactoring → Clean up code debt
@@ -73,31 +79,36 @@ Use this prompt to start any complete feature:
 ## Feature: [FEATURE NAME]
 
 ### 1. Requirements
+
 - [What the feature does]
 - [Who uses it]
 - [Success criteria]
 
 ### 2. Agent Workflow
-| Phase | Agent | Task | Status |
-|-------|-------|------|--------|
-| Planning | @Planner | Break down tasks | [ ] |
-| Planning | @CTO | Architecture approval | [ ] |
-| Implementation | @Database | Schema design | [ ] |
-| Implementation | @Backend | API endpoints | [ ] |
-| Implementation | @Frontend | UI components | [ ] |
-| Security | @Auth | Auth implementation | [ ] |
-| Security | @Security | Security audit | [ ] |
-| Quality | @Testing | Write tests | [ ] |
-| Quality | @Reviewer | Code review | [ ] |
-| Deployment | @DevOps | Deploy to production | [ ] |
+
+| Phase          | Agent     | Task                  | Status |
+| -------------- | --------- | --------------------- | ------ |
+| Planning       | @Planner  | Break down tasks      | [ ]    |
+| Planning       | @CTO      | Architecture approval | [ ]    |
+| Implementation | @Database | Schema design         | [ ]    |
+| Implementation | @Backend  | API endpoints         | [ ]    |
+| Implementation | @Frontend | UI components         | [ ]    |
+| Security       | @Auth     | Auth implementation   | [ ]    |
+| Security       | @Security | Security audit        | [ ]    |
+| Quality        | @Testing  | Write tests           | [ ]    |
+| Quality        | @Reviewer | Code review           | [ ]    |
+| Deployment     | @DevOps   | Deploy to production  | [ ]    |
 
 ### 3. Current Phase
+
 [PHASE NAME] - [AGENT] working on [TASK]
 
 ### 4. Handoff Context
+
 [What the next agent needs to know]
 
 ### 5. Blockers
+
 [Any issues preventing progress]
 ```
 
@@ -109,37 +120,43 @@ Use this prompt to start any complete feature:
 ## Feature: User Authentication with Email + OAuth
 
 ### 1. Requirements
+
 - Email/password login
 - Google OAuth
 - Protected routes
 - Session management
 
 ### 2. Agent Workflow
-| Phase | Agent | Task | Status |
-|-------|-------|------|--------|
-| Planning | @Planner | Break into 6 tasks | [x] |
-| Planning | @CTO | Approve Clerk vs NextAuth | [x] |
-| Implementation | @Database | User schema + sessions | [x] |
-| Implementation | @Backend | Auth API routes | [x] |
-| Implementation | @Frontend | Login/signup pages | [x] |
-| Security | @Auth | Middleware + RLS | [x] |
-| Security | @Security | Security audit | [x] |
-| Quality | @Testing | Auth tests | [ ] |
-| Quality | @Reviewer | Code review | [ ] |
-| Deployment | @DevOps | Deploy with env vars | [ ] |
+
+| Phase          | Agent     | Task                      | Status |
+| -------------- | --------- | ------------------------- | ------ |
+| Planning       | @Planner  | Break into 6 tasks        | [x]    |
+| Planning       | @CTO      | Approve Clerk vs NextAuth | [x]    |
+| Implementation | @Database | User schema + sessions    | [x]    |
+| Implementation | @Backend  | Auth API routes           | [x]    |
+| Implementation | @Frontend | Login/signup pages        | [x]    |
+| Security       | @Auth     | Middleware + RLS          | [x]    |
+| Security       | @Security | Security audit            | [x]    |
+| Quality        | @Testing  | Auth tests                | [ ]    |
+| Quality        | @Reviewer | Code review               | [ ]    |
+| Deployment     | @DevOps   | Deploy with env vars      | [ ]    |
 
 ### 3. Current Phase
+
 Quality - @Testing working on auth tests
 
 ### 4. Handoff Context
+
 Auth implementation complete with:
+
 - Clerk integration (auth.ts)
 - Protected middleware (middleware.ts)
 - Login page (app/login/page.tsx)
 - User dashboard (app/dashboard/page.tsx)
-Test coverage needed for: login, logout, OAuth, protected routes
+  Test coverage needed for: login, logout, OAuth, protected routes
 
 ### 5. Blockers
+
 None
 ```
 
@@ -148,6 +165,7 @@ None
 ## Quick Orchestration Commands
 
 **Complete Feature:**
+
 ```
 Orchestrate: [Feature Name]
 - Start from planning
@@ -156,6 +174,7 @@ Orchestrate: [Feature Name]
 ```
 
 **Partial Feature (skip planning):**
+
 ```
 Orchestrate: [Feature Name]
 - Architecture: [Already decided]
@@ -164,6 +183,7 @@ Orchestrate: [Feature Name]
 ```
 
 **Hotfix (minimal workflow):**
+
 ```
 Orchestrate Hotfix: [Bug Description]
 - @Debugger → @Testing → @DevOps
@@ -183,24 +203,29 @@ When transitioning between agents:
 5. **Link** to relevant documentation
 
 Example handoff:
+
 ```markdown
 ## Handoff: @Database → @Backend
 
 ### Completed
+
 - User schema with multi-tenancy (orgId)
 - Session table for auth
 - Migration: 20240115_add_users.sql
 
 ### Files Changed
+
 - prisma/schema.prisma (User, Session, Organization models)
 - prisma/migrations/20240115_add_users/
 
 ### For @Backend
+
 - Create CRUD endpoints for User
 - Implement org-scoped queries (WHERE orgId = ?)
 - Auth middleware should set orgId from session
 
 ### Constraints
+
 - All queries must be org-scoped (multi-tenant)
 - Use Prisma client, not raw SQL
 ```
@@ -215,6 +240,7 @@ Example handoff:
 - **Single component**: Use the specific agent directly
 
 **Use Orchestrator when:**
+
 - Building a complete new feature
 - Feature spans multiple tiers (DB + API + UI)
 - Security-sensitive features (auth, payments)
@@ -222,4 +248,4 @@ Example handoff:
 
 ---
 
-*Ultra-Dex v1.7.0 - Meta Orchestration for Production Features*
+_Ultra-Dex v1.7.0 - Meta Orchestration for Production Features_

package/assets/agents/00-AGENT_INDEX.md

@@ -6,71 +6,77 @@ Quick reference for all 16 production agents organized by tier.
 
 ## 0. Meta Orchestration
 
-| Agent | Role | When to Use | File |
-|-------|------|-------------|------|
+| Agent             | Role                                        | When to Use                                | File                                                 |
+| ----------------- | ------------------------------------------- | ------------------------------------------ | ---------------------------------------------------- |
 | **@Orchestrator** | Coordinate all agents for complete features | Building features that span multiple tiers | [orchestrator.md](./0-orchestration/orchestrator.md) |
 
 ---
 
 ## 1. Leadership Tier
+
 Strategic planning and technology decisions.
 
-| Agent | Role | When to Use | File |
-|-------|------|-------------|------|
-| **@CTO** | Architecture & tech stack decisions | Major features, system design, stack choices | [cto.md](./1-leadership/cto.md) |
-| **@Planner** | Task breakdown & sprint planning | Starting any feature, breaking down work | [planner.md](./1-leadership/planner.md) |
-| **@Research** | Technology evaluation & comparison | Choosing frameworks, libraries, approaches | [research.md](./1-leadership/research.md) |
+| Agent         | Role                                | When to Use                                  | File                                      |
+| ------------- | ----------------------------------- | -------------------------------------------- | ----------------------------------------- |
+| **@CTO**      | Architecture & tech stack decisions | Major features, system design, stack choices | [cto.md](./1-leadership/cto.md)           |
+| **@Planner**  | Task breakdown & sprint planning    | Starting any feature, breaking down work     | [planner.md](./1-leadership/planner.md)   |
+| **@Research** | Technology evaluation & comparison  | Choosing frameworks, libraries, approaches   | [research.md](./1-leadership/research.md) |
 
 ---
 
 ## 2. Development Tier
+
 Core implementation of features.
 
-| Agent | Role | When to Use | File |
-|-------|------|-------------|------|
-| **@Backend** | API & server implementation | Building endpoints, business logic | [backend.md](./2-development/backend.md) |
-| **@Database** | Schema design & query optimization | Database changes, migrations | [database.md](./2-development/database.md) |
-| **@Frontend** | UI & component implementation | Building pages, components, user flows | [frontend.md](./2-development/frontend.md) |
+| Agent         | Role                               | When to Use                            | File                                       |
+| ------------- | ---------------------------------- | -------------------------------------- | ------------------------------------------ |
+| **@Backend**  | API & server implementation        | Building endpoints, business logic     | [backend.md](./2-development/backend.md)   |
+| **@Database** | Schema design & query optimization | Database changes, migrations           | [database.md](./2-development/database.md) |
+| **@Frontend** | UI & component implementation      | Building pages, components, user flows | [frontend.md](./2-development/frontend.md) |
 
 ---
 
 ## 3. Security Tier
+
 Authentication, authorization, and security audits.
 
-| Agent | Role | When to Use | File |
-|-------|------|-------------|------|
-| **@Auth** | Authentication & authorization | Login, permissions, user management | [auth.md](./3-security/auth.md) |
+| Agent         | Role                                  | When to Use                         | File                                    |
+| ------------- | ------------------------------------- | ----------------------------------- | --------------------------------------- |
+| **@Auth**     | Authentication & authorization        | Login, permissions, user management | [auth.md](./3-security/auth.md)         |
 | **@Security** | Security audits & vulnerability fixes | Before deployment, security reviews | [security.md](./3-security/security.md) |
 
 ---
 
 ## 4. DevOps Tier
+
 Deployment and infrastructure management.
 
-| Agent | Role | When to Use | File |
-|-------|------|-------------|------|
+| Agent       | Role                        | When to Use                   | File                              |
+| ----------- | --------------------------- | ----------------------------- | --------------------------------- |
 | **@DevOps** | Deployment & infrastructure | Shipping to production, CI/CD | [devops.md](./4-devops/devops.md) |
 
 ---
 
 ## 5. Quality Tier
+
 Testing, debugging, and code review.
 
-| Agent | Role | When to Use | File |
-|-------|------|-------------|------|
-| **@Debugger** | Bug investigation & fixes | When something breaks, troubleshooting | [debugger.md](./5-quality/debugger.md) |
+| Agent              | Role                                 | When to Use                              | File                                             |
+| ------------------ | ------------------------------------ | ---------------------------------------- | ------------------------------------------------ |
+| **@Debugger**      | Bug investigation & fixes            | When something breaks, troubleshooting   | [debugger.md](./5-quality/debugger.md)           |
 | **@Documentation** | Technical writing & docs maintenance | Updating docs, API documentation, guides | [documentation.md](./5-quality/documentation.md) |
-| **@Reviewer** | Code review & quality checks | Before merging, final approval | [reviewer.md](./5-quality/reviewer.md) |
-| **@Testing** | QA & test automation | Writing tests, ensuring coverage | [testing.md](./5-quality/testing.md) |
+| **@Reviewer**      | Code review & quality checks         | Before merging, final approval           | [reviewer.md](./5-quality/reviewer.md)           |
+| **@Testing**       | QA & test automation                 | Writing tests, ensuring coverage         | [testing.md](./5-quality/testing.md)             |
 
 ---
 
 ## 6. Specialist Tier
+
 Advanced optimization and code improvement.
 
-| Agent | Role | When to Use | File |
-|-------|------|-------------|------|
-| **@Performance** | Performance optimization | Slow pages/APIs, optimization needed | [performance.md](./6-specialist/performance.md) |
+| Agent            | Role                           | When to Use                           | File                                            |
+| ---------------- | ------------------------------ | ------------------------------------- | ----------------------------------------------- |
+| **@Performance** | Performance optimization       | Slow pages/APIs, optimization needed  | [performance.md](./6-specialist/performance.md) |
 | **@Refactoring** | Code quality & design patterns | Cleaning up code, reducing complexity | [refactoring.md](./6-specialist/refactoring.md) |
 
 ---
@@ -114,25 +120,29 @@ Advanced optimization and code improvement.
 For complete multi-agent workflows and coordination patterns, see:
 
 **Production Guides:**
+
 - [Project Orchestration Guide](../guides/PROJECT-ORCHESTRATION.md) - Step-by-step multi-agent workflows
 - [Advanced Workflows](../guides/ADVANCED-WORKFLOWS.md) - Stripe, emails, migrations, real-time features
 - [Multi-Tool Workflow](../guides/MULTI-TOOL-WORKFLOW.md) - Coordinate Claude + Cursor + Copilot + ChatGPT
 - [Custom Agents Guide](../guides/CUSTOM-AGENTS-GUIDE.md) - Create domain-specific agents for your SaaS
 
 **Orchestration Examples:**
+
 - [Orchestration Examples](../Orchestration/EXAMPLES.md) - Real-world multi-agent workflow examples
 - [Orchestration README](../Orchestration/README.md) - Orchestration pattern overview
 
 **Templates:**
+
 - [Phase Tracker Template](../templates/PHASE-TRACKER-TEMPLATE.md) - Track progress by phase
 - [Order Tracker Template](../templates/ORDER-TRACKER-TEMPLATE.md) - Step-by-step execution with copy-paste prompts
 - [Master Plan Template](../templates/MASTER-PLAN-TEMPLATE.md) - Single-file project overview
 
 **Decision Frameworks:**
+
 - [Database Selection Guide](../guides/DATABASE-DECISION-FRAMEWORK.md) - PostgreSQL vs MongoDB vs MySQL
 - [Architecture Patterns](../guides/ARCHITECTURE-PATTERNS.md) - Monolith to Microservices
 - [AI Model Selection](../guides/AI-MODEL-SELECTION.md) - Choose the right AI for each task
 
 ---
 
-*Ultra-Dex v1.7.1 - Professional AI Orchestration Meta Layer*
+_Ultra-Dex v1.7.1 - Professional AI Orchestration Meta Layer_